1 Przegląd — Trzy tryby

Stemly Lyrics został zbudowany wokół trzech dedykowanych zakładek, każda zaprojektowana dla konkretnego etapu pracy:

2 Biblioteka — Teksty, nuty PDF i reorder

Zakładka Biblioteka to centralna baza danych. Lewy panel zawiera listę wszystkich utworów, prawy panel wyświetla tekst lub nuty PDF. Stemly Lyrics używa dwóch stałych domyślnych folderów wewnątrz aplikacji — nie trzeba niczego wybierać.

Lyrics — txt i rtf Edytowalne pliki tekstowe RTF lub TXT. Aplikacja automatycznie skanuje folder Lyrics i dopasowuje pliki do tytułów.

PDF Scores Nuty PDF tylko do odczytu z folderu PDF Scores. Strony renderowane są jako obrazy w wysokiej rozdzielczości.

• Dodaj utwór — naciśnij pomarańczowy przycisk + i wpisz tytuł, lub zeskanuj folder by zaimportować wszystkie pasujące tytuły automatycznie.
• Edytuj tekst — wybierz utwór, naciśnij czerwoną ikonkę ołówka by otworzyć edytor. Zmiany są zapisywane w formacie RTF.
• Zmień nazwę lub usuń utwór — naciśnij ikonkę ołówka obok zaznaczonego tytułu na liście w prawym panelu.
• Zmiana kolejności piosenek — naciśnij przycisk Reorder ↑↓ w nagłówku listy piosenek. Przeciągnij piosenki za uchwyt by zmienić kolejność. Nowa kolejność zapisuje się automatycznie.
• Zmiana kolejności nut PDF — gdy aktywna jest setlista PDF, naciśnij przycisk Reorder w nagłówku panelu PDF i przeciągnij nuty by zmienić ich kolejność.
• Inteligentny filtr setlisty — podwójne stuknięcie dowolnej setlisty w zakładce Setlista przenosi bezpośrednio do Biblioteki z odfiltrowaną zawartością tej setlisty w prawym panelu. Nagłówek wyświetla nazwę setlisty i przycisk × do wyczyszczenia filtra.

3 Setlista — Dwie niezależne sekcje

Zakładka Setlista została przeprojektowana — dwa stałe kafelki są zawsze widoczne na górze: LYRICS i PDF. Obie sekcje są całkowicie niezależne: setlisty LYRICS zawierają piosenki z tekstami, setlisty PDF zawierają nuty. Nie ma nawigacji „wstecz” — oba kafelki są widoczne przez cały czas.

Integracja z Biblioteką: Podwójne stuknięcie dowolnej setlisty otwiera Bibliotekę automatycznie w odpowiednim trybie (setlista LYRICS → panel tekstów, setlista PDF → panel nut PDF) z odfiltrowaną zawartością tej setlisty. Nagłówek Biblioteki wyświetla nazwę setlisty i przycisk × do wyczyszczenia filtra.

Wygląd: Każda setlista otrzymuje automatycznie kolor akcentu (pomarańczowy, niebieski, zielony, fioletowy, czerwony, morski lub żółty). Karty setlist pokazują kolorowe lewe obramowanie, znacznik LIVE przy aktywnej oraz liczbę utworów. Piosenki wyświetlane są jako zaokrąglone kafelki z numerowanym kołem w kolorze setlisty.

• Utwórz setlistę LYRICS — naciśnij + pod kafelkiem LYRICS i wpisz nazwę (np. “Piątkowy koncert”). Kolor zostanie przypisany automatycznie.
• Utwórz setlistę PDF — naciśnij + pod kafelkiem PDF i wpisz nazwę. Setlisty PDF są całkowicie oddzielone od setlist tekstów.
• Dodaj utwory — po wybraniu setlisty naciśnij + w prawym panelu. Otworzy się lista wszystkich utworów z Biblioteki. Naciśnij tytuł by dodać; dodane są zaznaczone ptaszkiem.
• Zmień kolejność — przeciągnij kafelek za uchwyt po prawej stronie by zmienić kolejność występów. Zmiany zapisują się automatycznie.
• Zmień nazwę lub usuń setlistę — przytrzymaj kartę setlisty by otworzyć menu kontekstowe, a następnie wybierz Zmień nazwę lub Usuń.
• Ustaw jako aktywną — naciśnij Set Active by ta setlista była używana w trybie Stage. Aktywna setlista ma znacznik LIVE.
• Przejdź do Stage — naciśnij ciemny przycisk Stage w prawym panelu by przejść bezpośrednio do trybu koncertowego z tą setlistą.
• Otwórz w Bibliotece — podwójne stuknięcie karty setlisty przenosi do Biblioteki z automatycznie odfiltrowaną zawartością we właściwym panelu.

