Twój dom. Twoje zasady. on NQ2

NQ2 Local 1.0.0

Sat, 24 Oct 2026 00:00:00 +0200

NQ2 to główna aplikacja działająca lokalnie na Twoim urządzeniu. Paczka jest uniwersalna: przed uruchomieniem aplikacji zainstaluj zależności z package.json na docelowym urządzeniu.

Pobieranie

NQ2 1.0.0

Pobierz NQ2 · ZIP

Rozmiar pliku: 0,64 MB (640 724 bajtów)

Sprawdź pobrany plik

SHA-256: 1ba21f25b09ba3d7461e60516216cb9ab2e681e7df2fbf733260eeb77448fe5f

Pobierz plik sumy kontrolnej

Do automatycznego pobierania użyj najnowszego ZIP-a NQ2. JSON najnowszego wydania zawiera version, released_at (datę wydania w formacie YYYY-MM-DD), adresy pobierania, rozmiar w bajtach. Te adresy aktualizują się po wdrożeniu strony; karta pobierania powyżej zawsze prowadzi do wersji 1.0.0.

Podstawowe pojęcia: od dostawców do kart

Tue, 27 Oct 2026 00:00:00 +0100

Strefy i podstrefy

Strefy porządkują instalację według lokalizacji. W mieszkaniu mogą to być salon, kuchnia i łazienka; w większej posesji — dom i ogród, a niżej piętra i pomieszczenia.

Dostawcy i urządzenia

Dostawca (provider) to jedna instancja integracji, np. Zigbee2MQTT lub Sonos2MQTT. Najpierw sparuj lub skonfiguruj urządzenia w interfejsie tej aplikacji. Następnie dostawca udostępnia urządzenia, a Ty wybierasz, które zarejestrować w NQ2. Możesz używać kilku instancji tego samego dostawcy.

Karty

Karty to codzienny interfejs. Karta może reprezentować część urządzenia, kilka urządzeń razem albo działać bez fizycznego sprzętu. Jedna karta bramy może łączyć kamerę, kontaktron i przekaźnik; osobne karty temperatury i wilgotności mogą korzystać z jednego multisensora.

NQ2 Installer

Sun, 25 Oct 2026 00:00:00 +0200

Ten ZIP zawiera instalator, a nie gotowy obraz systemu i nie samą aplikację. Pobierz go, rozpakuj cały folder nq2-installation i wybierz instrukcję odpowiednią dla swojej sytuacji.

NQ2 installer

Pobierz instalator · ZIP

Rozmiar pliku: 0,11 MB (114 824 bajtów)

Sprawdź pobrany plik

SHA-256: 243deb95f43eebc431feae2a78d753c8ff5a9fe705e522da799d53f6d9b4b4d7

Pobierz plik sumy kontrolnej

W pakiecie są config.yaml, wspólny katalog core, skrypty windows, ubuntu i raspbian oraz instrukcje PL/EN w docs. Komentarze konfiguracji są po angielsku. Katalogi deweloperskie tests, tools i dist nie są potrzebne i nie są dołączone.

Jak dodawać treści do bazy wiedzy

Tue, 29 Sep 2026 00:00:00 +0200

Każdy artykuł jest plikiem Markdown w content/en/ (angielski) lub content/pl/ (polski). Nazwy katalogów i plików są zawsze po angielsku. Wybierz sekcję, dodaj obie wersje materiału i wyślij zmianę na gałąź master.

Wybierz sekcję

Katalog	Co tu umieszczać
`docs/`	Instrukcje obsługi i konfiguracji aplikacji
`integrations/`	Opisy API, połączeń i wymiany danych
`snippets/`	Krótkie, gotowe fragmenty kodu
`scripts/`	Kompletne skrypty z konfiguracją i instrukcją użycia
`apps/`	Wydania aplikacji do pobrania i samodzielnej instalacji
`blog/`	Wpisy, aktualności i notatki z rozwoju

Utwórz artykuł

