The Jazzpotatoes

Anleitung für Musiker

Diese Seite erklärt alle Funktionen der Jazzpotatoes-App. Die App ist eine digitale Setlist für die Band – optimiert für Bühne und Handy.

1. Anmelden

Öffne die App und tippe auf Setlist öffnen. Falls Nextcloud-Login aktiviert ist, wirst du zur Anmeldung weitergeleitet. Melde dich mit deinen Nextcloud-Zugangsdaten an. Deine Rolle (Gast / Musiker / Admin) wird automatisch aus deinen Nextcloud-Gruppen ermittelt.

• Gast – kann die Setlist lesen und Songs in der Vollbild-Ansicht öffnen.
• Musiker – kann zusätzlich Songs hinzufügen und bearbeiten sowie eigene Einstellungen pflegen.
• Admin – hat vollen Zugriff: Songs löschen, Excel importieren/exportieren, Spalten konfigurieren.

2. Die Setlist

Nach dem Login siehst du die vollständige Setlist als Tabelle. Die sichtbaren Spalten (Titel, Tonart, BPM, Tags …) können in den Einstellungen angepasst werden.

Suche und Filter

• Öffne das 🔎 Filter-Panel durch Antippen.
• Standardmäßig steht ein Tags-Freitext-Filter zur Verfügung. Weitere Filter können in den Einstellungen aktiviert werden.
• Filter werden automatisch angewendet (1 s Verzögerung) – kein Suchen-Button nötig.
• Der Zurücksetzen-Link entfernt alle aktiven Filter.
• Beim Klick auf einen Tag-Chip in der Liste wird die Setlist sofort danach gefiltert – das Filter-Panel bleibt dabei zugeklappt.

Setlist nach Veranstaltung filtern

Songs können mit Tags versehen werden, um Veranstaltungs-Setlists abzubilden. Filtere nach dem Tag des Konzerts (z. B. konzert-halle), um nur die Songs dieser Veranstaltung zu sehen. Innerhalb eines Tags kann mit dem Suffix :NN eine Reihenfolge angegeben werden, z. B. konzert-halle:01 für den ersten Song. Die Master-Setlist enthält alle Songs ohne Tag-Filter.

Songs mit einer Halbschritt-Reihenfolge (Tag-Suffix :X.5, z. B. konzert:1.5) werden in der Listenansicht hervorgehoben. In der PDF-Druckansicht erscheinen diese Zeilen schraffiert (schwarz/weiß).

Sortieren

Klicke auf einen Spaltenkopf, um die Liste auf- oder absteigend zu sortieren (▲/▼). BPM und Nummern werden numerisch sortiert.

3. Vollbild-Ansicht (Bühne)

Tippe auf einen Songtitel, um ihn in der Vollbild-Ansicht zu öffnen. Diese Ansicht ist für die Bühne optimiert: großer Titeltext, BPM-Blinker, Navigation.

• ◀ / ▶ – zum vorherigen / nächsten Song navigieren. Auf Touch-Geräten per Wischgeste links/rechts, am Laptop über Pfeiltasten (←/→) oder Trackpad-Zwei-Finger-Wischgeste.
• BPM-Blinker – blinkt im Songtempo. Tippe auf 🔈 für einen hörbaren Metronom-Klick.
• Live-Tempo – erkennt das aktuelle Tempo per Mikrofon automatisch.
• Link-Buttons – öffnen verlinkte Dokumente, Noten-PDFs, YouTube-Videos oder Streaming-Links direkt in der App.
• ✕ – schließt die Vollbild-Ansicht und kehrt zur Setlist zurück (mit aktiven Filtern).

Felder bearbeiten (Musiker+)

Halte einen Feldwert lang gedrückt (ca. 0,6 s / Long-Press), um ein Bearbeitungs-Overlay für genau dieses Feld zu öffnen. Das funktioniert sowohl in der Listenansicht als auch in der Vollbild-Ansicht. Auf dem Handy gibt es beim Öffnen ein spürbares Vibrations-Feedback.

• Das Edit-Modal zeigt das gewählte Feld als Eingabefeld.
• Speichern aktualisiert nur dieses eine Feld; alle anderen Felder bleiben unverändert.
• Abbrechen verwirft die Änderung und schließt das Modal.
• In der Vollbild-Ansicht: Während das Modal offen ist, ist die Swipe-Navigation deaktiviert.