4 Tryb Stage — Widok koncertowy

Tryb Stage jest zaprojektowany do występów na żywo. Ekran jest zawsze ciemny, tekst duży i czytelny, a wszystkie kontrolki minimalne i łatwe w obsłudze bez odrywania wzroku od sceny.

5 Teleprompter — Automatyczne przewijanie

Funkcja Telepromptera przewija tekst automatycznie ku górze ze stałą prędkością — dokładnie jak profesjonalny teleprompter studyjny. Dostępna dla tekstów (RTF/TXT) w trybie Stage.

• Start — naciśnij zielony przycisk Auto w górnym pasku. Tekst zaczyna się przewijać natychmiast.
• Regulacja prędkości — gdy Auto jest aktywne, po obu stronach przycisku pojawiają się przyciski − i +. Naciśnij by spowolnić lub przyspieszyć o 10 jednostek.
• Stop — naciśnij Stop (przycisk zmienia kolor gdy aktywny). Tekst zatrzymuje się w bieżącej pozycji.
• Ręczne przewijanie — przeciągnij obszar tekstu góra/dół w dowolnym momencie. Teleprompter zatrzymuje się automatycznie, pozwalając na repozycjonowanie i ponowne uruchomienie.
• Zmiana utworu — przejście do następnego lub poprzedniego utworu resetuje pozycję do góry i zatrzymuje Teleprompter.

6 Nuty PDF — Przeglądarka nut

Stemly Lyrics renderuje nuty PDF jako ostre obrazy w wysokiej rozdzielczości. Każda strona wyświetlana jest osobno dla maksymalnej czytelności na scenie. Pinch-to-zoom pozwala powiększać fragmenty, a tryb kino daje pełnoekranowy widok bez żadnych elementów interfejsu.

• Wybierz folder PDF — naciśnij pomarańczową ikonkę folderu i wybierz folder z plikami PDF.
• Otwórz nutę — naciśnij nazwę pliku PDF na liście. Strony renderują się automatycznie.
• Nawigacja stron — naciśnij strzałki lewo/prawo, przesuń palcem w bok, lub użyj pedału Bluetooth (patrz punkt 8).
• Powiększenie — szczypnij palcami na stronie by powiększyć. Przesuwaj palcem gdy powiększone. Szczypnij do wewnątrz by wrócić do normalnego widoku.
• Tryb kino — podwójne stuknięcie nuty włącza tryb kino — pełny ekran bez interfejsu. Podwójne stuknięcie ponownie kończy tryb kino.
• Pełny ekran (lista plików) — naciśnij przycisk List w prawym górnym rogu by ukryć listę plików i rozciągnąć nutę na całą szerokość. Naciśnij ponownie by wrócić.
• BPM per nutę — ustaw BPM dla bieżącej nuty przy pomocy kontrolek metronomu. Wartość zapisywana jest osobno dla każdego pliku w bpm_map.json w folderze nut PDF i przeżywa reinstalację aplikacji.
• Udostępnij przez QR — naciśnij PDF QR w nagłówku. Każde urządzenie w tej samej sieci Wi-Fi może otworzyć PDF w przeglądarce skanując kod.

7 Udostępnianie QR — Kody QR dla chóru

Stemly Lyrics ma wbudowany serwer HTTP. Dowolne urządzenie w tej samej sieci Wi-Fi może wyświetlać bieżący tekst lub nutę PDF w przeglądarce — bez instalowania aplikacji.

• Połącz wszystkie urządzenia z tą samą siecą Wi-Fi.
• W Stemly Lyrics naciśnij Lyrics QR (niebieski) lub PDF QR (pomarańczowy) w nagłówku.
• Na ekranie pojawia się kod QR. Każdy członek chóru lub muzyk skanuje go aparatem swojego urządzenia.
• Strona z tekstem otwiera się w przeglądarce i aktualizuje na żywo gdy dyrygent nawiguje między utworami.