Dodaj katalogi content/en/docs/my-guide/ i content/pl/docs/my-guide/, a w każdym plik index.md. Identyczna ścieżka pozwala Hugo połączyć tłumaczenia. Polska wersja może zaczynać się tak:

Instalacja NQ2

Sun, 25 Oct 2026 00:00:00 +0200

Wybierz ścieżkę pasującą do urządzenia. Pakiet instalatora zawiera skrypty dla różnych platform i wspólny config.yaml. ZIP aplikacji zawiera samo NQ2 — to dwa różne pliki do pobrania.

Ścieżka 1: świeża karta Raspberry Pi

Skorzystaj z instrukcji Raspberry Pi z 16 zrzutami ekranu. Nagraj Raspberry Pi OS Lite (64-bit) w Raspberry Pi Imagerze, ustaw tam konto i sieć, a następnie na komputerze z Windows uruchom windows/raspianimager.cmd, aby dodać instalator pierwszego uruchomienia. Dopiero potem wysuń kartę i włącz Raspberry Pi.

Raspberry Pi: instalacja ze skryptem

Sun, 25 Oct 2026 00:00:00 +0200

Ta ścieżka przygotowuje nową kartę na komputerze z Windows, a aplikacje instaluje podczas pierwszego uruchomienia Raspberry Pi. Potrzebujesz Pi obsługującego system 64-bit, karty microSD z miejscem na system i aplikacje, czytnika, zasilacza oraz internetu dla komputera i Pi. Zrzuty pokazują interfejs Imagera po angielsku; ich opisy są po polsku.

Jeśli masz już działający system, przejdź do instalacji na istniejącym systemie. Jeśli przygotowujesz kartę na macOS lub Linuksie, nagraj system Imagerem, uruchom Pi i użyj tam skryptu przez SSH; nie uruchamiaj .cmd na tych platformach.

Instalacja na istniejącym systemie

Sun, 25 Oct 2026 00:00:00 +0200

Wybierz tę metodę, gdy system docelowy jest już zainstalowany i możesz się do niego zalogować. Nie nagrywasz karty ponownie i nie uruchamiasz kreatora przygotowania karty. Jeśli wolisz pojedyncze polecenia, przejdź do ręcznej instalacji w Linuksie.

Pobierz i wybierz system docelowy

NQ2 installer

Pobierz NQ2 · ZIP

Rozmiar pliku: 0,11 MB (114 824 bajtów)

Sprawdź pobrany plik

SHA-256: 243deb95f43eebc431feae2a78d753c8ff5a9fe705e522da799d53f6d9b4b4d7

Pobierz plik sumy kontrolnej

Rozpakuj cały folder nq2-installation. Zachowaj razem core, config.yaml i foldery platform. config.yaml jest wspólny dla wszystkich skryptów; ma angielskie komentarze, a kreator działa w EN lub PL.

Ręczna instalacja NQ2 w Linuksie

Sun, 25 Oct 2026 00:00:00 +0200

Wykonaj kroki samodzielnie zamiast uruchamiania instalatora NQ2. Zestaw poleceń odpowiada aktualnej konfiguracji pakietu instalatora: NQ2 latest i Zigbee2MQTT 2.14.2.

Kolejność: zależności → NQ2 → Nginx → Mosquitto → Zigbee2MQTT. NQ2 i zależności są obowiązkowe. Nginx, Mosquitto i Zigbee2MQTT są opcjonalne, domyślnie włączone. Pomiń sekcję oznaczoną „opcjonalnie”, jeśli nie chcesz danego komponentu. Bez Nginx użyj portu 8080. Bez Mosquitto użyj istniejącego brokera i wpisz jego adres oraz dane w konfiguracji Zigbee2MQTT. Zależności wspólne (Node.js, PM2, Corepack i narzędzia kompilacji) instalujesz na początku; zależności npm i kompilację Zigbee2MQTT wykonujesz po jego pobraniu na końcu.

Stabilne Wi-Fi na Raspberry Pi

Wed, 28 Oct 2026 00:00:00 +0100

