KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

Platzi-Download

★ 95 Open GitHub ↗

Permite descargar videos de platzi muchos más rápido. Permite descargar tanto los videos, las lecturas, los subtítulos (si están disponibles) y los recursos de cada una de las clases.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<br/>

</div>

# 📌 Overview

**Downloader** is a Python automation tool designed to download **complete Platzi courses** in a structured and scalable way.

It handles everything from course parsing to video downloads and optional resources extraction.

# ⚙️ What It Does

The pipeline automatically processes each course URL:

- 🔐 Validates session cookie and course access
- 🔎 Extracts lesson links and metadata
- 🌐 Fetches lesson pages asynchronously (`aiohttp`)
- 🧠 Parses video URLs and lecture metadata
- 📎 Downloads course resources (optional)
- 🎥 Downloads videos using `yt-dlp`
- 🧹 Cleans temporary files (optional)
- 📊 Generates structured course output files

# ⚡ Performance Improvements & Usage Updates

## 🚀 Faster & More Stable

This new version is significantly:

- ⚡ **Faster** due to removal of browser automation (no Selenium/ChromeDriver)
- 🧠 **More stable** using direct HTTP/API-based requests
- 🛡️ **Less error-prone**, with improved retry and parsing logic
- 📦 Containerized for the default downloader workflow; optional Playwright/Chromium fallback requires additional browser setup

## 📚 Multi-Course & Route Support

You can download:

