# Rozszerzenie przeglądarki „ariku.pl // radio” — instalacja

> Źródło: repo radio-ariku.pl-chromium-plugin/docs/wiki/instalacja.md — edytuj w repo, nie tutaj.

# Rozszerzenie „ariku.pl // radio” — instalacja

Rozszerzenie do przeglądarki pozwala wrzucić utwór z YouTube do wspólnej kolejki muzyki
na ariku.pl jednym kliknięciem. Oglądasz kawałek, klikasz **„+ Dodaj do radia”** i Orin
puszcza go na Discordzie, na kanale głosowym osoby, która go dodała. Kolejkę widzisz na
stronie [ariku.pl/music](https://ariku.pl/music).

Działa w Chrome, Edge, Brave i innych przeglądarkach na Chromium (wersja 116 lub nowsza)
oraz w Firefoksie (wersja 140 lub nowsza).

## Czego potrzebujesz

- Konta Discord na naszym serwerze. Logujesz się tym samym kontem co na ariku.pl.
- Rozszerzenia nie ma w sklepach przeglądarek. Rozdajemy je z naszego
  [repozytorium](https://git.ariku.pl/felix/radio-ariku.pl-chromium-plugin/releases).

## Najszybciej: skrypt (instalacja i aktualizacja)

Skrypt pobiera najnowszą wersję, sprawdza sumę kontrolną i kładzie rozszerzenie w stałym
folderze. Potem otwiera stronę rozszerzeń i mówi, co kliknąć. **Ten sam skrypt służy do
aktualizacji**, wystarczy uruchomić go jeszcze raz.

**Windows** (PowerShell):

```powershell
irm https://git.ariku.pl/felix/radio-ariku.pl-chromium-plugin/raw/branch/main/install/install.ps1 -OutFile $env:TEMP\ariku-radio.ps1
powershell -ExecutionPolicy Bypass -File $env:TEMP\ariku-radio.ps1
```

Skrypt sam wykrywa Chrome, Brave, Firefoksa albo Edge. Konkretną przeglądarkę wybierzesz
dopiskiem na końcu drugiej linii: `-Browser firefox` (albo `chrome`, `edge`, `brave`).

**Linux / macOS:**

```sh
curl -fsSLO https://git.ariku.pl/felix/radio-ariku.pl-chromium-plugin/raw/branch/main/install/install.sh
sh install.sh          # Chrome / Chromium / Brave / Edge
sh install.sh firefox  # Firefox
```

Za pierwszym razem dokończ instalację w przeglądarce według instrukcji ze skryptu (to samo,
co kroki 2–5 niżej). Folder do wskazania skrypt kopiuje do schowka.

## Ręcznie: Chrome, Edge, Brave

1. Pobierz `ariku-radio-<wersja>.zip` z
   [wydań](https://git.ariku.pl/felix/radio-ariku.pl-chromium-plugin/releases) i **rozpakuj go**
   do folderu, który zostanie na dysku (np. `Dokumenty\ariku-radio`). Przeglądarka wczytuje
   rozszerzenie z tego folderu, więc go potem nie usuwaj.
2. Otwórz stronę rozszerzeń:
   - Chrome: `chrome://extensions`
   - Edge: `edge://extensions`
   - Brave: `brave://extensions`
3. Włącz **Tryb dewelopera** (przełącznik w prawym górnym rogu; w Edge po lewej stronie).
4. Kliknij **Załaduj rozpakowane** i wskaż rozpakowany folder (ten, w którym leży
   `manifest.json`).
5. Kliknij ikonę puzzla na pasku przeglądarki i **przypnij** „ariku.pl // radio”.
6. Odśwież karty YouTube, które były otwarte przed instalacją.

## Ręcznie: Firefox

Dodatek nie jest podpisany przez Mozillę. Wybierz jeden z dwóch sposobów:

**Na próbę (zwykły Firefox, do zamknięcia przeglądarki):**

1. Pobierz `ariku-radio-firefox-<wersja>.xpi` z
   [wydań](https://git.ariku.pl/felix/radio-ariku.pl-chromium-plugin/releases).
2. Wpisz w pasku adresu `about:debugging#/runtime/this-firefox`.
3. Kliknij **Załaduj tymczasowy dodatek…** i wskaż pobrany plik.
4. Po ponownym uruchomieniu Firefoksa powtórz kroki 2–3.

**Na stałe (Firefox ESR, Developer Edition albo Nightly):**

1. Wpisz `about:config`, wyszukaj `xpinstall.signatures.required` i ustaw na `false`.
2. Wpisz `about:addons`, kliknij koło zębate → **Zainstaluj dodatek z pliku…** i wskaż plik `.xpi`.
3. Zatwierdź instalację.

Potem przypnij ikonę dodatku (ikona puzzla na pasku → „Przypnij do paska narzędzi”).
Jeśli rozszerzenie pokaże **„Zezwól na dostęp”**, kliknij i zaakceptuj. Bez tego nie
połączy się z ariku.pl i nie pokaże przycisku na YouTube.

## Pierwsze połączenie z ariku.pl

1. Kliknij ikonę rozszerzenia. U góry zobaczysz stan połączenia.
2. Jeśli widzisz **„niepołączono”**, kliknij **„Połącz z ariku.pl”** i zaloguj się przez
   Discord.
3. Po zalogowaniu otwórz rozszerzenie jeszcze raz. Powinno pokazywać **„● połączono”**.

Rozszerzenie nie ma osobnego konta ani hasła. Korzysta z Twojego logowania na ariku.pl
i rozmawia wyłącznie z ariku.pl.

## Jak dodawać muzykę

- **Z filmu na YouTube.** Pod filmem, obok nazwy kanału, jest przycisk
  **„+ Dodaj do radia”**. Możesz też kliknąć ikonę rozszerzenia i **„+ Dodaj do kolejki”**.
- **Z wyszukiwarki w rozszerzeniu.** Wpisz tytuł albo wykonawcę. Wybierz
  **„biblioteka”** (to, co już mamy) albo **„YouTube”**.
- **Ze Spotify (opcjonalnie).** Na stronie utworu kliknij
  **„Dopasuj na YouTube i dodaj”**. Na stronie albumu albo playlisty możesz
  zaimportować wiele pozycji i przed dodaniem zatwierdzić te niepewne. Długą playlistę
  najpierw przewiń do końca.

## Sterowanie radiem

W sekcji **radio** w rozszerzeniu są przyciski **⏸ pauza / ▶ wznów** i **⏭ następny**.
Działają tak samo jak na ariku.pl/music i u Orina, więc słyszą je wszyscy na kanale.

Przyciski **⏮ poprzedni**, **⇄ przemieszaj** i **⤴ jako następny** (wstawia utwór na
początek kolejki) czekają na aktualizację ariku.pl. Do tego czasu są wyszarzone, a po
aktualizacji serwera włączą się same.

Utwór z naszej biblioteki trafia do kolejki od razu. Czego nie mamy, to się najpierw
pobiera i dochodzi do kolejki po chwili („⇩ pobieram”).

## Komunikaty i problemy

| Widzisz | Co zrobić |
|---|---|
| „niepołączono” | „Połącz z ariku.pl” i zaloguj się przez Discord |
| „brak połączenia” | sprawdź internet; spróbuj za chwilę |
| „Ten utwór był już dodany przed chwilą” | ochrona przed podwójnym dodaniem; „Dodaj mimo to”, jeśli naprawdę chcesz drugi raz |
| „Poprzednia próba nie dostała odpowiedzi” | zajrzyj do kolejki na ariku.pl/music, zanim dodasz ponownie |
| „Limit pobierania na godzinę” | można pobrać 20 nowych utworów i 3 playlisty na godzinę; utwory z biblioteki się nie liczą |
| „muzyka nieskonfigurowana na ariku.pl” | problem po stronie serwera; daj znać na Discordzie |
| brak przycisku pod filmem | odśwież kartę; sprawdź w ustawieniach rozszerzenia, czy przycisk jest włączony |
| „Zezwól na dostęp” (Firefox) | kliknij i zaakceptuj dostęp do ariku.pl, YouTube i Spotify |
| dodatek zniknął po restarcie (Firefox) | był załadowany tymczasowo; załaduj ponownie albo zainstaluj na stałe (wyżej) |
| ciągle „niepołączono”, choć się logujesz | przeglądarka blokuje ciasteczka ariku.pl; w ustawieniach rozszerzenia wybierz „token urządzenia” i wklej token z ariku.pl/luneta |

## Aktualizacja i odinstalowanie

- **Aktualizacja skryptem:** uruchom skrypt jeszcze raz (te same dwie linie). W Chrome,
  Edge i Brave kliknij potem strzałkę odświeżania przy „ariku.pl // radio” albo zrestartuj
  przeglądarkę.
- **Aktualizacja ręczna (Chrome/Edge/Brave):** pobierz nowy ZIP i rozpakuj go w miejsce starego
  folderu. Potem na stronie rozszerzeń kliknij strzałkę odświeżania przy „ariku.pl // radio”.
- **Aktualizacja (Firefox):** zainstaluj nowy plik `.xpi` tak samo jak pierwszy raz.
- **Odinstalowanie:** na stronie rozszerzeń (`about:addons` w Firefoksie) kliknij **Usuń**.
  W Chrome skasuj też folder.

## Prywatność

Rozszerzenie niczego nie dodaje samo. Każdy utwór trafia do kolejki tylko po Twoim
kliknięciu. Czyta jedynie stronę YouTube albo Spotify, na której jesteś, i to tylko po
to, żeby rozpoznać utwór. Nie ma dostępu do historii przeglądania ani do innych kart.
Nie odtwarza i nie pobiera dźwięku. Grą zajmuje się Orin.