Control GDM from your phone

Add a download from your phone, or from another computer at home, and watch it run on the computer where GDM is: paste a link or a magnet link, send a .torrent file, see the list with its progress, and pause, start or remove downloads. Your phone opens a small page that GDM itself serves; nothing is installed on the phone, and no outside service is involved.

The remote control is off until you turn it on, it answers only phones and computers you paired with a code GDM shows, and it listens only on your local network (your Wi-Fi or your cable), never on an address the internet can reach.

L'activer

1. Options → Remote.
2. Tick Let phones and computers on the local network control GDM.
3. Cliquez sur OK.

La page indique alors On et affiche l'adresse à ouvrir, telle que https://192.168.1.20:8463/.

The first time, Windows may ask whether to let GDM communicate on networks: allow it on private networks, or the phone can't reach GDM.

Jumeler votre téléphone

1. Sur l'ordinateur : Options → Remote → Pair a device... Il affiche un code QR, l'adresse et un code à 8 chiffres.
2. Sur le téléphone, sur le même Wi-Fi : scannez le code QR avec l'appareil photo (ou tapez l'adresse).
3. The browser warns that the connection's certificate isn't trusted. That is expected: GDM made its own certificate, on your computer, and no public authority knows it. To be sure the page is your GDM's, open the warning's details: the certificate's SHA-256 fingerprint is the one Options → Remote shows. Then continue to the page (Advanced → Proceed in Chrome, Show details → visit this website in Safari).
4. Le code est rempli lorsque vous avez scanné le code QR ; sinon, tapez-le. Donnez un nom au téléphone et appuyez sur Pair. La fenêtre sur l'ordinateur l'indique et se ferme avec Done.

Un code fonctionne une fois, pendant dix minutes, et pas après cinq tentatives erronées : cliquez sur New code pour en obtenir un autre. Pour garder la page à portée de main, ajoutez-la à l'écran d'accueil du téléphone (menu du navigateur : Ajouter à l'écran d'accueil).

Ce que fait la page

• Add: a download's address or a magnet link, or a .torrent file from the phone. Pick a Category (or let the file's type pick it), and When: Start now, or wait in a queue. A torrent is added with all its files, once GDM has read them (a magnet link can take a moment).
• The list : chaque téléchargement avec sa progression, sa vitesse et sa taille, avec All, Unfinished et Finished. Pause et Start chacun ; × le supprime de la liste, et avec Delete the file too, supprime son fichier de l'ordinateur.
• The queues : démarrez et arrêtez chacune d'elles.
• La barre en haut affiche la vitesse totale et l'espace libre où vont vos téléchargements.

Downloads added from the phone are like the ones you add on the computer: they go into the category's folder, follow the queues, the Scheduler and the speed limits, and go through the network adapter you chose in Options → Proxy / Socks (and stop when it disconnects). The page shows the language your phone uses when GDM has it, and follows its light or dark mode.

Vos appareils jumelés

Options → Remote liste les appareils jumelés, la date de leur jumelage et de leur dernière connexion. Sélectionnez-en un et cliquez sur Remove : il sera refusé dès sa prochaine requête, immédiatement (pas besoin de OK). Sur le téléphone, ⋮ → Forget this device de la page fait la même chose de ce côté.

Vous avez perdu votre téléphone ? Supprimez-le dans les Options. Pour arrêter tout le monde d'un coup, décochez la case : plus rien n'écoute.

Où il écoute

• Listen on : Every local network address (par défaut) écoute sur chaque adresse privée de l'ordinateur (192.168.x.x, 10.x.x.x, 172.16–31.x.x, et fd… pour IPv6), une par une, et les suit lorsque vous rejoignez un autre réseau. This computer only écoute sur 127.0.0.1. Ou choisissez une adresse d'un adaptateur.
• Port : 8463 sauf si un autre programme l'utilise ; alors choisissez-en un autre (de 1024 à 65535).

Don't make GDM reachable from the internet (a router's port forwarding): the remote control is made for your home network. To reach it while away, use a VPN to your home network instead (WireGuard, Tailscale): with Tailscale, choose its address in Listen on.

Sécurité

Ce qui assure la sécurité de la télécommande, en bref :

• Désactivée par défaut, et rien n'écoute lorsqu'elle est désactivée.
• Appareils jumelés uniquement : chaque requête, sauf le jumelage, nécessite le jeton que l'appareil a obtenu lors du jumelage. Un code de jumelage fonctionne une fois, pendant dix minutes, avec cinq tentatives, et les tentatives sont ralenties. Les paramètres conservent une empreinte de chaque jeton, pas le jeton lui-même.
• Your local network only: GDM listens on the computer's private addresses, one by one, never on every address at once.
• Chiffré : HTTPS, avec un certificat créé et conservé sur votre ordinateur ; son empreinte est dans les Options, pour la comparer avec celle affichée par le navigateur du téléphone.
• Web pages can't use it: requests must name GDM's own address, come from its own page, and carry the token; GDM's page can't be shown inside another site.
• Uniquement les téléchargements : un appareil appairé liste, ajoute, met en pause, démarre et supprime des téléchargements, et démarre et arrête des files d'attente. Il ne peut pas modifier les paramètres, ouvrir des fenêtres sur l'ordinateur ou voir les dossiers (la liste qu'il reçoit n'a pas de chemins).

Vous avez trouvé un problème ? Veuillez le signaler en privé, comme indiqué dans SECURITY.md.