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). Firefox nie jest obsługiwany.

Czego potrzebujesz

• Konta Discord na naszym serwerze. Logujesz się tym samym kontem co na ariku.pl.
• Paczki z wydań repozytorium (najnowsze wydanie na górze):
  • Windows:Chrome ariku-radio-<wersja>-windows.zip/ (zEdge instalatorem),
  /
• Linux, macOS i ręczna instalacja:Brave: ariku-radio-<wersja>.zip

Firefox: ariku-radio-firefox-<wersja>.xpi

Rozszerzenia nie ma w Chrome Web Store, więc przeglądarka nie pozwoli go dodać jednym kliknięciem. Instalator robi za Ciebie wszystko, co się da. W przeglądarce zostają 3 kliknięcia.

Instalacja nakrok Windowspo (zkroku: instalatorem)Chrome, Edge, Brave

1. Pobierz plik ZIP i rozpakuj go do folderu, który zostanie na dysku (np. Dokumenty\ariku-radio-<wersja>-windows.zipradio). Przeglądarka wczytuje rozszerzenie z tego folderu, więc go potem nie usuwaj.
2. KliknijOtwórz pobranystronę plikrozszerzeń: prawym
   przyciskiem
3. Chrome: → Wyodrębnij wszystkie… → Wyodrębnij.chrome://extensions
4. WEdge: wypakowanym folderze kliknij dwa razy ZAINSTALUJ.batedge://extensions. Jeśli Windows pokaże „System Windows ochronił ten komputer”, kliknij Więcej informacji → Uruchom mimo to.
5. InstalatorBrave: skopiujebrave://extensions

rozszerzenie do swojego folderu, skopiuje jego ścieżkę do schowka i otworzy stronę rozszerzeń w Chrome (albo w Brave lub Edge, jeśli nie masz Chrome). Tam:

włączWłącz Tryb dewelopera (przełącznik w prawym górnym rogu; w Edge na dole menu po lewej),lewej stronie). kliknijKliknij Załaduj rozpakowane, w okienku wyboru folderu kliknij pasek adresu u góry, wciśnij Ctrl+V i Enter,wskaż potem Wybierzrozpakowany 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ą (F5).instalacją.

Instalacja krok po kroku: Firefox

WypakowanyDodatek foldernie jest jeszcze podpisany przez Mozillę. Wybierz jeden z paczkidwóch możesz potem usunąć. Rozszerzenie leży w %LOCALAPPDATA%\ariku-radio.sposobów:

Instalacja

Na ręcznapróbę (Linux,zwykły macOS,Firefox, inne)do zamknięcia przeglądarki):

1. Pobierz ariku-radio-<wersja>.zip i rozpakuj go do folderu, który zostanie na dysku (np.plik Dokumenty/ariku-radio.xpi). Przeglądarka wczytuje rozszerzenie z tego folderu, więc go potem nie usuwaj.
2. OtwórzWpisz stronęw rozszerzeń:pasku
3. Chrome i Chromium:adresu chrome://extensionsabout:debugging#/runtime/this-firefox

Edge: edge://extensions Brave: brave://extensions Włącz Tryb dewelopera. Kliknij Załaduj rozpakowanetymczasowy dodatek… i wskaż rozpakowanypobrany folderplik. Po ponownym uruchomieniu Firefoksa powtórz kroki 2–3.

Na stałe (ten,Firefox wESR, którymDeveloper leżyEdition albo Nightly):

Wpisz manifest.jsonabout: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 // radio” i odświeżnie otwartepokaże kartyprzycisku 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.

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 (Windows)Chrome/Edge/Brave): pobierz nowąnowy paczkę -windows.zip, wypakuj jąZIP i uruchomrozpakuj ZAINSTALUJ.batgo jeszczew raz.miejsce starego folderu. Potem na stronie rozszerzeń kliknij strzałkę odświeżania przy „ariku.pl // radio”. Przeglądarka nie aktualizuje go sama.
• Aktualizacja (ręczna)Firefox): rozpakujzainstaluj nowy ZIPplik w.xpi miejscetak staregosamo folderujak ipierwszy kliknij strzałkę odświeżania przy rozszerzeniu.raz.
• Odinstalowanie: na stronie rozszerzeń (about:addons w Firefoksie) kliknij Usuń,. aW potemChrome skasuj folderteż (na Windows %LOCALAPPDATA%\ariku-radio).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.