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). 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: ariku-radio-<wersja>-windows.zip (z instalatorem),
  • Linux, macOS i ręczna instalacja: ariku-radio-<wersja>.zip.

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 na Windows (z instalatorem)

1. Pobierz ariku-radio-<wersja>-windows.zip.
2. Kliknij pobrany plik prawym przyciskiem → Wyodrębnij wszystkie… → Wyodrębnij.
3. W wypakowanym folderze kliknij dwa razy ZAINSTALUJ.bat. Jeśli Windows pokaże „System Windows ochronił ten komputer”, kliknij Więcej informacji → Uruchom mimo to.
4. Instalator skopiuje 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:
   1. włącz Tryb dewelopera (przełącznik w prawym górnym rogu; w Edge na dole menu po lewej),
   2. kliknij Załaduj rozpakowane,
   3. w okienku wyboru folderu kliknij pasek adresu u góry, wciśnij Ctrl+V i Enter, potem Wybierz folder.
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ą (F5).

Wypakowany folder z paczki możesz potem usunąć. Rozszerzenie leży w %LOCALAPPDATA%\ariku-radio.

Instalacja ręczna (Linux, macOS, inne)

1. Pobierz ariku-radio-<wersja>.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 i Chromium: chrome://extensions
   • Edge: edge://extensions
   • Brave: brave://extensions
3. Włącz Tryb dewelopera.
4. Kliknij Załaduj rozpakowane i wskaż rozpakowany folder (ten, w którym leży manifest.json).
5. Przypnij „ariku.pl // radio” i odśwież otwarte karty 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
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): pobierz nową paczkę -windows.zip, wypakuj ją i uruchom ZAINSTALUJ.bat jeszcze raz. Potem na stronie rozszerzeń kliknij strzałkę odświeżania przy „ariku.pl // radio”. Przeglądarka nie aktualizuje go sama.
• Aktualizacja (ręczna): rozpakuj nowy ZIP w miejsce starego folderu i kliknij strzałkę odświeżania przy rozszerzeniu.
• Odinstalowanie: na stronie rozszerzeń kliknij Usuń, a potem skasuj folder (na Windows %LOCALAPPDATA%\ariku-radio).

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.