phone-deck

एक अतिरिक्त एंड्रॉइड फ़ोन (या ब्राउज़र वाला कोई भी उपकरण) को अपने लिनक्स वर्कस्टेशन के लिए एक स्व-होस्टेड कंट्रोल डेक और रिमोट डेस्कटॉप में बदलें — आपके निजी टेलस्केल नेटवर्क पर, बिना किसी तीसरे पक्ष के ऐप के।

इसकी शुरुआत "पुराने फ़ोन का क्या करूँ?" से हुई और यह एक हाइपरलैंड रिग के लिए एक नियंत्रण प्लेन बन गया: विंडो/वर्कस्पेस नियंत्रण, दृश्य मैक्रो, स्थानीय-एलएलएम सहायक के साथ एक पुश-टू-टॉक वॉइस रूटर, संदर्भ-जागरूक इन-ऐप नियंत्रण, दो-तरफ़ा ऑडियो + स्क्रीन स्ट्रीमिंग, एक टच रिमोट-डेस्कटॉप, एक वर्चुअल कीबोर्ड/माउस, फ़ाइल स्थानांतरण + फ़ोन→PC साझाकरण, और लाइव टेलीमेट्री — सभी एक इंस्टॉल किए गए PWA के रूप में एक फ़ॉस्फ़र-टर्मिनल लुक के साथ परोसा जाता है।

पोर्टेबिलिटी पर ध्यान दें। यह एक विशिष्ट सेटअप के लिए बनाया गया था: Arch-आधारित लिनक्स (Garuda) + Hyprland + PipeWire + NVIDIA + Tailscale, end-4 / illogical-impulse डॉटफ़ाइल्स के साथ। आर्किटेक्चर सामान्य है, लेकिन कई एकीकरण पर्यावरण-विशिष्ट हैं (मॉनिटर नाम, वर्कस्पेस बाइंडिंग, matugen थीम पथ, cpupower/nvidia-smi)। इसे एक तैयार पैकेज के बजाय अनुकूलित करने के लिए कार्यशील संदर्भ मानें।

---

विशेषताएँ

यूआई एक टैब्ड, डार्क, लैंडस्केप वेब ऐप है (आपके डेस्कटॉप से थीम-सिंक):

टैब	यह क्या करता है
वर्कस्पेस	लाइव प्रति-मॉनिटर वर्कस्पेस ग्रिड (स्विच करने के लिए टैप करें), लाइव विंडो सूची (फ़ोकस करने के लिए टैप करें), प्रति-मॉनिटर DPMS टॉगल + ddcutil ब्राइटनेस
रिमोट	ऑन-स्क्रीन ट्रैकपैड (ड्रैग/टैप/दो उंगली) + मॉडिफ़ायर और कॉम्बो के साथ वर्चुअल कीबोर्ड, एक कर्नेल uinput डिवाइस के माध्यम से
मोड	एक-टैप दृश्य मैक्रो — पूरे ऐप लेआउट को मॉनिटरों पर लॉन्च/बंद/व्यवस्थित करें (जैसे "काम" / "खाली")
वॉइस	पुश-टू-टॉक वॉइस रूटर (faster-whisper, CPU): लीड-वर्ड लेन — macro (एक मोड/कमांड चलाएँ), type (डिक्टेट), input (वाक्यांश → की कॉर्ड) — निष्पादित करने से पहले पुष्टि के साथ, साथ ही "friday", एक केवल-पढ़ने के लिए स्थानीय-एलएलएम उत्तरदाता (Ollama + Qwen) जिसमें स्व-होस्टेड वेब खोज और लाइव सिस्टम-स्थिति जागरूकता है
ऑडियो	माइक/स्पीकर म्यूट, वॉल्यूम, आउटपुट और इनपुट डिवाइस पिकर, playerctl ट्रांसपोर्ट + कवर आर्ट (सक्रिय MPRIS प्लेयर को ट्रैक करता है)
स्ट्रीम	द्विदिश WebRTC ऑडियो (PC↔फ़ोन, फ़ोन-एक-माइक और फ़ोन-केवल आउटपुट के साथ) + स्क्रीन वीडियो, और स्ट्रीम की गई स्क्रीन पर नियंत्रण करने के लिए टैप करें = एक वास्तविक रिमोट डेस्कटॉप
सिस्टम	प्रदर्शन-मोड टॉगल, लाइव थीम स्विचिंग, Tailscale स्थिति, शीर्ष प्रक्रियाएँ (मारने के लिए टैप करें), लॉक, NetworkManager पुनरारंभ, सस्पेंड/रीबूट/पावरऑफ़
फ़ाइलें	मॉनिटर का स्क्रीनशॉट लें → फ़ोन पर देखें/डाउनलोड करें; फ़ोन→PC पर एक फ़ाइल ड्रॉप करें
कॉन्फ़िग	फ़ोन से commands.json / modes.json (और संदर्भ/वॉइस) कॉन्फ़िग संपादित करें (JSON-मान्य)

