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.

Увімкнути

1. Параметри → Віддалений.
2. Tick Let phones and computers on the local network control GDM.
3. Натисніть OK.

Після цього на сторінці з’явиться напис Увімкнено та відобразиться адреса для відкриття, наприклад 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.

Підключити телефон

1. На комп’ютері: Параметри → Віддалений → Підключити пристрій... З’явиться QR-код, адреса та 8-значний код.
2. На телефоні, у тій самій мережі Wi-Fi: відскануйте QR-код камерою (або введіть адресу).
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. Код заповнюється, коли ви скануєте QR-код; інакше введіть його. Дайте телефону ім’я та натисніть Підключити. У вікні на комп’ютері з’явиться відповідне повідомлення, і воно закриється з Готово.

Код діє один раз, протягом десяти хвилин, і не діє після п’яти неправильних спроб: натисніть Новий код для отримання іншого. Щоб сторінка була доступна одним дотиком, додайте її на головний екран телефону (меню браузера: Додати на головний екран).

Що робить сторінка

• 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).
• Список: кожне завантаження з його прогресом, швидкістю та розміром, з Усі, Незавершені та Завершено. Пауза та Запустити кожне; × видаляє його зі списку, а з Видалити файл також видаляє його файл з комп’ютера.
• Черги: запускайте та зупиняйте кожну.
• Панель угорі показує загальну швидкість і вільне місце, куди надходять ваші завантаження.

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.

Ваші підключені пристрої

Параметри → Віддалений перераховує підключені пристрої, коли кожен був підключений і коли його востаннє бачили. Виберіть один і натисніть Видалити: йому буде відмовлено в наступному запиті негайно (немає потреби в OK). На телефоні ⋮ → Забути цей пристрій на сторінці робить те саме з цього боку.

Загубили телефон? Видаліть його в Параметрах. Щоб зупинити всіх одразу, зніміть прапорець: нічого більше не слухає.

Де він слухає

• Слухати на: Кожна адреса локальної мережі (за замовчуванням) слухає на кожній приватній адресі комп’ютера (192.168.x.x, 10.x.x.x, 172.16–31.x.x та IPv6 fd…), по черзі, і слідує за ними, коли ви приєднуєтеся до іншої мережі. Тільки цей комп’ютер слухає на 127.0.0.1. Або виберіть одну адресу одного адаптера.
• Порт: 8463, якщо інша програма його не використовує; тоді виберіть інший (від 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.

Безпека

Коротко про те, що забезпечує безпеку віддаленого керування:

• Вимкнено за замовчуванням, і нічого не слухає, поки воно вимкнено.
• Тільки підключені пристрої: кожен запит, крім підключення, потребує токена, який пристрій отримав під час підключення. Код підключення діє один раз, протягом десяти хвилин, з п’ятьма спробами, і спроби сповільнюються. Налаштування зберігають відбиток кожного токена, а не сам токен.
• Your local network only: GDM listens on the computer's private addresses, one by one, never on every address at once.
• Зашифровано: HTTPS, із сертифікатом, створеним на вашому комп'ютері та збереженим; його відбиток знаходиться в параметрах, щоб порівняти з тим, що показує браузер телефону.
• 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.
• Лише завантаження: підключений пристрій перелічує, додає, призупиняє, запускає та видаляє завантаження, а також запускає та зупиняє черги. Він не може змінювати налаштування, відкривати вікна на комп'ютері або переглядати папки (список, який він отримує, не містить шляхів).

Знайшли проблему? Будь ласка, повідомте про неї приватно, як зазначено в SECURITY.md.