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.

Einschalten

1. Optionen → Fernzugriff.
2. Tick Let phones and computers on the local network control GDM.
3. Klicken Sie auf OK.

Die Seite zeigt dann Ein und die zu öffnende Adresse an, z. B. 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.

Telefon koppeln

1. Auf dem Computer: Optionen → Fernzugriff → Gerät koppeln... Es wird ein QR-Code, die Adresse und ein 8-stelliger Code angezeigt.
2. Auf dem Telefon, im selben WLAN: Scannen Sie den QR-Code mit der Kamera (oder geben Sie die Adresse ein).
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. Der Code wird beim Scannen des QR-Codes automatisch ausgefüllt; andernfalls geben Sie ihn ein. Geben Sie dem Telefon einen Namen und tippen Sie auf Koppeln. Das Fenster auf dem Computer bestätigt dies und schließt sich mit Fertig.

Ein Code funktioniert einmal, für zehn Minuten und nicht nach fünf falschen Versuchen: Klicken Sie auf Neuer Code für einen anderen. Um die Seite mit einem Tipp erreichbar zu halten, fügen Sie sie dem Startbildschirm des Telefons hinzu (Menü des Browsers: Zum Startbildschirm hinzufügen).

Was die Seite tut

• 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).
• Die Liste: jeder Download mit seinem Fortschritt, seiner Geschwindigkeit und Größe, mit Alle, Unvollendet und Abgeschlossen. Anhalten und Starten Sie jeden einzelnen; × entfernt ihn aus der Liste und mit Datei ebenfalls löschen löscht es seine Datei vom Computer.
• Die Warteschlangen: jede einzelne starten und stoppen.
• Die Leiste oben zeigt die Gesamtgeschwindigkeit und den freien Speicherplatz an, wohin Ihre Downloads gehen.

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.

Ihre gekoppelten Geräte

Optionen → Fernzugriff listet die gekoppelten Geräte auf, wann jedes gekoppelt wurde und wann es zuletzt gesehen wurde. Wählen Sie eines aus und klicken Sie auf Entfernen: Es wird ab der nächsten Anfrage sofort abgelehnt (kein OK erforderlich). Auf dem Telefon tut ⋮ → Dieses Gerät vergessen auf der Seite dasselbe von dieser Seite aus.

Telefon verloren? Entfernen Sie es in den Optionen. Um alle sofort zu stoppen, deaktivieren Sie das Kontrollkästchen: Nichts hört mehr zu.

Wo es zuhört

• Hören auf: Jede lokale Netzwerkadresse (die Standardeinstellung) hört auf jede private Adresse des Computers (192.168.x.x, 10.x.x.x, 172.16–31.x.x und IPv6s fd…), einzeln, und folgt ihnen, wenn Sie einem anderen Netzwerk beitreten. Nur dieser Computer hört auf 127.0.0.1. Oder wählen Sie eine Adresse eines Adapters.
• Port: 8463, es sei denn, ein anderes Programm verwendet ihn; dann wählen Sie einen anderen (1024 bis 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.

Sicherheit

Was die Fernsteuerung kurz gesagt sicher hält:

• Standardmäßig deaktiviert, und nichts hört zu, während es deaktiviert ist.
• Nur gekoppelte Geräte: Jede Anfrage außer dem Koppeln benötigt das Token, das das Gerät beim Koppeln erhalten hat. Ein Kopplungscode funktioniert einmal, für zehn Minuten, mit fünf Versuchen, und Versuche werden verlangsamt. Die Einstellungen speichern einen Fingerabdruck jedes Tokens, nicht das Token.
• Your local network only: GDM listens on the computer's private addresses, one by one, never on every address at once.
• Verschlüsselt: HTTPS, mit einem auf Ihrem Computer erstellten und gespeicherten Zertifikat; dessen Fingerabdruck ist in den Optionen, um ihn mit dem im Browser des Telefons angezeigten zu vergleichen.
• 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.
• Nur Downloads: Ein gekoppeltes Gerät listet, fügt hinzu, pausiert, startet und entfernt Downloads sowie startet und stoppt Warteschlangen. Es kann keine Einstellungen ändern, keine Fenster auf dem Computer öffnen oder Ordner einsehen (die Liste, die es erhält, enthält keine Pfade).

Ein Problem gefunden? Bitte melden Sie es privat, wie in SECURITY.md beschrieben.