Jedna lista zamiast trzech aplikacji
Hue, Tuya i Home Assistant działają obok siebie. Pokoje i lampy ze wszystkich hubów widzisz razem.
Wersja 0.4.1 · open source (MIT)
Światło w całym domu, prosto z pulpitu
Lumen Desktop to lekka aplikacja na komputer do sterowania oświetleniem Philips Hue, żarówkami Tuya i wszystkim, co widzi Twój Home Assistant. Jedno okno, pasek menu i skróty klawiszowe — bez sięgania po telefon, bez konta i bez chmury.
Bezpłatna. macOS na Apple Silicon — podpisana i notaryzowana przez Apple. Pakiety dla Windows i Linuksa są budowane, ale jeszcze nieprzetestowane.
Problem
Siedzisz przy komputerze, a światło ustawiasz w telefonie
Żeby przygasić lampę, trzeba odblokować telefon, znaleźć aplikację producenta i poczekać, aż się połączy. A jeśli w domu jest Hue, kilka tańszych żarówek Tuya i Home Assistant do całej reszty — to trzy aplikacje do jednej czynności.
Pod ręką, gdy pracujesz
Okno aplikacji, pasek menu, globalne skróty i widżet macOS — światło zmieniasz bez odrywania się od pracy.
Lokalnie i prywatnie
Aplikacja rozmawia z urządzeniami w Twojej sieci. Nie ma konta ani serwera Lumen, a dane logowania są szyfrowane przez system.
Obsługiwane urządzenia
Trzy drogi do Twoich żarówek
Od najbardziej bezpośredniej: mostek Hue, sama żarówka Tuya albo Twój Home Assistant jako pośrednik dla wszystkich innych marek.
Philips Hue
Przez Hue Bridge v2 w sieci lokalnej. Aplikacja sama znajduje mostek — przez mDNS, usługę wykrywania Hue albo ręcznie wpisany adres IP — a parowanie potwierdzasz przyciskiem na mostku.
Hue API v2 · zmiany na żywoTuya
Bezpośrednio do żarówki, przez sieć lokalną — także marki, które nie mówią, że są Tuya, np. Spectrum Smart. Potrzebny jest klucz lokalny pobrany jeden raz; potem chmura nie jest już używana.
Protokół 3.3 · działa bez internetuHome Assistant
Cała reszta. Jeśli Home Assistant widzi lampę, Lumen też ją zobaczy — wystarczy adres i token długoterminowy. Obszary z Home Assistant stają się pokojami.
WebSocket · każda marka z HAFunkcje
To, czego używasz codziennie — i nic ponad to
Cały dom na jednym ekranie
Pokoje z lampami, sceny i ulubione w jednym miejscu. Włączasz, przyciemniasz, przełączasz. Zmiany zrobione włącznikiem na ścianie, w aplikacji producenta albo głosem pojawiają się od razu.
- Ulubione pokoje, lampy i sceny przypięte na górze
- Szybkie akcje — jedno kliknięcie na to, co robisz najczęściej
- Stan połączenia każdego huba osobno
Pokój jednym ruchem
Włącz lub wyłącz cały pokój, ustaw jasność wszystkich lamp naraz albo wybierz scenę zapisaną na hubie. Pokój dostaje jedno zbiorcze polecenie zamiast osobnego dla każdej żarówki.
- Sceny pogrupowane według pokoi
- Jasność całego pokoju jednym suwakiem
Kontrolki dopasowane do żarówki
Aplikacja pokazuje tylko to, co dana żarówka potrafi. Zwykła biała dostaje włącznik, White Ambiance — także temperaturę barwową, a kolorowa — pełny wybór koloru.
- Jasność od 1 do 100%
- Temperatura barwowa od ciepłej do zimnej
- Kolor z próbnika albo z gotowej palety
Skróty, szybkie akcje i pasek menu
Przypisz globalny skrót klawiszowy do sceny, pokoju albo do „wyłącz wszystko” — działa także wtedy, gdy aplikacja jest w tle. Z paska menu sterujesz ulubionymi bez otwierania okna.
- Globalne skróty klawiszowe
- Przyciski szybkich akcji na ekranie głównym
- Uruchamianie przy logowaniu, od razu do paska menu
Automatyzacje pod kontrolą
Zobacz automatyzacje zapisane na hubie — budzenie światłem, czujnik ruchu, ściemniacz — i wstrzymaj je jednym przełącznikiem, gdy akurat przeszkadzają. Działają na hubie, więc także przy zamkniętej aplikacji.
- Włączanie i wstrzymywanie jednym kliknięciem
- Nowe automatyzacje tworzysz w aplikacji huba
Widżet macOS
Mały i średni rozmiar, w Centrum powiadomień i na biurku. Włącza światło nawet przy zamkniętej aplikacji. Wymaga macOS 14.
Wiele hubów naraz
Każdy hub łączy się niezależnie, więc gdy jeden przestaje odpowiadać, pozostałe działają dalej.
Samo wraca do sieci
Po zerwaniu połączenia aplikacja ponawia próby, a gdy router zmieni adres mostka Hue, odnajduje go po identyfikatorze.
Jasny i ciemny motyw
Zgodnie z ustawieniami systemu albo na stałe — do wyboru w ustawieniach aplikacji.
Jak to działa
Od instalacji do pierwszej lampy w kilka minut
-
Pobierz i zainstaluj
Pobierz plik
.dmgz najnowszego wydania na GitHubie i przenieś Lumen Desktop do folderu Aplikacje. -
Dodaj hub
Wybierz Hue, Home Assistant lub Tuya. Mostek Hue zostanie znaleziony sam — wystarczy nacisnąć na nim przycisk. Dla Home Assistant podajesz adres i token, dla Tuya — klucz lokalny każdego urządzenia.
-
Steruj
Z okna aplikacji, z paska menu, skrótem klawiszowym albo z widżetu. Kolejne huby dodasz w każdej chwili w ustawieniach.
Galeria
Zobacz, jak wygląda
Zrzuty z prawdziwej aplikacji, wypełnionej fikcyjnymi danymi. Motyw jasny lub ciemny wyświetla się zgodnie z ustawieniami Twojego systemu. Interfejs aplikacji jest po angielsku.
Ekran główny Pokój ze scenami Lampa Automatyzacje Ustawienia i huby Szybkie akcje i skróty Dodawanie mostka Hue Dodawanie urządzeń Tuya
Prywatność i bezpieczeństwo
Twoje światło, Twoja sieć
Co zostaje u Ciebie
- Bez chmury i bez konta. Lumen nie ma własnego serwera — łączy się tylko z hubami w Twojej sieci.
- Dane logowania są szyfrowane systemowym sejfem (pęk kluczy w macOS, DPAPI w Windows, magazyn haseł w Linuksie) i nigdy nie trafiają do interfejsu.
- Tuya zostaje w sieci lokalnej. Klucz pobierasz z chmury raz, potem aplikacja już z niej nie korzysta.
Jak chronione jest połączenie
- Mostek Hue jest weryfikowany. Aplikacja ufa wyłącznie certyfikatowi Signify i sprawdza identyfikator mostka — weryfikacji TLS nie wyłączono nigdzie w kodzie.
- Home Assistant przez zwykły, weryfikowany TLS. Certyfikat z podpisem własnym trzeba poprawić po stronie serwera.
- Token Home Assistant nie trafia do widżetu, dopóki sam tego nie włączysz — daje dostęp do całego Home Assistant, nie tylko do świateł.
Zanim pobierzesz
Wymagania i ograniczenia
Czego potrzebujesz
- Hue: Hue Bridge v2 (BSB002) z obsługą Hue API v2 i dostęp do przycisku na mostku przy pierwszym parowaniu.
- Tuya: urządzenie w sieci 2,4 GHz, protokół 3.3 i jego klucz lokalny (instrukcja w README).
- Home Assistant: dostępna instancja, token długoterminowy i lampy przypisane do obszarów.
Dobrze wiedzieć
- Aplikacja jest przetestowana na macOS. Pakiety dla Windows i Linuksa powstają automatycznie, ale nikt ich jeszcze nie uruchamiał.
- Tuya: tylko protokół 3.3, bez scen, pokoi i automatyzacji; w widżecie tylko podgląd.
- Home Assistant nie jest wykrywany automatycznie — adres wpisujesz ręcznie.
- Sterowanie Hue spoza domu jest w planach na wersję 3.
Dla programistów
Otwarty kod, TypeScript od początku do końca
Interfejs nie wie nic o HTTPS, tokenach ani formatach producentów — zna tylko lampy,
pokoje i huby. Obsługa kolejnej marki to jedna implementacja ProviderAdapter
w src/main/providers/, bez zmian w interfejsie.
Stos technologiczny
- Electron
- React 19
- TypeScript
- Vite
- Tailwind CSS 4
- TanStack Query
- Zustand
- Zod
- Vitest
- Swift · WidgetKit
Uruchomienie lokalne
git clone https://github.com/jash90/lumen-desktop.git
cd lumen-desktop
npm install
npm start # tryb deweloperski
npm test # testy (Vitest)
npm run typecheck # TypeScript w trybie strict
npm run make # instalatory w out/make
Wypróbuj Lumen Desktop
Bezpłatnie, bez konta i bez chmury. Podłącz swój pierwszy hub w kilka minut.