# 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ą.

![Panel muzyki na ariku.pl/music](https://wiki.ariku.pl/uploads/images/gallery/2026-10/muzyka-panel.png)

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

![Wyniki z YouTube z przyciskiem graj](https://wiki.ariku.pl/uploads/images/gallery/2026-10/muzyka-youtube.png)

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 <link z YouTube> 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?