Local CLI that downloads media from Instagram, Twitter/X, and YouTube. You run it on your machine; there is no server and no account of ours to configure. Current tagged release: v0.3. License GPL-3.0.
A Qt desktop UI lives on the feat/graphical-interface branch and is not part of main.
Guides (English) live in docs/:
| Guide | Audience |
|---|---|
| Getting started | Anyone new to the project |
| Installation · Configuration | Person who runs it on their computer |
| Usage · Platforms | People downloading media |
| How it works · Limitations | Operators and reviewers |
| Troubleshooting | When a download fails |
| Development | Contributors |
This README is a short overview. Prefer the docs folder if you are installing or using the tool for the first time.
--platform).instaloader, yt-dlp, or pytubefix), asks you to confirm when it can, then writes a file to a directory you choose.Interactive menu:
python multi_downloader.py
One-shot (YouTube audio example; the output directory must already exist):
python multi_downloader.py --platform youtube --url "https://youtu.be/dQw4w9WgXcQ" --mode audio --output "/tmp" --yes
--yes skips confirmations. Filename prompts still appear; press Enter to keep the default name. Details: Usage.
.python-version)Descargas or Downloads under your home folder)Install: Installation. There is no .env file; flags and prompts are the configuration. See Configuration.
multi_downloader.py # Menu and CLI dispatcher
Instagram/ # Instaloader-based post downloader
Twitter/ # yt-dlp tweet video downloader
YouTube/ # pytubefix stream picker
common/ # Shared prompts, URL check, filenames
tests/ # pytest (no live downloads)
Release history: CHANGELOG.md.