Problemy

1. Czy aplikacja działa? Sprawdź ikonę w zasobniku systemowym, obok zegara Windowsa. Jeśli jej nie ma, aplikacja nie wystartowała.
2. Czy najeżdżasz w odpowiednie miejsce? Strefa reakcji to środek górnej krawędzi, domyślnie 400 pikseli szerokości. Nie róg, nie bok.
3. Czy kursor jest wystarczająco blisko krawędzi? Domyślnie 6 pikseli. Przy dużej rozdzielczości i skalowaniu Windowsa łatwo tego nie trafić — zwiększ revealTriggerHeightPx.
4. Wiele monitorów. Nakładka pojawia się na monitorze głównym. Sprawdź, który monitor jest ustawiony jako główny w ustawieniach ekranu Windowsa.

Jeśli trudno trafić, poszerz strefę w config.json:

"behavior": {
  "revealZoneWidthPx": 600,
  "revealTriggerHeightPx": 10
}

Zegar i media działają, a panel pogody jest pusty albo pokazuje błąd.

1. Brak klucza API. Sprawdź, czy w config.json nie została wartość YOUR_OPENWEATHERMAP_API_KEY.
2. Klucz jeszcze nie działa. Świeżo wygenerowany klucz OpenWeatherMap aktywuje się od kilkunastu minut do dwóch godzin. Poczekaj.
3. Zła nazwa miasta. Podawaj po angielsku, tak jak rozpoznaje ją OpenWeatherMap: Warsaw, nie Warszawa. Można doprecyzować krajem: "Warsaw,PL".
4. Przekroczony limit zapytań. Jeśli ustawiłeś refreshIntervalMinutes bardzo nisko, darmowy plan mógł zostać zablokowany. Wróć do 15 minut.
5. Brak internetu albo firewall. Aplikacja łączy się z api.openweathermap.org.

Gdy nakładka jest schowana, powinna przepuszczać kliknięcia. Jeśli tak się nie dzieje:

1. Sprawdź, czy nakładka faktycznie jest schowana — czy nie została rozwinięta i nie zapomniałeś jej zamknąć.
2. Zwiększ hideDelayMs, jeśli chowa się zbyt wolno i łapie kliknięcia po drodze.
3. Zrestartuj aplikację z menu w zasobniku.

Panel mediów korzysta z systemowego mechanizmu Windowsa. Nie każdy odtwarzacz go obsługuje.

• Działa: Spotify, przeglądarki (YouTube, YouTube Music), Groove, większość nowoczesnych aplikacji.
• Może nie działać: starsze odtwarzacze, aplikacje bez integracji z systemem, niektóre emulatory.

Szybki test: wciśnij klawisz multimedialny „pauza" na klawiaturze. Jeśli Windows nie pokazuje własnego okienka z tytułem utworu, nakładka też go nie zobaczy.

Prawie zawsze błąd w config.json.

Najczęstsze pomyłki w JSON-ie:

• przecinek po ostatnim polu obiektu,
• pojedyncze cudzysłowy zamiast podwójnych,
• pojedynczy backslash w ścieżce ("C:\Users\..." zamiast "C:\Users\...").

Wklej plik do walidatora JSON — pokaże, w której linii jest problem. W ostateczności skasuj config.json i skopiuj świeży z config.example.json.

Kolory podaje się jako HEX z hashem i sześcioma znakami: "#A78BFA". Nie działają nazwy ("purple"), skrócony zapis ("#ABC") ani rgb().

panelOpacity to liczba od 0 do 1, nie procent — 0.85, nie 85.

Po zmianie odśwież aplikację z menu w zasobniku.