Extensions de navigateur

Installer et utiliser les extensions Chrome et Firefox.

Les extensions interceptent les téléchargements du navigateur et les confient à TurboDL par native messaging. Seule l'extension déclarée peut parler à l'application : aucun port réseau n'est ouvert.

Prérequis

Installez l'extension depuis la boutique de votre navigateur (ci-dessous), puis lancez l'application turbodl une fois : elle enregistre l'hôte natif com.turbodl.host pour Chrome et Firefox (registre Windows, ou fichiers dans ~/.config/google-chrome, ~/.config/chromium et ~/.mozilla sous Linux). L'état est visible dans Paramètres → Navigateur.

Si la boutique n'est pas accessible

Si la boutique n'est pas accessible, ou n'a pas encore validé la dernière version, installez l'extension à la main avec les paquets de la section Extensions de navigateur de la page Téléchargements. Chaque zip contient un README.txt avec les étapes ci-dessous. Paramètres → Navigateur dans l'application renvoie vers cette page.

Chrome (et Chromium)

Installez-la depuis le Chrome Web Store.

Installation manuelle (Chrome, Chromium, Edge, Brave), avec turbodl-chrome-<version>.zip :

1. Décompressez-le dans un dossier que vous gardez : le navigateur charge l'extension depuis ce dossier.
2. Ouvrez chrome://extensions (edge://extensions dans Edge), activez le mode développeur.
3. Charger l'extension non empaquetée → choisissez le dossier qui contient manifest.json.

L'identifiant de l'extension est fixe, même non empaquetée : feiobddkmdahnnjdpnofhgpocpeioejg (le seul accepté par l'application). Pour mettre à jour, décompressez le nouveau zip dans le même dossier, puis cliquez sur la flèche d'actualisation de TurboDL dans chrome://extensions.

Firefox

Installez-la depuis Modules complémentaires Firefox.

Installation manuelle, avec les fichiers de la page Téléchargements :

• Permanente : ouvrez turbodl-firefox-<version>.xpi (signé par Mozilla) avec Firefox, ou glissez-le sur une fenêtre Firefox.
• Temporaire, avec turbodl-firefox-<version>.zip (retirée à la fermeture de Firefox) : décompressez-le, ouvrez about:debugging#/runtime/this-firefox, Charger un module temporaire → choisissez manifest.json.

Identifiant : [email protected].

Utilisation

• Automatique : tout téléchargement http(s) lancé dans le navigateur est mis en pause, envoyé à TurboDL avec le Referer, le User-Agent et, si Send the site's cookies est activé, les cookies du site, puis retiré du navigateur.
• Clic droit sur un lien → « Download with TurboDL ».
• Popup : état de la connexion à l'application, un bouton Open TurboDL, et les options :
  • Capture downloads : activer ou couper la capture ;
  • « Download with TurboDL » dans le menu du clic droit : afficher ou masquer l'entrée du menu ;
  • Leave files smaller than (MB) to the browser : 0 capture tous les fichiers (ceux de taille inconnue sont toujours capturés) ;
  • Send the site's cookies : désactivé par défaut. L'activer demande l'accès à tous les sites, exigé par le navigateur pour lire les cookies du site du fichier ; nécessaire pour les fichiers qui demandent d'être connecté ;
  • Links not to capture : expressions régulières, une par ligne (par exemple \.torrent$) ; les lignes invalides sont signalées sous le champ.

Si l'application est fermée, l'hôte natif la démarre avant de lui transmettre le lien.

Dépannage