Prise en main rapide
Fichiers source
Cette page est générée à partir des fichiers source suivants :
res-downloader est un outil de capture et de téléchargement de ressources réseau multiplateforme, basé sur Go et Wails. Il permet d'intercepter automatiquement les ressources multimédias (vidéo, audio, images, m3u8, flux live) via un proxy local et prend en charge de nombreuses plateformes comme WeChat Video, les mini-programmes, Douyin, Kuaishou, Xiaohongshu, etc. (README.md:17-27)
Exigences système et téléchargement
Systèmes d'exploitation pris en charge
res-downloader est compatible avec les principaux systèmes d'exploitation de bureau :
| Plateforme | Version minimale | Notes |
|---|---|---|
| Windows | 10+ | Windows 7 nécessite la version 2.3.0 |
| macOS | 10.15+ | Désactiver le pare-feu si interception impossible |
| Linux | Ubuntu 18.04+ | Installation via .deb ou exécutable |
(README.md:24-25, docs/getting-started.md:5-5)
Téléchargement des fichiers d'installation
Les fichiers d'installation sont disponibles depuis plusieurs sources officielles :
- GitHub Releases : https://github.com/putyy/res-downloader/releases
- Lanzou Cloud : https://wwjv.lanzoum.com/b04wgtfyb (mot de passe : 9vs5)
(README.md:36-41, docs/getting-started.md:1-3)
Recommandations par plateforme :
- Windows : Télécharger les fichiers avec extension
.exe, préférezwin_amd64.exeoux64-installer.exeselon l'architecture système (docs/installation.md:1-2) - macOS : Télécharger les fichiers avec extension
.dmg(docs/installation.md:3-3) - Linux : Choisir le package correspondant à la distribution (
.debpour Ubuntu/Debian) ou l'exécutable direct
Installation par plateforme
Installation sur Windows
Le processus d'installation sur Windows suit les étapes standard :
- Double-cliquer sur le fichier
.exetéléchargé - Suivre l'assistant d'installation
- Important : Lors de la première exécution, faire un clic droit et sélectionner "Exécuter en tant qu'administrateur"
Prérequis critiques :
- Fermer tous les logiciels de sécurité/antivirus tiers avant l'installation
- Autoriser l'installation du certificat racine lors de la première exécution
- Autoriser l'accès réseau au pare-feu Windows
(docs/getting-started.md:8-9, docs/getting-started.md:14-14)
Installation sur macOS
L'installation sur macOS utilise le format DMG standard :
- Double-cliquer sur le fichier
.dmgtéléchargé - Glisser l'application
res-downloaderdans le dossier Applications - Lancer l'application depuis le dossier Applications ou Spotlight
Note importante : Si l'application ne parvient pas à intercepter les ressources réseau, désactiver temporairement le pare-feu macOS dans Préférences Système > Sécurité et confidentialité > Pare-feu. (docs/getting-started.md:16-16)
Installation sur Linux
Deux méthodes d'installation sont disponibles pour Linux :
Méthode 1 : Installation via package .deb (Ubuntu/Debian)
bash1sudo apt install ./res-downloader_3.0.2_linux_x64.deb
Méthode 2 : Exécution directe du binaire
bash1chmod +x ./res-downloader_3.0.2_linux_x64 2sudo ./res-downloader_3.0.2_linux_x64
Note : Remplacer le nom du fichier par la version effectivement téléchargée. Les privilèges root (sudo) sont nécessaires pour la configuration du proxy système et l'installation du certificat.
Démarrage rapide en 3 étapes
Le flux de démarrage suivant permet une mise en route immédiate :
正在加载图表渲染器...
(README.md:52-57, docs/getting-started.md:8-12)
Étape 1 : Autorisations initiales
Lors de la première exécution, deux autorisations sont obligatoires :
- Autoriser l'installation du certificat : Nécessaire pour intercepter le trafic HTTPS
- Autoriser l'accès réseau : Permet à l'application de configurer le proxy système
(README.md:52-52, docs/getting-started.md:8-8)
Étape 2 : Activation du proxy local
Une fois l'application ouverte :
- Cliquer sur le bouton "Démarrer proxy" situé en haut à gauche de l'interface
- Sélectionner les types de ressources à capturer (par défaut : tous les types)
- Le proxy système est configuré automatiquement sur
127.0.0.1:8899
(README.md:53-55, docs/getting-started.md:10-10, core/config.go:55-56)
Étape 3 : Capture des ressources
Pour capturer des ressources :
- Ouvrir la source cible dans un navigateur externe ou une application (WeChat Video, mini-programmes, pages web, etc.)
- Naviguer normalement et lire le contenu multimédia
- Retourner à l'interface res-downloader pour voir la liste des ressources interceptées
(README.md:55-57, docs/getting-started.md:11-12)
Vérification du bon fonctionnement
Vérification des paramètres proxy
Si l'application ne capture pas les ressources, vérifier la configuration du proxy système :
| Paramètre | Valeur attendue |
|---|---|
| Adresse | 127.0.0.1 |
| Port | 8899 |
Sous Windows : Paramètres > Réseau et Internet > Proxy > Configuration manuelle du proxy
Sous macOS : Préférences Système > Réseau > Avancé > Proxy
Sous Linux : Variables d'environnement http_proxy et https_proxy, ou configuration réseau du bureau
Vérification de l'interception
Une capture réussie se manifeste par :
- Apparition de ressources dans la liste principale de l'interface
- Indicateur de statut du proxy actif (généralement vert)
- Présence de fichiers dans le répertoire de téléchargement par défaut
Le répertoire de téléchargement par défaut est configuré sur le dossier Downloads du profil utilisateur courant. (core/config.go:58-58)
Problèmes courants et solutions
L'application ne capture aucune ressource
Causes possibles et solutions :
- Proxy non activé : Vérifier que le bouton "Démarrer proxy" a été cliqué et que l'indicateur montre un état actif
- Configuration proxy incorrecte : Vérifier manuellement les paramètres proxy système (
127.0.0.1:8899) (README.md:78-80) - Pare-feu bloquant : Désactiver temporairement le pare-feu système ou les logiciels antivirus tiers
- Certificat non installé : Réinstaller l'application en acceptant l'installation du certificat racine
Impossible de naviguer sur Internet après fermeture
Ce problème survient lorsque le proxy système n'est pas restauré automatiquement après la fermeture de l'application.
Solution manuelle :
Désactiver manuellement les paramètres proxy dans la configuration réseau du système d'exploitation. (README.md:82-84)
Téléchargements lents ou échoués pour les gros fichiers
Pour les ressources volumineuses, l'outil intégré peut présenter des limitations.
Solutions recommandées :
- Utiliser un gestionnaire de téléchargement externe comme Neat Download Manager ou Motrix
- Copier l'URL de la ressource depuis res-downloader et la coller dans le gestionnaire externe
- Pour les ressources WeChat Video, utiliser l'option "Déchiffrer vidéo" disponible dans les actions
Problèmes spécifiques à Windows 7
Windows 7 n'est pas pris en charge par les versions récentes de res-downloader.
Solution : Utiliser la version 2.3.0 (branche "old" ou releases antérieures), qui est basée sur Electron et compatible avec Windows 7. (README.md:40-40, docs/getting-started.md:5-5)
Problèmes spécifiques à macOS
Si l'application ne parvient pas à intercepter le trafic sur macOS :
- Désactiver le pare-feu macOS : Préférences Système > Sécurité > Pare-feu
- Vérifier que l'application est signée et notée dans les paramètres de sécurité
- En cas de blocage par Gatekeeper : Autoriser l'application dans Préférences Système > Sécurité et confidentialité > onglet Général
(docs/getting-started.md:16-16)
Ressources et support
Documentation et communauté
Pour obtenir de l'aide supplémentaire :
- Documentation en ligne : https://res.putyy.com/
- GitHub Issues : https://github.com/putyy/res-downloader/issues
- Forum de discussion : https://s.gowas.cn/d/4089
- Groupe de discussion : Scanner le QR code disponible sur https://www.putyy.com/app/admin/upload/img/20250418/6801d9554dc7.webp
(README.md:29-34, README.md:86-89)
Outils complémentaires
Pour certains cas d'usage spécifiques :
| Type de ressource | Outil recommandé | Lien |
|---|---|---|
| Lecture m3u8 | m3u8play | https://m3u8play.com/ |
| Téléchargement m3u8 | m3u8-down | https://m3u8-down.gowas.cn/ |
| Enregistrement flux live | OBS Studio | https://obsproject.com/ |
Prochaines étapes
Après avoir réussi la mise en route de base, les utilisateurs peuvent explorer :
- Filtrage avancé des ressources : Configurer des règles personnalisées pour cibler des types de médias spécifiques
- Configuration du proxy amont : Utiliser un proxy secondaire pour accéder à des réseaux restreints
- Paramètres de téléchargement : Ajuster le nombre de tâches simultanées et le répertoire de sauvegarde
- Déchiffrement des ressources WeChat : Utiliser la fonction de déchiffrement intégrée pour les vidéos de comptes officiels
Ces fonctionnalités avancées sont documentées dans le guide d'utilisation complet disponible sur la documentation en ligne. (README.md:29-31)
