# Muzyka z Orin
Wspólna kolejka muzyki: ariku.pl/music i komendy dla Orin na Discordzie.
# Jak puszczać muzykę
> Źródło: repo afterlife/docs/muzyka/poradnik-rp.md — edytuj w repo, nie tutaj.
# Muzyka z Orin — jak puszczać muzykę na Discordzie
Krrrg... Zapisujemy zasady, według których dźwięki trafiają na kanały głosowe serwera Discord Anvil of Suns. Istnieje jedna wspólna kolejka muzyki dla strony i Discorda, a odtwarza ją Orin, nasza techniczna persona. Zanim utwór wybrzmi, system najpierw szuka go w naszej bibliotece, a czego w niej nie ma, pobiera z YouTube do biblioteki i dopiero wtedy dodaje do kolejki.
## ◈ W skrócie
Dla tych, którzy potrzebują jedynie suchych wytycznych, zebrałyśmy najważniejsze punkty:
1. Musisz być członkiem serwera Discord Anvil of Suns.
2. Wejdź na dowolny kanał głosowy — Orin gra na **kanale głosowym osoby, która dodała utwór**.
3. Dodaj utwór przez stronę https://ariku.pl/music albo napisz do Orin na Discordzie.
4. Jeśli utworu nie ma w naszej bibliotece, poczekaj 1–3 minuty na pobranie go z YouTube i indeksację.
5. Steruj odtwarzaniem za pomocą przycisków na stronie lub komend tekstowych na Discordzie.
## ◈ Na stronie ariku.pl/music
Panel na stronie pozwala szukać w bibliotece i na YouTube oraz sterować kolejką.
1. Wejdź na https://ariku.pl/music. Jeśli nie jesteś zalogowany, zaloguj się przyciskiem „Zaloguj przez Discorda” (np. na https://ariku.pl/?gaming=1) i wróć.
2. Górne pole „szukaj utworu / artysty...” przeszukuje naszą bibliotekę. Przy znalezionym wyniku kliknij „+ kolejka”.
3. W sekcji **YOUTUBE** wpisz frazę albo wklej link do filmu lub playlisty, a następnie kliknij „szukaj”. Przy wybranym wyniku naciśnij „▶ graj”:
- jeśli utwór jest już w bibliotece, trafia od razu do kolejki,
- jeśli go nie ma, pobiera się do biblioteki; status pod wynikami zmienia się kolejno: „pobieram…” → „indeksuję…” → „w kolejce”. Zwykle trwa to 1–3 minuty, ponieważ biblioteka skanuje nowe pliki co minutę.
4. W sekcji „teraz gra” znajdziesz przyciski sterowania: „pauza”, „wznów” oraz „następny”.
5. Sekcja **KOLEJKA** wyświetla listę zaplanowanych utworów. Przycisk „usuń moje” zdejmuje z kolejki Twoje utwory.
## ◈ Na Discordzie przez Orin
Utwory możesz zlecać bezpośrednio przez wiadomości tekstowe. Na kanale `#orin-chat` Orin czyta każdą wiadomość. Na innych kanałach zacznij wypowiedź od „Orin” albo oznacz `@Orin`.
Przykłady dodawania muzyki:
```text
Orin, puść Kavinsky Nightcall
```
Po tym poleceniu Orin szuka utworu najpierw w bibliotece, a potem na YouTube.
```text
Orin, dodaj do playlisty
```
To polecenie dodaje do kolejki konkretny film z podanego adresu.
- Gdy wkleisz link do playlisty z YouTube, Orin zapyta o zakres, wyświetlając przyciski: „Tylko pierwszy” albo „Całą listę (N)”. Z całej listy bierze maksymalnie 50 utworów.
- Gdy utwór musi zostać pobrany, Orin odpisuje na kanale, a po zakończeniu procesu daje znać, że nagranie jest już w kolejce.
Sterowanie odtwarzaniem przez czat:
```text
orin skip
```
Pomija bieżący utwór (możesz też napisać „następny”).
```text
orin pauza
```
Wstrzymuje odtwarzanie.
```text
orin wznów
```
Wznawia wstrzymaną muzykę.
## ◈ Limity i dobre obyczaje
Wspólna kolejka wymaga zachowania porządku, dlatego odnotowujemy obowiązujące ograniczenia i zasady działania:
- Orin gra na **kanale głosowym osoby, która dodała utwór** (może to być dowolny kanał głosowy). Gdy przychodzi kolej Twojego utworu, a nie siedzisz na żadnym kanale głosowym, utwór jest pomijany.
- Obowiązuje limit do 20 pobrań z YouTube na godzinę na osobę.
- Pojedyncze nagranie może trwać do 2 godzin. Transmisje na żywo nie są obsługiwane.
- Z całej playlisty z YouTube dodawanych jest maksymalnie 50 utworów.
- Wszystkie pobrane utwory zostają we wspólnej bibliotece, więc następnym razem grają od razu, bez ponownego pobierania.
## ◈ Gdy coś nie gra
Jeśli dodany utwór nie rozbrzmiewa na kanale, przyczyna leży zazwyczaj w jednym z zapisanych warunków:
| Sytuacja | Wyjaśnienie i rozwiązanie |
|---|---|
| Utwór został pominięty w kolejce | Gdy przyszła kolej Twojego utworu, nie było Cię na żadnym kanale głosowym. Dołącz na dowolny kanał głosowy, zanim nadejdzie Twoja kolej. |
| Utwór z YouTube nie pojawia się od razu | Nagranie nie było wcześniej w bibliotece. Sprawdź status pod wynikami: „pobieram…” → „indeksuję…” → „w kolejce”. Proces trwa zwykle 1–3 minuty, gdyż biblioteka skanuje nowe pliki co minutę. |
| Nie można pobrać kolejnego utworu z YouTube | Wykorzystano limit wynoszący do 20 pobrań z YouTube na godzinę na osobę. Utwory, które są już w bibliotece, nie liczą się do tego limitu. |
| Pobieranie kończy się statusem „błąd” | Nagranie może być dłuższe niż 2 godziny albo być transmisją na żywo. Wybierz inną wersję utworu. |
| Strona https://ariku.pl/music nie pozwala zarządzać kolejką | Nie jesteś zalogowany lub nie należysz do serwera Discord Anvil of Suns. Użyj przycisku „Zaloguj przez Discorda” (np. na https://ariku.pl/?gaming=1) i wróć na stronę muzyki. |
| Orin nie reaguje na wiadomość na Discordzie | Piszesz poza kanałem `#orin-chat` bez odpowiedniego wywołania. Zacznij wiadomość od „Orin” albo oznacz `@Orin`. |
Każda osoba może zlecić do 20 pobrań z YouTube na godzinę, a pojedyncza playlista przekazuje do kolejki maksymalnie 50 utworów, które już na stałe zasilają wspólną bibliotekę. Czyż zasób, który z każdym odsłuchaniem rośnie i nie wymaga ponownego pobierania, nie wystarczy na każdy wieczór?
# 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](https://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.
- Rozszerzenia nie ma w sklepach przeglądarek. Rozdajemy je z naszego
[repozytorium](https://git.ariku.pl/felix/radio-ariku.pl-chromium-plugin/releases).
## 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):
```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:**
```sh
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 install.sh firefox # Firefox
```
Za pierwszym razem dokończ instalację w przeglądarce według instrukcji ze skryptu (to samo,
co kroki 2–5 niżej). Folder do wskazania skrypt kopiuje do schowka.
## Ręcznie: Chrome, Edge, Brave
1. Pobierz `ariku-radio-.zip` z
[wydań](https://git.ariku.pl/felix/radio-ariku.pl-chromium-plugin/releases) 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ą.
## Ręcznie: Firefox
Dodatek nie jest podpisany przez Mozillę. Wybierz jeden z dwóch sposobów:
**Na próbę (zwykły Firefox, do zamknięcia przeglądarki):**
1. Pobierz `ariku-radio-firefox-.xpi` z
[wydań](https://git.ariku.pl/felix/radio-ariku.pl-chromium-plugin/releases).
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.