8 Pedał Bluetooth do przewijania stron

Stemly Lyrics obsługuje standardowe pedały Bluetooth HID (AirTurn, PageFlip, iRig BlueTurn i inne). Te urządzenia wysyłają zdarzenia klawiatury przechwytywane przez aplikację.

• Sparuj pedał Bluetooth z iPadem przez Ustawienia → Bluetooth przed otwarciem aplikacji.
• Otwórz Stemly Lyrics i przejdź do nut PDF lub trybu Stage.
• Naciśnij pedał — aplikacja reaguje natychmiast bez żadnej dodatkowej konfiguracji.

9 Wskazówki i dobre praktyki

Organizacja plików

Utrzymuj dwa osobne foldery na iPadzie: jeden na teksty (RTF/TXT) i jeden na nuty PDF. Oba mogą być w iCloud Drive lub w lokalnej pamięci urządzenia.

Nazewnictwo plików

Nazwa pliku (bez rozszerzenia) musi pasować do tytułu utworu (niezależnie od wielkości liter i znaków diakrytycznych). Przykład: tytuł “Hallelujah” pasuje do “hallelujah.rtf”, “Hallelujah.pdf”, “HALLELUJAH.txt”.

Lista kontrolna przed koncertem

• Upewnij się, że wszystkie utwory w setliście mają swoje pliki tekstowe lub PDF we właściwym folderze.
• Przetestuj prędkość Telepromptera dla każdego utworu podczas próby.
• Jeśli udostępniasz chórowi, upewnij się, że wszystkie urządzenia są w tej samej sieci Wi-Fi i mogą otworzyć URL z kodu QR.
• Sparuj i przetestuj pedał Bluetooth przed wejściem na scenę.
• Ustaw maksymalną jasność ekranu i wyłącz automatyczne blokowanie w Ustawieniach iOS dla nieprzerwanego występu.

10 Transpozycja — zmiana tonacji akordów

Stemly Lyrics automatycznie wykrywa akordy w plikach tekstowych i pozwala transponować cały utwór w górę lub dół o dowolną liczbę półtonów — bez ingerencji w oryginalny plik.

• Otwórz utwór zawierający linie z akordami w tekście (np. Am  F  C  G nad tekstem).
• Kontrolka ♭ 0 ♯ pojawia się w nagłówku w kolorze fioletowym.
• Naciśnij ♯ by transponować w górę lub ♭ by transponować w dół. Każde naciśnięcie przesuwa o jeden półton.
• Przejdź do następnego utworu — transpozycja automatycznie resetuje się do 0.

11 Adnotacje PDF i gumka

Stemly Lyrics pozwala rysować bezpośrednio na stronach PDF za pomocą Apple Pencil lub palca. Adnotacje są zapisywane osobno dla każdej strony i nie modyfikują oryginalnego pliku PDF. Gumka pozwala usuwać pojedyncze kreski bez czyszczenia całej strony.

• Wejdź w tryb adnotacji — naciśnij ikonkę ołówka (przycisk Rysuj) na pasku narzędzi. Strona przełącza się w tryb rysowania.
• Wybierz kolor — naciśnij przycisk Kolor by przechodzić kolejno przez: Pomarańczowy → Niebieski → Czerwony → Czarny.
• Wybierz grubość — naciśnij przycisk Grubość by przechodzić przez: Cienka → Średnia → Gruba (widoczne jako rozmiar kropki).
• Gumka — naciśnij przycisk Gumka by przełączyć się z pióra na gumkę. Narysuj po dowolnej kresce by ją precyzyjnie usunąć. Naciśnij przycisk ołówka ponownie by wrócić do rysowania.
• Wyczyść wszystkie adnotacje na stronie — naciśnij przycisk Kosz by usunąć wszystkie adnotacje tylko z bieżącej strony.
• Zapisywanie — adnotacje są zapisywane automatycznie per strona. Pozostają dopóki ten sam plik PDF jest otwarty.
• Nowy plik — otwarcie innego pliku PDF usuwa wszystkie adnotacje. Oryginalny PDF nigdy nie jest modyfikowany.
• Wyjście z trybu adnotacji — naciśnij Gotowe by opuścić tryb rysowania i powrócić do normalnej nawigacji po PDF.