4. Songs bearbeiten (Musiker+)

Song hinzufügen

Öffne das Menü (☰) und tippe auf ➕ Song hinzufügen. Fülle die Felder aus und tippe auf 💾 Anlegen.

Song bearbeiten

Öffne den Song in der Vollbild-Ansicht (Tippen auf den Songtitel) und halte dann einen Feldwert lang gedrückt (Long-Press, ca. 0,6 s). Es öffnet sich ein Overlay-Modal für genau dieses Feld. Nach dem Speichern wird nur das geänderte Feld aktualisiert.

Links (Noten, YouTube, Streaming)

Im Feld Noten-PDF / Links können beliebige URLs eingetragen werden: Noten-PDFs, YouTube-Videos, Spotify-/Apple-Music-Links oder andere Dokumente. Pro Song können mehrere Links gespeichert werden – getrennt durch Semikolon (";"). Jeder Link erscheint als Button in der Setlist-Zeile (📄 / ▶️ / 🎵 / 🔗) und in der Vollbild-Ansicht.

Format: einfache URL oder Label:https://.... für einen benutzerdefinierten Namen. Beispiele:

• https://noten.example.com/blueMonk.pdf – ein PDF-Link ohne Label
• Noten:https://noten.example.com/blueMonk.pdf;YouTube:https://youtu.be/abc123 – Noten-PDF und YouTube nebeneinander
• Spotify:https://open.spotify.com/track/... – ein Spotify-Link mit Label

Tags und Veranstaltungen

Im Tags-Feld können mehrere Tags eingetragen werden, getrennt durch Semikolon, Komma oder Zeilenumbruch. Für Veranstaltungs-Setlists empfiehlt sich das Format konzertname:01 – die Zahl nach dem Doppelpunkt legt die Reihenfolge in der gefilterten Setlist fest.

5. Repertoire-Statistiken (/stats)

Über den Button 📊 Statistiken auf der Startseite oder über das Menü (☰ → 📈 Statistik) gelangst du zu einer vollständigen Auswertung des Band-Repertoires:

• Bühnenreife & Repertoire-Größe – Gesamtanzahl der Stücke und wie viele davon bühnenreif (in einem Set) sind.
• Noten- & BPM-Abdeckung – Fortschrittsbalken zeigen, wie vollständig die Dokumentation der Stücke ist.
• Groove- & Tempoverteilung – Visualisierung der Stile (Swing, Funk, Bossa, Latin …) und Tempobereiche.
• Tonarten-Übersicht – Verteilung der Stücke nach Tonarten (z. B. F, Bb, Eb …).
• Offene Band-To-Dos – Automatische Liste aller Songs, bei denen noch BPM, Tonart oder Noten fehlen.

6. Bühnenset-Editor (/sets)

Der interaktive Bühnenset-Editor ermöglicht die visuelle Zusammenstellung und Reihenfolge-Planung von Konzert-Sets:

• Repertoire-Pool – Durchsuche alle vorhandenen Band-Songs und füge sie per Klick (➕) zum aktuellen Set hinzu.
• Set-Reihenfolge anpassen – Verschiebe Songs per Pfeiltasten (▲ / ▼) oder ändere die Position direkt.
• Set speichern – Speichert das Set dauerhaft als Tag-Gruppe (z. B. sommerfest:01, sommerfest:02 …).
• Set filtern – Ein Klick auf „In Setlist öffnen“ öffnet die gefilterte Setlist-Ansicht für den Auftritt.

7. Einstellungen (/settings)

Über das Menü (☰ → ⚙️ Einstellungen) können Musiker und Admins die App anpassen:

• Sichtbare Spalten – Wähle aus, welche Spalten in der Tabellenansicht angezeigt werden sollen.
• Aktive Filter – Aktiviere zusätzliche Filter in der Filterleiste (z. B. Tonart, Tempo-Bereich, Groove).
• Spaltentyp-Standard – Textspalten sind per Voreinstellung mehrzeilig (multiline) angelegt.
• Farbschemata / Themes – Wähle zwischen Modern Dark, Warm Amber, Midnight Blue, High Contrast oder dem spielerischen Unicorn Mode mit zarten Pastellfarben.
• Live-Tempo-Einstellungen – Konfiguriere Erkennungs-Engine (Beat-Parser-Core oder Autokorrelation) und Genre-Profile.
• KI & Drum-Setup – Wähle individuelle Drum-Instrumente und konfiguriere LLM-Zugangsdaten persistent in der Datenbank.

