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.

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.

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):

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:

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

Pobierz ariku-radio-<wersja>.zip z wydań 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.
Otwórz stronę rozszerzeń:
- Chrome: chrome://extensions
- Edge: edge://extensions
- Brave: brave://extensions
Włącz Tryb dewelopera (przełącznik w prawym górnym rogu; w Edge po lewej stronie).
Kliknij Załaduj rozpakowane i wskaż rozpakowany folder (ten, w którym leży manifest.json).
Kliknij ikonę puzzla na pasku przeglądarki i przypnij „ariku.pl // radio”.
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):

Pobierz ariku-radio-firefox-<wersja>.xpi z wydań.
Wpisz w pasku adresu about:debugging#/runtime/this-firefox.
Kliknij Załaduj tymczasowy dodatek… i wskaż pobrany plik.
Po ponownym uruchomieniu Firefoksa powtórz kroki 2–3.

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

Wpisz about:config, wyszukaj xpinstall.signatures.required i ustaw na false.
Wpisz about:addons, kliknij koło zębate → Zainstaluj dodatek z pliku… i wskaż plik .xpi.
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

Kliknij ikonę rozszerzenia. U góry zobaczysz stan połączenia.
Jeśli widzisz „niepołączono”, kliknij „Połącz z ariku.pl” i zaloguj się przez Discord.
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.