Jeśli NQ2 lub SSH przestaje odpowiadać po okresie bezczynności urządzenia połączonego przez Wi-Fi, wyłącz oszczędzanie energii Wi-Fi na Raspberry Pi. Przy niektórych zestawach sprzętu i sterownika może ono przyczyniać się do okresowego zrywania połączenia. Pi może nadal działać, mimo że wygląda na niedostępne: utrata Wi-Fi nie oznacza wyłączenia całego urządzenia.

Dla serwera NQ2 połączonego przez Wi-Fi ustaw to podczas instalacji. Aktualny instalator NQ2 robi to automatycznie w Linuksie korzystającym z NetworkManagera. Przy instalacji ręcznej lub na urządzeniu przygotowanym starszym pakietem wykonaj kroki poniżej. Komputer nagrywający kartę nie potrzebuje tej zmiany; wykonujesz ją na Raspberry Pi lub serwerze Linux, na którym działa NQ2.

Sprawdzanie aktualizacji aplikacji

Wed, 28 Oct 2026 00:00:00 +0100

Najnowsza wersja i zmiany

Pobierz informacje o najnowszej wersji NQ2 Local:

GET /api/apps/nq2-local/latest-version

Odpowiedź to JSON ze statusem HTTP 200 i Content-Type: application/json.

Pole	Znaczenie
`application`	Identyfikator aplikacji, obecnie `nq2-local`
`version`	Najwyższa opublikowana stabilna wersja liczbowa, np. `1.0.1`
`released_at`	Data wydania w formacie `YYYY-MM-DD`
`changelog.en`, `changelog.pl`	Listy zmian po angielsku i po polsku
`download_url`	Adres pobierający zawsze najnowszą paczkę
`archive_url`	Adres archiwum tej konkretnej wersji
`release_notes_url`	Strona wydania z opisem
`size`	Rozmiar archiwum w bajtach
`sha256`	Suma kontrolna SHA-256 archiwum

Odpowiedź opisuje najnowszą dostępną wersję. Nie zna wersji zainstalowanej: aplikacja kliencka porównuje trzy liczbowe składniki numeru. Na przykład 1.10.0 jest nowsze od 1.9.0. W polskim interfejsie użyj changelog.pl.

Dlaczego NQ2 łączy aplikacje

Tue, 27 Oct 2026 00:00:00 +0100

Jedna codzienna czynność, kilka aplikacji

Wyobraź sobie naciśnięcie przycisku Zigbee, które uruchamia muzykę na głośniku Sonosa. Parowanie przycisku należy do Zigbee2MQTT. Układanie playlisty — do aplikacji muzycznej. Połączenie naciśnięcia z odtwarzaniem to zadanie integratora.

To idea NQ2: zapewnić codziennym elementom sterowania wspólne miejsce, zachowując przydatność wyspecjalizowanych aplikacji.

Karty łączą różne światy

Karta nie jest przypisana do jednego fizycznego urządzenia. Karta bramy może łączyć kamerę, czujnik i przekaźnik. Osoba, która z niej korzysta, widzi potrzebną czynność, a nie granice między integracjami.

NQ2 Local 1.0.1

Mon, 26 Oct 2026 00:00:00 +0100

Zmiany

Aktualizator korzysta teraz z API przypisanego do aplikacji.
Zaktualizowane API Local i interfejs WWW.
Zaktualizowane integracje Sun i Zigbee2MQTT.
Zaktualizowany skrypt utility-wait.

Pobieranie

NQ2 1.0.1

Pobierz NQ2 · ZIP

Rozmiar pliku: 0,65 MB (647 426 bajtów)

Sprawdź pobrany plik

SHA-256: 4ef3c2d062eb2a1ad53a113c5fc07fa72fba7b5e02b95cf4c066b633c27e6d74

Pobierz plik sumy kontrolnej

Wersja: 1.0.1. Ten plik zawsze wskazuje konkretne wydanie. Automatyczne instalacje mogą korzystać z najnowszej paczki i metadanych wydania.

Zawartość paczki

Zbudowane API Local i interfejs WWW, bez node_modules i prywatnych plików .env.
Puste katalogi bazy danych i definicji, z wyjątkiem plików README.
Integracje Sun i Zigbee2MQTT oraz jawnie dozwolone publiczne skrypty.

