Skip to main content

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.
  • Paczki z wydań repozytorium:
    • Chrome / Edge / Brave: ariku-radio-<wersja>.zip
    • Firefox: ariku-radio-firefox-<wersja>.xpi

Instalacja krok po kroku: Chrome, Edge, Brave

  1. Pobierz plik ZIP 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ą.

Instalacja krok po kroku: Firefox

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

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

  1. Pobierz plik .xpi.
  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.

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 (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.