हमेशा ऊपर, टैब के ऊपर — एक संदर्भ पट्टी जो अभी जो हो रहा है उसे सामने लाती है: एक सक्रिय कॉल (म्यूट करें/उस पर जाएँ), मीडिया अब-चल रहा है + ट्रांसपोर्ट, और फ़ोकस किए गए ऐप (YouTube / Brave / Teams) के लिए इन-ऐप कीबोर्ड नियंत्रण, फ़ोकस चुराए बिना वितरित।

दो और, टैब से परे:

• रिग पर भेजें — PWA एंड्रॉइड शेयर लक्ष्य के रूप में पंजीकृत होता है: अपने फ़ोन के किसी भी ऐप से एक छवि, कुछ टेक्स्ट, या एक लिंक साझा करें और यह रिग पर पहुँचता है — छवियाँ एक ड्रॉप निर्देशिका में सहेजी जाती हैं और क्लिपबोर्ड पर पेस्ट-तैयार PNG के रूप में रखी जाती हैं, टेक्स्ट क्लिपबोर्ड पर, एक नंगा लिंक खोला जाता है।
• परिवेश विचारक — कुछ निष्क्रिय मिनटों के बाद डेक एक फ़ॉस्फ़र उपकरण पैनल बन जाता है: पीक-होल्ड के साथ सुई-डायल टेलीमेट्री ("क्या यह दूर रहने पर पीक पर था?"), घड़ी, अब-चल रहा है।

प्लस: ऑन-स्क्रीन नम्पैड PIN लॉगिन, स्क्रीन वेक-लॉक, फ़ुलस्क्रीन लैंडस्केप PWA, और लॉगिन पर ब्रूट-फोर्स लॉकआउट।

---

आर्किटेक्चर

   फ़ोन / लैपटॉप (ब्राउज़र PWA)
            │  HTTPS + WSS  (केवल Tailscale)
            ▼
   tailscale serve  ──►  FastAPI वेब ऐप   ── यूनिक्स सॉकेट ──►  deckd
   (वास्तविक TLS प्रमाणपत्र)       (आपके उपयोगकर्ता के रूप में चलता है)   (कार्य नाम)   (रूट के रूप में चलता है)
                              │                                  │
              hyprctl · pactl · ddcutil · grim ·          निश्चित अनुमति सूची
              wf-recorder · uinput · WebRTC               विशेषाधिकार प्राप्त कमांड
                                                          (cpupower, nvidia-smi,
                                                           systemctl, …)

दो प्रक्रियाएँ:

• app/ — वेब ऐप आपके सामान्य उपयोगकर्ता के रूप में चलता है। यह वह सब कुछ करता है जिसके लिए रूट की आवश्यकता नहीं है: Hyprland नियंत्रण, ऑडियो, चमक, स्क्रीन कैप्चर, वर्चुअल इनपुट, WebRTC स्ट्रीमिंग, फ़ाइल स्थानांतरण।
• deckd/ — एक छोटा रूट सहायक (केवल stdlib, कोई निर्भरता नहीं) कुछ विशेषाधिकार प्राप्त कार्यों के लिए। वेब ऐप इसे कभी शेल स्ट्रिंग नहीं भेजता — केवल एक निश्चित अनुमति सूची से कार्य नाम (governor_performance, gpu_power_limit, suspend, …), जो किसी भी चीज़ को निष्पादित करने से पहले deckd/actions.py में मान्य किया जाता है। यहाँ तक कि अगर वेब ऐप पूरी तरह से समझौता कर लिया गया हो, तो विस्फोट त्रिज्या ठीक अनुमति सूची वाले कार्यों तक सीमित है, जिसमें कोई तर्क इंजेक्शन नहीं है। सॉकेट root:<group> मोड 0660 है।

