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.
  • PaczkiRozszerzenia nie ma w sklepach przeglądarek. Rozdajemy je z naszego wydań 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 Brave:install.sh ariku-radio-<wersja>firefox  # Firefox

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

    Firefox:Folder ariku-radio-firefox-<wersja>.xpido wskazania skrypt kopiuje do schowka.

    Instalacja krok po kroku:Ręcznie: Chrome, Edge, Brave

    1. Pobierz plikariku-radio-<wersja>.zip ZIPz 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.
    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:Ręcznie: 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 ariku-radio-firefox-<wersja>.xpi z wydań.
    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.