threads-dlp

threads-dlp est un outil en ligne de commande qui permet de télécharger des vidéos
publiques depuis Threads à partir de leur URL.

Développé en Python 3.11.2, il utilise Selenium pour l'extraction du lien vidéo, dottify pour simplifier
l'accès aux données extraites, et tqdm pour afficher une barre de progression lors du téléchargement.

N’hésite pas à laisser une ⭐ sur GitHub, ça aide énormément !

Sommaire

• threads-dlp
  • Sommaire
  • Fonctionnalités
  • Installation
  • Utilisation
    • 1. Paramètres
    • 2. Exemple
  • Structure du projet
  • Contribution

Fonctionnalités

• Extraction automatique du lien source de la vidéo
• Téléchargement propre avec suivi en temps réel
• Interface en ligne de commande simple
• Téléchargement dans un dossier personnalisé
• Compatible avec Linux, macOS et Windows

Installation

pip install threads-dlp

Utilisation

Une fois installé, exécute simplement :

threads-dlp --url <lien_threads> -to <chemin_de_sortie>

1. Paramètres

$ threads-dlp -h
usage: threads-dlp [-h] --url URL
                   [-to OUTPUT]
                   [-v]

Télécharge une vidéo Threads à partir de son lien

options:
  -h, --help                  show this help message and exit
  --url URL                   Lien vers la vidéo Threads
  -to OUTPUT, --output OUTPUT Dossier où enregistrer la vidéo (par défaut : ./)
  -v, --version               show program's version number and exit

Option	Description
--url	URL de la vidéo Threads
-to / --output	Dossier de sortie pour enregistrer la vidéo (défaut : ./)
-v / --version	Affiche la version de l’outil

2. Exemple

threads-dlp --url https://www.threads.net/t/Cq8kz123Xy -to ~/Vidéos

Structure du projet

threads-dlp/
├── CONTRIBUTING.md     # Guide pour contribuer au projet
├── LICENSE             # Licence Apache 2.0 pour l’utilisation et la distribution
├── pyproject.toml      # Configuration du projet (PEP 621) avec dépendances, version, etc.
├── README.md           # Documentation principale du projet
├── requirements.txt    # Dépendances du projet (optionnel si pyproject.toml suffit)
├── setup.py            # Ancien script d’installation (remplacé par pyproject.toml)
└── threads_dlp/        # Dossier principal contenant le code source
    ├── __init__.py         # Initialise le package Python
    ├── __version__.py      # Contient la version actuelle du projet
    ├── cli.py              # Point d’entrée de la CLI (command-line interface)
    ├── downloader.py       # Télécharge la vidéo depuis une URL Threads, avec `tqdm`
    ├── extractor.py        # Extrait les données Threads avec Selenium
    ├── make_out_path.py    # Génère un nom de fichier local à partir du lien Threads
    └── __pycache__/        # Dossier auto-généré par Python (à ignorer dans Git)

Contribution

Les contributions sont les bienvenues !
Si tu souhaites corriger un bug, améliorer une fonctionnalité ou proposer une idée, merci de consulter le fichier CONTRIBUTING.md pour connaître les bonnes pratiques à suivre.

Même les petites améliorations comptent.