Instalacja

Rozpakuj ZIP, wejdź do jego katalogu, wykonaj npm install, a następnie npm start. Zmień początkowe dane administratora przed udostępnieniem aplikacji. Zobacz instalację ręczną.

Formatowanie daty po polsku

Tue, 29 Sep 2026 00:00:00 +0200

Intl.DateTimeFormat pozwala formatować daty bez dodatkowych bibliotek.

Kod

const formatDate = new Intl.DateTimeFormat('pl-PL', {
 dateStyle: 'long',
 timeZone: 'Europe/Warsaw',
});

formatDate.format(new Date('2026-09-29T12:00:00Z'));
// „29 września 2026”

Kiedy używać

Jawna strefa czasowa daje spójny wynik niezależnie od ustawień urządzenia. Wartość wejściową przekazuj jako datę ISO z informacją o strefie, np. z końcówką Z dla UTC.

Jak opisać integrację

Tue, 29 Sep 2026 00:00:00 +0200

To przewodnik redakcyjny. Nie opisuje istniejącego API NQ2 — konkretne adresy, parametry i wymagania uzupełnij na podstawie wdrażanej integracji.

Cel i wymagania

Opisz, jakie dane przepływają między aplikacją a usługą, w którym kierunku i kiedy. Podaj wymaganą wersję aplikacji oraz uprawnienia konta.

Konfiguracja

Wymień pola ustawień i ich znaczenie. W przykładach stosuj wartości zastępcze, np. YOUR_TOKEN, zamiast rzeczywistych sekretów.

Przykładowe żądanie i odpowiedź

Dodaj minimalny przykład, który można odtworzyć. Określ metodę HTTP, ścieżkę, format danych i spodziewany kod odpowiedzi. Jeżeli dołączasz konfigurację, umieść ją obok tego pliku Markdown i dodaj odnośnik.

Jedno miejsce na wiedzę o NQ2

Tue, 29 Sep 2026 00:00:00 +0200

Baza wiedzy NQ2 powstała po to, aby instrukcje, przykłady i ustalenia miały swoje stałe miejsce.

Co tu znajdziesz

Dokumentacja — instrukcje i opisy działania aplikacji.
Integracje — materiały o łączeniu aplikacji z usługami.
Snippety — krótkie fragmenty kodu do ponownego użycia.
Blog — aktualności i notatki z rozwoju.

Pierwsze materiały pokazują sposób dodawania treści. Dokumentację konkretnych funkcji będziemy uzupełniać wraz z rozwojem aplikacji.

Wiedza zapisana w Markdown

Każdy materiał to zwykły plik tekstowy, który można edytować lokalnie lub w GitHubie. Historia zmian pozostaje w repozytorium, a wysłanie zmian na master uruchamia publikację strony.

Dom, który działa wspólnie.

Mon, 01 Jan 0001 00:00:00 +0000

Jedno centrum sterowania, dedykowane aplikacje

NQ2 łączy niezależne aplikacje przez MQTT i HTTP. Karty służą do codziennych czynności, a dedykowane aplikacje obsługują szczegóły: parowanie urządzeń Zigbee, przeglądanie biblioteki Sonosa czy nagrań z kamer.

Instancja integracji to dostawca (provider). Udostępnia urządzenia, które wybierasz do rejestracji w NQ2. Kilka instancji tego samego dostawcy może obsługiwać różne części instalacji.

Karty opisują to, czym chcesz sterować

Karta może łączyć kilka urządzeń, pokazywać część jednego urządzenia albo działać bez fizycznego sprzętu. Karta bramy może zbierać kamerę Reolink, kontaktron Zigbee i przekaźnik od innego dostawcy. Strefy i podstrefy porządkują instalację według pomieszczeń, pięter lub budynków.

Porozmawiajmy o Twoim domu.

Mon, 01 Jan 0001 00:00:00 +0000

Łączysz pierwsze urządzenie czy planujesz większą instalację? Napisz, czego potrzebujesz.