8. Offline-Betrieb & PWA

Die Jazzpotatoes-App ist als Progressive Web App (PWA) konzipiert und offline-fähig:

• Zum Startbildschirm hinzufügen – Installiere die App auf Tablet oder Smartphone für Vollbild-Bedienung ohne Browserleiste.
• Für Konzert vorbereiten (Offline-Cache) – Auf der Startseite oder im Menü speichert der Button ⚡ Für Konzert vorbereiten alle Songs und Noten-Links im lokalen Browser-Speicher.
• Service Worker – Auf der Bühne funktioniert die Setlist auch ganz ohne WLAN oder Mobilfunknetz.

9. WebMCP & KI-Assistent (J-AI)

Die App enthält ein integriertes WebMCP-System (Model Context Protocol), das Browser-basierten KI-Agenten und dem integrierten J-AI Chatbot strukturierte Tools bereitstellt:

Verfügbare MCP-Tools

• list_songs – Durchsucht und filtert die Setlist. Parameter: query (Volltextsuche), tags (Tag-Filter), tonart (Tonart), groove (Stilistik), has_pdf, has_bpm, bpm_min, bpm_max.
• get_song – Liefert alle Detaildaten zu einem bestimmten Song (ID oder UUID).
• get_setlists – Liefert alle vorhandenen Setlisten samt Song-Anzahl.
• get_setlist_details – Liefert alle Songs eines Bühnensets geordnet in Auftrittsreihenfolge.
• get_tags – Übersicht aller Tags samt Häufigkeit.
• get_stats – Aggregierte Band-Kennzahlen (Repertoire-Größe, bühnenreife Songs, PDF/BPM-Abdeckung, To-Dos).
• get_settings – Aktuelle Spalten- und Filtereinstellungen des Nutzers.
• add_song – Legt einen neuen Song an (Musiker+).
• update_song – Aktualisiert Songdaten (Musiker+).
• set_song_notation – Speichert Drum-Tabs oder Piano-Roll-Notationen in konfigurierten oder neuen Feldern (Musiker+).
• add_column – Legt neue Spalten/Felder im Repertoire an und weist den Typ ('text', 'drum', 'pianoroll') zu (Musiker+).
• search_song_examples – Sucht im Web / auf YouTube nach Audio- und Videobeispielen.
• add_example_to_song – Hinterlegt gefundene Hörbeispiele im Feld pdf_url (Musiker+).
• manage_setlist – Erstellt, sortiert oder löscht ein Bühnenset (Musiker+).
• delete_song – Löscht einen Song (Admin).

Declarative API & Schnellsuch-Formular

Zusätzlich zur JavaScript-API stellt die Setlist ein deklaratives Suchformular mit dem Attribut toolname="search_setlist" bereit.

JSON-REST-API (/api/*)

Alle WebMCP-Tools kommunizieren über standardisierte REST-Endpunkte (/api/songs, /api/setlists, /api/tags, /api/stats, /api/settings).

10. Drum-Grooves, Piano-Roll, Audio-Vorhören & MIDI

Die App bietet interaktive Notationseditoren und einen Web-Audio-Synthesizer:

• Drum-Sequencer – 16-Step-Grid mit konfigurierbaren Instrumenten (Kick, Snare, Hi-Hats, Toms, Crash- und Ride-Becken, Cowbell). Inklusive automatischer Genre-Presets (Swing, Bossa, Funk, Rock, Walzer, Shuffle).
• Piano-Roll Melodie-Editor – Interaktiver Sequencer für Bläser- und Sololinien mit flexiblen Notendauern (1/16 bis Ganze-Note) und visueller Sustain-Darstellung (=).
• Direktes Vorhören (▶) – Sowohl in der Setliste als auch im Vollbild-Songmodal können Grooves und Melodien sofort angehört werden.
• Standard-MIDI (.mid) – Notationen und Grooves lassen sich als Standard-MIDI-Datei (.mid) exportieren und importieren.
• Feldschutz – Musiker-Notizen (Steve, TK) sind strikt geschützte Textnotizen. Strukturierte Rhythmen und Noten liegen sauber in den Feldern drum_pattern und notation.