pysh-dl

Gestionnaire de téléchargement privé et sécurisé en python & bash

---

📥 Downloader Suite

Outil en ligne de commande et GUI pour téléchargements sécurisés & privilèges (HTTP/S, Torrents, .onion, I2P)

📚 Table des matières

• Fonctionnalités
• Prérequis
• Installation
• Utilisation
  • Lancer l’interface graphique (GUI)
  • Ligne de commande (CLI) – Exemples
• Sécurité & Confidentialité
• Architecture des fichiers

---

🌟 Fonctionnalités

✅ Protocoles supportés
→ HTTP/HTTPS, Magnet links, BitTorrent (.torrent), .onion (Tor), .i2p

✅ Fonctionnalités avancées
→ Reprise de téléchargement (curl -C -) via Range headers
→ Proxy dynamique : Tor SOCKS5h, I2P HTTP, proxy personnalisé
→ Gestion en file d’attente + pause/reprise (GUI)
→ Vérification d’intégrité : MD5 / SHA1 / SHA256 / SHA512

✅ Confidentialité & sécurité
→ Résolution DNS via le proxy (socks5h://) → aucune fuite DNS
→ Rotation automatique des User-Agent (via fake-useragent)
→ Headers anti-fingerprinting personnalisables
→ Tests de fuites réseau : check-tor, check-i2p, check-leak

---

🛠 Prérequis

• Python ≥ 3.7
• curl (pour la reprise HTTP et checksums)
• (Optionnel) Tor & I2P en local pour l’usage natif de .onion / .i2p

💡 Astuce : Sur Debian/Ubuntu, installez tor et i2pd via apt.

---

📦 Installation

Via le script d’installation (recommandé)

# Cloner le dépôt (remplacez l’URL par la vôtre)
git clone https://github.com/votre-nom/downloader-suite.git
cd downloader-suite

# Installer les dépendances Python
./downloader.sh install

Manuellement

pip install -r requirements.txt

---

🖥 Utilisation

Lancer la GUI (Interface graphique)

# Via le script Bash
./downloader.sh gui

# Ou directement en Python
python3 downloader.py

⚫ Interface sombre via customtkinter, barre de progression, gestion multi-tâches, logs intégrés.

---

Ligne de commande (CLI) – Exemples

Commande	Description
./downloader.sh get https://example.com/file.iso	Téléchargement HTTP/HTTPS standard
./downloader.sh get -p tor https://example.com/doc.pdf	Forcer le proxy Tor pour ce téléchargement
./downloader.sh get http://xxxxx.onion/file	.onion → Tor activé automatiquement
./downloader.sh get 'magnet:?xt=urn:btih:...'	Magnet link (BitTorrent)
./downloader.sh checksum file.iso --algo sha256 --expected abc123...	Vérifier l’intégrité d’un fichier
./downloader.sh check-tor	Tester si Tor fonctionne correctement
./downloader.sh check-leak	Détection de fuites IP/DNS (test complet)

🔁 Ajoutez -C à vos téléchargements pour reprendre une partie interrompue (si le serveur supporte Range) :

./downloader.sh get -C https://example.com/largefile.zip

---

🔒 Sécurité & Confidentialité

Fonctionnalité	Détail
DNS	Résolu côté proxy → pas de requête DNS locale (via socks5h://)
User-Agent	Pool aléatoire via fake-useragent
Headers anti-fingerprinting	Suppression/modification de headers à risque (Accept-Language, Referer, etc.)
WebRTC / JS	Non applicables hors navigateur → pas de risque ici
Logs	Aucune donnée sensible n’est enregistrée par défaut

🛡️ Conseil : Utilisez toujours -p tor si vous souhaitez masquer votre IP ou accéder à des ressources privées.

---

📁 Architecture des fichiers

Fichier	Description
downloader.py	Application GUI complète (Tkinter + customtkinter) avec gestion multi-tâches
downloader.sh	Script Bash CLI : installation, lancement GUI, téléchargements, vérifications
requirements.txt	Dépendances Python (requests, fake-useragent, customtkinter, etc.)

---

📜 Licence

Sous licence MIT — voir le fichier LICENSE pour les détails.

---

💬 Remerciements
Merci à tous les contributeurs, et aux outils open-source qui rendent ce projet possible : curl, requests, customtkinter, fake-useragent.

---