Hotmart Course Backup

A standalone Python tool to backup your own purchased courses from Hotmart for personal offline viewing.

⚖️ Legal Disclaimer

This tool is ONLY for backing up content you legally own or have purchased.

• ✅ Legal Use: Downloading courses you paid for and own for personal backup
• ❌ Illegal Use: Downloading courses you don't own, sharing downloaded content, piracy

By using this tool, you agree:

1. You will ONLY download content you have legally purchased
2. You will NOT distribute, share, or republish downloaded content
3. You accept full legal responsibility for your use of this tool
4. The author bears NO responsibility for misuse

Violating copyright law can result in severe civil and criminal penalties.

---

✨ Features

• 🔐 Secure Authentication - Token caching (login once)
• ⚡ Fast Downloads - Leverages ffmpeg for 20-40x real-time speed
• 📁 Organized Structure - Clean folder hierarchy by course/module/lesson
• ⏸️ Resume Support - Skips already downloaded videos
• 🎥 High Quality - Downloads best available video quality
• 🔒 Privacy First - All processing happens locally

---

📋 Requirements

• Python 3.12+
• ffmpeg (for fast video decryption)
• Chromium (auto-installed via Playwright)

---

🚀 Installation

1. Clone Repository

cd ~/c
git clone https://github.com/YOUR_USERNAME/hotmart-course-backup.git
cd hotmart-course-backup

2. Create Virtual Environment

python3 -m venv venv
source venv/bin/activate  # Mac/Linux
# OR: venv\Scripts\activate  # Windows

3. Install Python Dependencies

pip install -r requirements-minimal.txt
python -m playwright install chromium

4. Install ffmpeg (System-Level)

macOS:

brew install ffmpeg

Ubuntu/Debian:

sudo apt update && sudo apt install ffmpeg

Windows: Download from ffmpeg.org and add to PATH

---

🎯 Usage

Method 1: Environment Variables (Recommended)

export HOTMART_EMAIL="your-email@example.com"
export HOTMART_PASSWORD="your-password"
python simple_downloader.py

Method 2: Interactive Prompt

python simple_downloader.py
# You'll be prompted for email/password

Method 3: Edit Script (Not Recommended)

Edit simple_downloader.py lines 326-327 to add credentials directly (ensure you don't commit these!)

---

📂 Output

Downloads are saved to:

./downloads/
└── Course Name/
    ├── 01. Module 1/
    │   ├── 01. Lesson 1.mp4
    │   └── 02. Lesson 2.mp4
    └── 02. Module 2/
        └── 01. Lesson 1.mp4

---

🔑 Token Caching

After first login, your authentication token is saved to .hotmart_token.

• ✅ No need to re-login every time
• ⚠️ Keep this file secure (add to .gitignore)
• 🔄 Delete to force re-authentication

Security Note: Treat .hotmart_token like a password!

---

⚡ Performance

With ffmpeg installed:

• Speed: 20-40x faster than real-time
• Example: A 5-minute video downloads in ~10 seconds

Without ffmpeg:

• Downloads work but are extremely slow (0.5-1x real-time)

---

🛠️ Troubleshooting

Token Expired

rm .hotmart_token
python simple_downloader.py

Download Stuck

• Press Ctrl+C to stop
• Run again - it will resume automatically

Missing ffmpeg Warning

WARNING: The stream has AES-128 encryption and pycryptodomex is not available

Solution: Install ffmpeg (see Installation section)

Network Changed Mid-Download

• Script may hang
• Press Ctrl+C and restart - already downloaded files will be skipped

---

🔒 Privacy & Security

• ✅ No Data Sent to Third Parties - All processing is local
• ✅ Open Source - You can inspect all code
• ⚠️ Credential Security - Use environment variables, never commit credentials
• ⚠️ Token Security - Add .hotmart_token to .gitignore

---

📝 .gitignore Recommended

# Credentials
.hotmart_token
.env

# Downloads
downloads/

# Python
venv/
__pycache__/
*.pyc

---

🤝 Contributing

Contributions are welcome! Please ensure:

1. Code is used for legal, personal backup only
2. No features that enable piracy or content sharing
3. Maintain clear legal disclaimers

---

📜 License

MIT License - See LICENSE file

Legal Reminder: This license does NOT grant you rights to downloaded content. You must own/purchase content before downloading.

---

⚠️ Final Warning

Copyright infringement is a serious crime.

This tool is a backup utility for content you legally own. Misuse can result in:

• Civil lawsuits (damages up to $150,000 per work in the US)
• Criminal prosecution
• Account termination
• Legal fees

Use responsibly. Download only what you own.

---

🙋 Support

• 🐛 Bug Reports: Open a GitHub issue
• 💡 Feature Requests: Open a GitHub discussion
• 🚫 Piracy Support: Will be ignored/reported

---

Made with ❤️ for legitimate course backup

Remember: Creators deserve to be paid for their work. Support them by purchasing content legally.