- ✅ A single course
- ✅ Multiple courses
- ✅ A complete Platzi Route
  💙 Special thanks to **[@a-peirogon](https://github.com/a-peirogon)** for contributing the Platzi Route implementation.

The downloader automatically detects whether each URL is a course or a route.

If a route URL is provided, it will:

1. Extract every course contained in the route.
2. Remove duplicate courses.
3. Download all courses sequentially.

### 📌 Examples

Single course

```env
COURSE_URL=https://platzi.com/cursos/python/
```

Multiple courses

```env
COURSE_URL=https://platzi.com/cursos/python/,https://platzi.com/cursos/docker/
```

Complete route

```env
COURSE_URL=https://platzi.com/ruta/administracion-de-servidores-linux/
```

Mix routes and courses

```env
COURSE_URL=https://platzi.com/ruta/administracion-de-servidores-linux/,https://platzi.com/cursos/python/
```

The downloader will automatically expand every route into its courses before starting the download.

## 🔁 Resume & Retry Behavior

If any video fails to download:

- ❌ No need for manual recovery
- 🔄 Simply **run the program again**
- ✅ The downloader will automatically retry missing or failed videos

This makes the system resilient to network issues or temporary failures.

## 💡 Summary

- ⚡ Faster downloads
- 🧩 Fewer errors and better stability
- 📚 Multi-course download support
- 🔁 Easy retry system (just rerun the script)

# 🧱 Architecture

```txt
Course / Route URL
        ↓
Detect URL Type
        ↓
Extract Course Links
(Route → Courses)
        ↓
Fetch HTML (async)
        ↓
Parse Video Metadata
        ↓
Generate videos.json
        ↓
Download Videos (yt-dlp)
        ↓
Optional Resources + Cleanup
```

# 📁 Project Structure

```
src/
 ├── main.py                 → Entry point
 ├── config.py               → Environment & validation
 ├── extractCourseLinks.py   → Course parsing
 ├── extractRouteLinks.py    → Route → Course extraction
 ├── openLinks.py            → Async HTML fetching
 ├── getVideosLink.py        → Video extraction logic
 ├── downloadVideos.py       → yt-dlp downloader
 ├── downloadResourses.py    → Course resources
 ├── convertHTML2MD.py       → HTML → Markdown/PDF
 ├── convertMD2PDF.py        → Markdown → PDF
 ├── validateHtml.py         → Page validation
 ├── getToken.py             → Auth token handler
 ├── utils.py                → Shared utilities
```

# 📦 Requirements

- Python **3.12+**
- Valid **Platzi session cookie**
- Course URL access
- `ffmpeg`
- Chromium (Playwright fallback)

```bash
pip install -r requirements.txt
```

# 🔐 How to Get Your Cookie (Required Setup)

This project requires a valid **Platzi session cookie** to access course content.

## 📍 Where to Find It

You can extract it using your browser’s **Developer Tools**.

### 🧭 Steps (Chrome / Edge / Firefox)

1. Go to 👉 https://platzi.com
2. Log in with your account
3. Open Developer Tools:
   - Windows/Linux: `F12` or `Ctrl + Shift + I`
   - Mac: `Cmd + Option + I`
4. Go to the **Application** tab (or **Storage** in Firefox)
5. On the left panel, open:
   ```
   Cookies → https://platzi.com
   ```
6. Look for the cookie named:

```txt
s
```

7. Copy the value of the `s` cookie

## ⚙️ Example `.env`

```env
#COOKIE=your_cookie_value_here
s=ydioioapokxasoijqweopksdopic
```

## ⚠️ Important Notes

- 🔒 This cookie is **personal and session-based**
- ⏳ It may expire after logout or time
- 🚫 Do NOT share it publicly
- 🔄 If downloads fail, refresh your login and update the cookie

## 💡 Tip

If you are logged out frequently, just re-copy the `s` cookie from DevTools and update your `.env` file.

# ⚙️ Configuration

All configuration is handled via `.env`.

| Variable                            | Required | Default    | Description                                  |
| ----------------------------------- | -------- | ---------- | -------------------------------------------- |
| COOKIE                              | ✅ Yes   | -          | Platzi session cookie                        |
| COURSE_URL                          | ✅ Yes   | -          | Course and/or Route URLs (comma-separated)   |
| VIDEO_DOWNLOAD_MAX_PARALLEL         | Optional | `1`        | Maximum simultaneous video downloads         |
| VIDEO_DOWNLOAD_BATCH_SIZE           | Optional | `30`       | Number of downloads before cooldown          |
| VIDEO_DOWNLOAD_COOLDOWN             | Optional | `10`       | Delay between download batches (seconds)     |
| VIDEO_DOWNLOAD_START_DELAY          | Optional | `0.5`      | Delay before each download starts            |
| VIDEO_DOWNLOAD_LIMIT_RATE           | Optional | `100M`     | yt-dlp download rate limit                   |
| VIDEO_DOWNLOAD_CONCURRENT_FRAGMENTS | Optional | `3`        | Concurrent fragments downloaded by yt-dlp    |
| VIDEO_DOWNLOAD_FRAGMENT_RETRIES     | Optional | `20`       | Retry attempts per fragment                  |
| VIDEO_DOWNLOAD_RETRIES              | Optional | `20`       | Total retry attempts per video               |
| VIDEO_DOWNLOAD_RETRY_SLEEP          | Optional | `exp=1:20` | Retry backoff strategy                       |
| VIDEO_DOWNLOAD_SLEEP_REQUESTS       | Optional | `0`        | Delay between yt-dlp requests                |
| KEEP_TMP_FILES                      | Optional | `N`        | Keep temporary files (`Y/N`)                 |
| DOWNLOAD_RESOURCES                  | Optional | `Y`        | Download additional course resources (`Y/N`) |
| SHOW_DOWNLOAD_LOGS                  | Optional | `N`        | Enable verbose yt-dlp logs (`Y/N`)           |
| LECTURES_FORMAT_DOWNLOAD            | Optional | `pdf`      | Lecture export format (`md` or `pdf`)        |
| COURSE_NAME_DATE_FORMAT             | Optional | `%Y`       | Folder naming date format                    |

> 💡 Feel free to adjust the download configuration values based on your system performance, internet connection, or preferred behavior.
>
> Lower values may improve stability on slower systems, while higher values can increase download speed on more powerful machines or faster networks.
>
> You can experiment with:
>
> - ⚡ Parallel downloads
> - 📦 Batch sizes
> - 🔁 Retry limits
> - 🚦 Rate limits
> - ⏱️ Cooldowns and delays
>
> to achieve the best balance between speed, stability, and reliability for your environment.
>
> ⚠️ Using too many parallel downloads or extremely high download speeds may cause videos to fail, timeout, or trigger temporary rate limits from the platform.
>
> If you experience failed downloads, reduce:
>
> - `VIDEO_DOWNLOAD_MAX_PARALLEL`
> - `VIDEO_DOWNLOAD_LIMIT_RATE`
> - `VIDEO_DOWNLOAD_CONCURRENT_FRAGMENTS`
>
> for more stable results.

## 📄 Example `.env`

```env
s=your_cookie_here

# Single course
COURSE_URL=https://platzi.com/cursos/example-course/

# Multiple courses
# COURSE_URL=https://platzi.com/cursos/course1/,https://platzi.com/cursos/course2/

# Complete route
# COURSE_URL=https://platzi.com/ruta/administracion-de-servidores-linux/

# Mix routes and courses
# COURSE_URL=https://platzi.com/ruta/administracion-de-servidores-linux/,https://platzi.com/cursos/python/

VIDEO_DOWNLOAD_MAX_PARALLEL=1
VIDEO_DOWNLOAD_BATCH_SIZE=30
VIDEO_DOWNLOAD_COOLDOWN=10
VIDEO_DOWNLOAD_START_DELAY=0.5
VIDEO_DOWNLOAD_LIMIT_RATE=100M
VIDEO_DOWNLOAD_CONCURRENT_FRAGMENTS=3
VIDEO_DOWNLOAD_FRAGMENT_RETRIES=20
VIDEO_DOWNLOAD_RETRIES=20
VIDEO_DOWNLOAD_RETRY_SLEEP=exp=1:20
VIDEO_DOWNLOAD_SLEEP_REQUESTS=0

KEEP_TMP_FILES=N
DOWNLOAD_RESOURCES=Y
SHOW_DOWNLOAD_LOGS=N

LECTURES_FORMAT_DOWNLOAD=pdf
COURSE_NAME_DATE_FORMAT=%Y
```

# 🐳 Docker Usage

## Compose

```yaml
services:
  Platzi-Download:
    container_name: Platzi-Download
    image: ghcr.io/oscardogar/platzi-download:latest
    user: "${UID:-1000}:${GID:-1000}"
    volumes:
      - /your/path/:/app/Videos
    env_file:
      - .env
```

You can configure everything directly inside `docker-compose.yml` without using a separate `.env` file.
Just copy the compose file below, update the required values (such as `your_cookie_here`, `COURSE_URL`, and the volume path):

```yaml
services:
  Platzi-Download:
    container_name: Platzi-Download
    image: ghcr.io/oscardogar/platzi-download:latest
    user: "${UID:-1000}:${GID:-1000}"

volumes:
      - /your/path/:/app/Videos

environment:
      # Required
      s: "your_cookie_here"

# Required
      # Supports courses and routes (comma-separated)
      COURSE_URL: "https://platzi.com/ruta/administracion-de-servidores-linux/,https://platzi.com/cursos/python/"

# Optional (defaults shown below)
      VIDEO_DOWNLOAD_MAX_PARALLEL: "1"
      VIDEO_DOWNLOAD_BATCH_SIZE: "30"
      VIDEO_DOWNLOAD_COOLDOWN: "10"
      VIDEO_DOWNLOAD_START_DELAY: "0.5"
      VIDEO_DOWNLOAD_LIMIT_RATE: "100M"

# Optional (defaults shown below)
      VIDEO_DOWNLOAD_CONCURRENT_FRAGMENTS: "3"
      VIDEO_DOWNLOAD_FRAGMENT_RETRIES: "20"
      VIDEO_DOWNLOAD_RETRIES: "20"

# Optional (defaults shown below)
      VIDEO_DOWNLOAD_RETRY_SLEEP: "exp=1:20"
      VIDEO_DOWNLOAD_SLEEP_REQUESTS: "0"

# Optional
      KEEP_TMP_FILES: "N"

# Optional
      DOWNLOAD_RESOURCES: "Y"

# Optional
      SHOW_DOWNLOAD_LOGS: "N"

# Optional
      LECTURES_FORMAT_DOWNLOAD: "pdf"

# Optional
      COURSE_NAME_DATE_FORMAT: "%Y"
```

Run:

```bash
docker compose up
```

---

## Build manually

```bash
docker build -t Platzi-Download .
docker run --rm --env-file .env -v "$PWD/Videos:/app/Videos" Platzi-Download
```

---

# 🚀 Usage

```bash
python src/main.py
```

Supports multiple courses and routes (comma-separated):

```txt
# Multiple courses
COURSE_URL=https://course1,https://course2

# Complete route
COURSE_URL=https://platzi.com/ruta/administracion-de-servidores-linux/

# Mix routes and courses
COURSE_URL=https://platzi.com/ruta/administracion-de-servidores-linux/,https://course1
```

---

# 📤 Output Structure

```
Videos/
├── Course Name/
│   ├── course_info.md
│   ├── course_image.jpg
│   ├── videos.json    → Present only if KEEP_TMP_FILES=Y
│   ├── responses/     → Present only if KEEP_TMP_FILES=Y
│   ├── VideosLinks/   → Present only if KEEP_TMP_FILES=Y
│   ├── resources/
│   └── *.mp4
│
└── Route Name/
    ├── Course 1/
    │   ├── course_info.md
    │   ├── course_image.jpg
    │   ├── videos.json    → Present only if KEEP_TMP_FILES=Y
    │   ├── responses/     → Present only if KEEP_TMP_FILES=Y
    │   ├── VideosLinks/   → Present only if KEEP_TMP_FILES=Y
    │   ├── resources/
    │   └── *.mp4
    │
    ├── Course 2/
    │   ├── course_info.md
    │   ├── course_image.jpg
    │   ├── videos.json    → Present only if KEEP_TMP_FILES=Y
    │   ├── responses/     → Present only if KEEP_TMP_FILES=Y
    │   ├── VideosLinks/   → Present only if KEEP_TMP_FILES=Y
    │   ├── resources/
    │   └── *.mp4
    │
    └── ...
```

# 💡 Key Features

- ⚡ Async scraping pipeline
- 🎥 yt-dlp optimized downloads
- 🔁 Retry & recovery system
- 📦 Batch + cooldown control
- 🧠 Metadata extraction engine
- 🧾 Course documentation generator
- 🐳 Docker-ready deployment
- 🗂️ Automatic Platzi Route support (downloads every course in a route)

# 🤝 Contributing

Contributions are welcome:

- 🐛 Bug reports
- 💡 Feature requests
- 🔧 Pull requests

# 🤝 Contributors

Every contribution, whether it's a bug report, feature request, documentation improvement, or code submission helps make **Platzi-Download** better for everyone.

A huge thank you to everyone who has taken the time to contribute to this project. ❤️

**Want to see your avatar here?**

Contributions of all sizes are welcome! Feel free to open an issue, submit a pull request, or help improve the documentation.

⭐ If you find this project useful, don't forget to star the repository!

</div>

# ⭐ Support the Project

If this project saves you time or helps you, consider supporting it ❤️

</div>

# 📜 License

This project is licensed under the **GNU General Public License v3.0 (GPL-3.0)**.

You are free to:

- ✔️ Use
- ✔️ Modify
- ✔️ Distribute

But you must:

- 🔒 Keep source code open when distributing
- 🔒 Keep the same license (GPL-3.0)
- 🔒 Preserve copyright & license notices

👉 https://www.gnu.org/licenses/gpl-3.0.html

### 🚀 Automate everything. Keep it open.

</div>

Platzi-Download

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README