From 863a2363c175d7cda7d08ce2c4ee173b0b0b556a Mon Sep 17 00:00:00 2001 From: firat Date: Sat, 1 Aug 2026 22:46:17 +0200 Subject: [PATCH] Document supported DAAK NODE Android client --- README.md | 11 ++++++++--- docs/android-client.md | 39 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+), 3 deletions(-) create mode 100644 docs/android-client.md diff --git a/README.md b/README.md index 4d70b9c..826a1ef 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,7 @@ menü çubuğu uygulaması. - Uygulama içindeki ayarlardan anında dil değiştirme - GitHub sürümlerinden güvenli ve otomatik güncelleme - Tailscale ağındaki Mac'ler arasında otomatik eşitleme +- DAAK NODE üzerinden Android'de notları görme ve hızlı not/görev ekleme - Hesap, reklam ve harici bulut servisi olmadan yerel saklama ## İndir @@ -44,8 +45,12 @@ açın. Uygulama çevrimiçi Mac'leri 20 saniyede bir bulur ve `45831/TCP` üzer iki yönlü eşitler. Eşitleme servisi yalnızca Tailscale'in `100.64.0.0/10` ve -`fd7a:115c:a1e0::/48` adreslerinden gelen bağlantıları kabul eder. Mevcut sürüm -Windows, Linux, iPhone veya Android istemcileriyle eşitleme yapmaz. +`fd7a:115c:a1e0::/48` adreslerinden gelen bağlantıları kabul eder. Resmî Android +istemcisi [DAAK NODE](https://github.com/benfirad/firat-node) notları okuyabilir, +hızlı kayıt oluşturabilir ve açıkça görev belirten WhatsApp bildirimlerini kullanıcı +tarafından kapatılabilen bir kuralla görev listesine ekleyebilir. Mesaj gönderme +yetkisi yoktur. Kurulum ve güvenlik ayrıntıları için +[Android istemci rehberine](docs/android-client.md) bakın. Uygulama ile widget verileri, Apple takımına bağlı güvenli ortak uygulama grubunda tutulur. Eski sürümdeki yerel veriler ilk açılışta otomatik taşınır. @@ -83,7 +88,7 @@ Proje açık geliştirmeye açıktır. Hata bildirimi, fikir ve pull request'ler memnuniyetle karşılanır. Başlamadan önce [katkı rehberini](CONTRIBUTING.md) okuyabilirsiniz. -Özellikle Intel Mac paketi ve Windows/Linux/iPhone/Android istemcileri için +Özellikle Intel Mac paketi ve Windows/Linux/iPhone istemcileri için katkılar değerlidir. ## Lisans diff --git a/docs/android-client.md b/docs/android-client.md new file mode 100644 index 0000000..1361fff --- /dev/null +++ b/docs/android-client.md @@ -0,0 +1,39 @@ +# Android support with DAAK NODE + +DAAK NODE is the supported Android companion for daakREMEMBER. It talks to the +existing TailSync service over TCP 45831 and keeps the Mac as the canonical +store. The Android client can: + +- read active notes from `GET /snapshot`; +- add a note by merging the updated item set through `POST /merge`; +- queue a note locally while the Mac is offline and retry later; +- turn explicit task-like WhatsApp notification text into a pending note when + the user leaves that automation enabled. + +## Network and privacy model + +Both devices must be on the same private Tailscale network. TailSync rejects +connections whose source address is outside Tailscale's IPv4 and IPv6 ranges. +Do not forward port 45831 from a router and do not publish it through a public +reverse proxy. + +The Android launcher contains no Tailnet address, password, SSH key or API key. +Host names are loaded from a local `config.properties` file. WhatsApp support +uses only notification text already displayed by Android, stores at most a +small recent task list, and cannot send or modify messages. + +## DAAK NODE setup + +1. Install and sign in to Tailscale on Android and the Mac. +2. Keep daakREMEMBER running on the Mac. +3. Create `/sdcard/Download/daak-node/config.properties` on Android: + + ```properties + mac_host=your-mac.tailnet.example + remember_host=your-mac.tailnet.example + ``` + +4. Open **REMEM** on the DAAK NODE home screen to view or capture a note. + +The legacy `/sdcard/Download/firat-node/config.properties` location remains a +compatibility fallback for existing installations.