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.
• PlikuPaczki 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 z wydań repozytorium.

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 krokna poWindows kroku(z instalatorem)

1. Pobierz ariku-radio-<wersja>-windows.zip.

Kliknij pobrany plik ZIPprawym przyciskiem → Wyodrębnij wszystkie… → Wyodrębnij. 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. Instalator skopiuje rozszerzenie do swojego folderu, skopiuje jego ścieżkę do schowka i rozpakujotworzy gostronę dorozszerzeń folderu,w który zostanie na dyskuChrome (np.albo Dokumenty\ariku-radio).w PrzeglądarkaBrave wczytujelub rozszerzenieEdge, z tego folderu, więc go potemjeśli nie usuwaj.masz Chrome). Tam:

1. Otwórz stronę rozszerzeń:
2. Chrome: chrome://extensions

Edge: edge://extensions Brave: brave://extensions Włączwłącz Tryb dewelopera (przełącznik w prawym górnym rogu; w Edge na dole menu po lewej stronie).lewej), Kliknijkliknij Załaduj rozpakowane, w okienku wyboru folderu kliknij pasek adresu u góry, wciśnij Ctrl+V i wskażEnter, rozpakowanypotem Wybierz 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ą.instalacją (F5).

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

Instalacja ręczna (Linux, macOS, inne)

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. Otwórz stronę rozszerzeń:

Chrome i Chromium: chrome://extensions Edge: edge://extensions Brave: brave://extensions Włącz Tryb dewelopera. Kliknij Załaduj rozpakowane i wskaż rozpakowany folder (ten, w którym leży manifest.json). 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:Aktualizacja (Windows): pobierz nowynową ZIPpaczkę -windows.zip, wypakuj ją i rozpakujuruchom goZAINSTALUJ.bat wjeszcze miejsce starego folderu.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.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.