सुरक्षा मॉडल

• केवल आपके tailnet के अंदर पहुँचा जा सकता है — tailscale serve इसे आपके MagicDNS नाम पर एक वास्तविक Let's Encrypt प्रमाणपत्र के साथ उजागर करता है; यह कभी 0.0.0.0 से बाइंड नहीं होता है।
• JWT लॉगिन (PIN → हस्ताक्षरित कुकी), बार-बार विफलता के बाद एक्सपोनेंशियल-बैकऑफ़ लॉकआउट के साथ।
• विशेषाधिकार प्राप्त कार्य अनुमति सूची वाले सहायक डेमॉन के पीछे पृथक होते हैं।
• अपलोड बेसनाम-सैनिटाइज़ किए जाते हैं (ड्रॉप निर्देशिका से बच नहीं सकते)।

वेब ऐप आपके कॉन्फ़िगर किए गए शेल कमांड चला सकता है और आपके उपयोगकर्ता के रूप में इनपुट इंजेक्ट कर सकता है — यह, डिज़ाइन के अनुसार, आपकी मशीन के लिए एक रिमोट कंट्रोल है। इसे अपने tailnet पर, PIN के पीछे रखें, और इसे सार्वजनिक रूप से उजागर न करें।

---

आवश्यकताएँ

• Hyprland (wlroots), PipeWire (pactl/PulseAudio संगतता के साथ) के साथ लिनक्स
• Python ≥ 3.11 और uv
• Tailscale (आपके tailnet के लिए HTTPS प्रमाणपत्र सक्षम)
• विभिन्न सुविधाओं द्वारा उपयोग किए जाने वाले CLI उपकरण (आप जो उपयोग करना चाहते हैं उसे स्थापित करें): hyprctl, pactl / pw-record / pw-play, playerctl, ddcutil, wf-recorder, grim, cpupower, nvidia-smi, kitty (या आपका टर्मिनल)
• आपका उपयोगकर्ता input समूह में (/dev/uinput के लिए) और i2c समूह में (ddcutil के लिए)
• ऑडियो/वीडियो स्ट्रीमिंग के लिए aiortc + PyAV (uv के माध्यम से स्थापित)

---

स्थापना

git clone <आपका-रेपो-यूआरएल> phone-deck
cd phone-deck
uv sync                          # .venv बनाता है और निर्भरताएँ स्थापित करता है
uv run python -m app.set_pin     # अपना अनलॉक PIN सेट करें

1. रूट सहायक (deckd)

पहले systemd/deckd.service संपादित करें — पथ और DECK_SOCKET_GROUP को एक समूह में सेट करें जिससे आपका उपयोगकर्ता संबंधित है (आमतौर पर आपका प्राथमिक समूह):

sudo cp systemd/deckd.service /etc/systemd/system/
sudo systemctl daemon-reload && sudo systemctl enable --now deckd

deckd सिस्टम Python चलाता है (केवल stdlib — कोई venv आवश्यक नहीं)।

2. वेब ऐप

विकास के लिए इसे सीधे चलाएँ:

uv run uvicorn app.main:app --host 127.0.0.1 --port 8765

…या उपयोगकर्ता सेवा के रूप में। पहले systemd/phone-deck.service पथ संपादित करें, फिर इसे स्थापित करें। महत्वपूर्ण: एक सेटअप पर जहाँ Hyprland uwsm के माध्यम से लॉन्च नहीं किया जाता है, systemd graphical-session.target कभी सक्रिय नहीं होता है, इसलिए उपयोगकर्ता यूनिट लॉगिन पर स्वचालित रूप से प्रारंभ नहीं होगी। विश्वसनीय उपाय यह है कि इसे सत्र वातावरण आयात करते हुए Hyprland से प्रारंभ किया जाए — अपने Hyprland ऑटोस्टार्ट में जोड़ें (जैसे end-4 का ~/.config/hypr/custom/execs.conf):

exec-once = systemctl --user import-environment WAYLAND_DISPLAY HYPRLAND_INSTANCE_SIGNATURE XDG_RUNTIME_DIR DBUS_SESSION_BUS_ADDRESS XDG_CURRENT_DESKTOP && systemctl --user start phone-deck