GuitarPT

App Navigation

GuitarPT has 4 main tabs:

You can reorder tabs by long-pressing and dragging them.

Loading Your First Song

From the Player (quickest): Tap the folder icon in the top-right corner, pick an audio or video file. The waveform and analysis (BPM, chords) start automatically.

From the Library: Open the Songs tab and tap any song — the player opens immediately.

Import Menu (+)

Tap the + button in the Songs tab to open the consolidated import menu:

Supported Formats

App-Navigation

GuitarPT hat 4 Haupttabs:

Die Tab-Reihenfolge kann per Long-Press + Drag angepasst werden.

Ersten Song laden

Direkt im Player: Oben rechts auf das Ordner-Symbol tippen, Audio- oder Videodatei auswählen. Wellenform und Analyse (BPM, Akkorde) starten automatisch.

Aus der Bibliothek: Tab Songs öffnen und Song antippen — Player öffnet sich direkt.

Import-Menü (+)

Das +-Menü im Songs-Tab bietet 5 konsolidierte Optionen:

Unterstützte Formate

Basic Playback

• Play / Pause — tap the large button in the center.
• Skip forward / back — use the + and − buttons. The skip distance scales with your current zoom level (e.g. at 10× zoom, each tap skips only 1 second).

Navigating the Waveform

The zoom range goes from 1× (full song overview) to 15× (detailed view). Skip buttons automatically adjust to the zoom level.

Playback Speed

Change the tempo without affecting pitch — perfect for practicing difficult passages.

• Tap the Speed button (shows current percentage).
• A slider appears: 25% to 150% with snap points at 25%, 50%, 75%, 100%, 125%, 150%.
• Double-tap the Speed button to instantly reset to 100%.
• The button glows when speed ≠ 100%.

Transpose

Shift the pitch up or down without changing the tempo — useful for matching a different tuning or key.

• Tap the Transp. button → slider from −12 to +12 semitones.
• While calculating, a progress bar fills across the panel.
• Double-tap to reset to 0.
• The button shows the active value (e.g. +3) and glows when active.

Grundlegende Wiedergabe

• Play / Pause — großer Button in der Mitte.
• +/− Buttons — Vor- und Zurückspulen. Die Schrittweite skaliert mit der Zoomstufe (z. B. Zoom×10 → nur 1 s springen).

Navigation in der Wellenform

Zoomstufe: 1× (kompletter Song) bis 15× (Detailansicht). Bei aktivem Zoom passen sich die +/− Buttons an.

Wiedergabegeschwindigkeit

Tempo ändern ohne Pitch-Verschiebung — perfekt zum Üben schwieriger Passagen.

• "Speed XX%"-Button drücken → Slider klappt auf.
• Stufenlos von 25% bis 150% mit Einrast-Punkten bei 25%, 50%, 75%, 100%, 125%, 150%.
• Doppeltippen auf den Speed-Button → sofortiger Reset auf 100%.
• Button leuchtet farbig wenn Geschwindigkeit ≠ 100%.

Transponieren

Tonhöhe verschieben ohne Tempo-Änderung — ideal um eine andere Stimmung oder Tonart zu treffen.

• "Transp."-Button drücken → Slider von −12 bis +12 Halbtönen.
• Während der Berechnung füllt sich das Panel farbig.
• Doppeltippen → sofortiger Reset auf 0.
• Button zeigt aktiven Wert an (z. B. +3 ♪) und leuchtet wenn ≠ 0.

After loading a file, analysis runs automatically in the background:

• BPM appears next to the time display (e.g. "92.5 BPM").
• Re-analyze — tap the refresh icon (↻) next to the BPM display to restart the analysis.
• Chord ribbon — a horizontal band below the time display, scrolling left through the song. The current chord sits at the centre playhead; upcoming chords approach from the right with their actual durations, so you can see how long each one lasts before it changes. Cell colours follow the app accent and get darker towards the song's tonic.
• Key badge — small pill above the ribbon showing the song's current key (e.g. "G Dur"). Updates live as the playhead crosses modulations; a ↔ icon appears while a non-initial key is active. Only filled in for Mac-analysed songs with the LLM layer.
• Layer toggle — three-segment switch Analysis · Simplified · Theory above the ribbon, available for Mac-analysed songs (see Chapter 4). Segments without data are dimmed.
• Confidence indicator — uncertain chords are dimmed and labelled with a "?" suffix in the Analysis layer.
• Silence detection — silence at the beginning is recognised and not filled with placeholder chords.

Scrubbing the Ribbon

The chord ribbon is also a navigation surface:

• Drag horizontally to scrub — the waveform, time text and (in video mode) the video frame follow live.
• Release with momentum for a wheel-style fling: the band keeps rolling and decelerates exponentially, the way a spinning record settles. The longer your flick, the further you travel.
• Modulation markers — for Mac-analysed songs with the LLM layer, a thin accent line + a "→ C Dur"-style label appears on the ribbon wherever the key changes, so you see a modulation coming before the badge above flips.

How Chord Detection Works

The chord analysis runs entirely on-device — your audio never leaves the phone, and there's nothing to set up. For an even better result on dense productions, a paired Mac can take over via stem separation + an optional music-theory layer — see Chapter 4 (Mac Analysis & Stems).

A few things are worth knowing about how the recognizer behaves, so you can read its output at a glance:

• Beat-aware — chords are anchored to the detected beats and bars, so the chord strip stays in sync with the actual groove instead of drifting on a fixed clock.
• Key-aware — the recognizer figures out the song's key (and follows modulations within a song). It uses that both to favour chords that fit and to spell accidentals correctly (so you'll see A♭ in F minor, not G♯).
• Confidence-aware — every chord ships with a confidence value. Uncertain chords appear in orange with a ? suffix, and the coloured bar underneath the chord strip tells you at a glance which segments to trust.
• Tasteful slash chords — slash chords show up only when they actually carry musical meaning (1st-inversion bass, walking-bass passing tones), not whenever the bass plays a different note — see the rules below.
• Silence- and junk-aware — silent intros stay empty, and short low-confidence events at the very start are dropped instead of cluttering the strip.

Slash Chord Display Rules

To keep the chord strip readable, only musically meaningful slash chords are shown:

Nach dem Laden einer Datei startet die Analyse automatisch im Hintergrund:

• BPM — neben der Zeitanzeige (z. B. „92,5 BPM").
• Re-Analyse — Refresh-Icon (↻) neben der BPM-Anzeige startet die Analyse neu.
• Akkord-Ribbon — horizontale Bar unter der Zeitanzeige, scrollt nach links durch den Song. Der aktuelle Akkord sitzt am zentralen Playhead; kommende Akkorde nähern sich von rechts mit ihrer tatsächlichen Länge, damit man sieht, wie lange jeder noch dauert. Zellfarben folgen dem App-Akzent und werden Richtung Tonika dunkler.
• Tonart-Badge — kleine Pille über dem Ribbon mit der aktuellen Tonart (z. B. „G Dur"). Aktualisiert sich live, wenn der Playhead Modulationen überquert; ein ↔-Icon erscheint, sobald eine Nicht-Anfangstonart aktiv ist. Nur bei Mac-analysierten Songs mit LLM-Schicht gefüllt.
• Layer-Umschalter — Drei-Segment-Schalter Analysis · Simplified · Theorie oberhalb des Ribbons, verfügbar für Mac-analysierte Songs (siehe Kapitel 4). Segmente ohne Daten sind ausgegraut.
• Confidence-Anzeige — unsichere Akkorde werden gedimmt mit „?"-Suffix gekennzeichnet (Analysis-Schicht).
• Stille-Erkennung — Stille am Anfang wird erkannt und nicht mit Platzhalter-Akkorden gefüllt.

Wischen im Ribbon

Das Akkord-Ribbon ist auch eine Navigationsfläche:

• Horizontal wischen zum Scrubben — Wellenform, Zeitanzeige und (im Video-Modus) das Video-Bild folgen live mit.
• Mit Schwung loslassen für ein Schwungrad-Verhalten: die Bar rollt weiter und bremst exponentiell ab, wie eine Platte, die ausläuft. Je kräftiger der Flick, desto weiter trägt's.
• Modulations-Marker — bei Mac-analysierten Songs mit LLM-Schicht: eine dünne Akzent-Linie + ein Label wie „→ C Dur" erscheint an jeder Stelle, an der die Tonart wechselt. So sieht man die Modulation kommen, bevor das Badge oben umschaltet.

So funktioniert die Akkorderkennung

Die Akkordanalyse läuft vollständig auf dem Gerät — dein Audio verlässt das Telefon nie, und es ist nichts einzurichten. Für noch bessere Ergebnisse bei dichten Produktionen kann ein gekoppelter Mac per Stem-Separation und optionalem Musiktheorie-Pass übernehmen — siehe Kapitel 4 (Mac-Analyse & Stems).

Ein paar Dinge solltest du über das Verhalten wissen, dann kannst du das Ergebnis im Player schneller einordnen:

• Beat-bewusst — Akkorde werden an die erkannten Beats und Takte gehängt, sodass der Akkord-Streifen mit dem tatsächlichen Groove läuft und nicht auf einer starren Zeitachse driftet.
• Tonart-bewusst — die Erkennung ermittelt die Tonart des Songs (und folgt Modulationen innerhalb eines Stücks). Sie nutzt die Tonart, um passende Akkorde zu bevorzugen und Vorzeichen korrekt zu schreiben (in F-Moll siehst du also A♭, nicht G♯).
• Confidence-bewusst — jeder Akkord trägt einen Confidence-Wert. Unsichere Akkorde erscheinen orange mit ?-Suffix, und der farbige Balken unter dem Akkord-Streifen zeigt auf einen Blick, welchen Stellen du trauen kannst.
• Sparsam mit Slash-Chords — Slash-Chords werden nur gezeigt, wenn sie musikalisch sinnvoll sind (1. Umkehrung, Walking-Bass-Durchgangstöne) — nicht jedes Mal, wenn der Bass eine andere Note spielt. Siehe Tabelle unten.
• Stille- und Junk-Filter — stille Intros bleiben leer, und kurze Low-Confidence-Events ganz am Anfang fliegen raus statt den Streifen zu verstopfen.

Slash-Chord-Anzeige

Damit der Akkord-Streifen lesbar bleibt, werden nur musikalisch sinnvolle Slash-Chords angezeigt:

GuitarPT can run its analysis in two places:

1. On-device (Chapter 3) — runs straight inside the iPhone/iPad app. Always available, but limited by what the phone's CPU can do in a reasonable time.
2. On a paired Mac — runs the same analysis on a real desktop with a dedicated stem-separator and an optional music-theory LLM pass. Much higher accuracy, especially for dense mixes.

This chapter explains what the Mac pipeline does, how to install the companion app, and how the iPhone/iPad app delegates work to it.

What the Mac Pipeline Adds

• Stem separation — the song is split into drums, bass, vocals and the rest before chord analysis runs. The recogniser then looks only at the harmonic stem, which makes chords on cluttered productions (90s pop, modern rock, dense electronic) substantially cleaner.
• Music-theory interpretation (LLM-based, optional) — adds key, mode, Roman-numeral analysis, song sections (Verse / Chorus / Bridge / …) and modulations on top of the chord stream. Cost ≈ 1–3 cents per song through an OpenAI API key you provide. See Settings → LLM Interpretation (Chapter 14).
• Enharmonic spelling — chord names follow the song's key per circle-of-fifths conventions: F-major uses ♭'s, D-major uses ♯'s, and modulations within the song re-spell accordingly.
• Key-change markers — the chord ribbon shows where modulations happen, the top-bar key badge follows the playhead and pre-announces the next key change.

Installing the Companion App

The companion app's job is to pick up analysis jobs from iCloud, run them locally, and write the results back into iCloud where the iPhone picks them up. On the Mac you don't interact with it during normal use — once it's installed it just sits in the menu bar.

What you'll need to provide once:

• Same iCloud account as your iPhone/iPad (the app uses your private iCloud container — no cloud storage outside Apple).
• An OpenAI API key if you want the music-theory layer. Without one the chord analysis still benefits from stems, only the Roman-numeral / section / modulation pass is skipped.

Triggering a Mac Analysis from the iPhone / iPad

Once the companion app is running on a reachable Mac, every song's analysis button gets a new option:

1. Tap the ↻ icon next to the BPM in the player.
2. In the menu, choose Better analysis (Mac). The dot next to the icon shows your Mac's state: green = online, amber = checking, red = offline, grey = not configured.
3. The iPhone uploads the song to iCloud, the Mac picks it up, and the player shows live status: waiting → loading iCloud → separating stems → analysing chords → done. Typical end-to-end time on Apple Silicon: 30–90 s per song.

While the Mac analysis is running you can keep using the player with the existing on-device analysis. When the new result lands it replaces the previous one in place.

Layers in the Chord Ribbon

Mac-analysed songs expose three layers in the player's chord ribbon — switch between them with the segmented control above the band:

• Analysis — the raw output of the recogniser, every chord event the model decided on. Closest to "what the model heard".
• Simplified — a popcore-style cleanup that collapses transient passing chords and short low-confidence events. Easier to read, still in chord names.
• Theory — Roman-numeral view with T / SD / D function pins, the actual chord names shown small underneath. Only available after the LLM-interpretation pass has run.

When Things Don't Work

• Mac shows offline. Check the companion app's menu-bar icon. Most common cause: the Mac went to sleep with iCloud sync paused.
• Analysis stalls at "loading iCloud". iOS hasn't pushed the audio file yet — keep the iPhone awake with GuitarPT in the foreground for a minute. The companion app uses brctl download to nudge iCloud once the file shows up.
• "Demux: Timeout" snackbar. The Mac didn't respond within ~5 minutes. Either the file is very long, or the Mac is overloaded. Tap re-analyse to re-queue.
• Theory layer stays empty. Either the LLM mode is set to Off, the OpenAI key isn't configured, or the LLM call failed (network / quota). Switch the mode in Settings → LLM Interpretation.

GuitarPT kann seine Analyse an zwei Stellen ausführen:

1. On-Device (Kapitel 3) — läuft direkt in der iPhone-/iPad-App. Immer verfügbar, aber durch die CPU des Telefons in der erreichbaren Qualität begrenzt.
2. Auf einem gekoppelten Mac — dieselbe Analyse auf einem echten Desktop, mit dedizierter Stem-Separation und optionalem Musiktheorie-LLM-Pass. Deutlich höhere Genauigkeit, besonders bei dichten Mixes.

Dieses Kapitel erklärt, was die Mac-Pipeline leistet, wie du die Companion-App installierst und wie die iPhone-/iPad-App Aufträge an sie delegiert.

Was die Mac-Pipeline zusätzlich liefert

• Stem-Separation — der Song wird vor der Akkordanalyse in Drums, Bass, Vocals und Rest aufgeteilt. Die Erkennung schaut dann nur auf den harmonischen Stem; das macht die Akkorde bei vollen Produktionen (90er-Pop, modernen Rock, dichte elektronische Musik) deutlich sauberer.
• Musiktheorie-Interpretation (LLM-basiert, optional) — fügt Tonart, Modus, Stufenanalyse, Songsektionen (Verse / Chorus / Bridge / …) und Modulationen über den Akkord-Stream. Kosten ca. 1–3 Cent pro Song über einen von dir bereitgestellten OpenAI-Key. Siehe Einstellungen → LLM-Interpretation (Kapitel 14).
• Enharmonische Schreibung — Akkord-Namen folgen der Tonart des Songs nach Quintenzirkel-Regeln: F-Dur nutzt ♭, D-Dur nutzt ♯, und Modulationen im Stück schreiben entsprechend um.
• Tonartwechsel-Marker — das Akkord-Ribbon zeigt, wo Modulationen stattfinden; das Tonart-Badge oben folgt dem Playhead und kündigt die nächste Modulation vor.

Companion-App installieren

Die Aufgabe der Companion-App: sie holt Analyse-Aufträge aus iCloud, rechnet sie lokal und schreibt die Ergebnisse zurück in iCloud, wo das iPhone sie abholt. Auf dem Mac interagierst du im Normalbetrieb nicht mit ihr — einmal installiert sitzt sie als Menüleisten-Icon im Hintergrund.

Was du einmalig brauchst:

• Derselbe iCloud-Account wie auf dem iPhone/iPad (die App nutzt deinen privaten iCloud-Container — kein Cloud-Speicher außerhalb von Apple).
• OpenAI-API-Key, falls du die Musiktheorie-Schicht willst. Ohne Key profitiert die Akkordanalyse trotzdem von den Stems, nur der Stufenanalyse-/Sektion-/Modulations-Pass wird übersprungen.

Mac-Analyse vom iPhone / iPad anstoßen

Sobald die Companion-App auf einem erreichbaren Mac läuft, bekommt der Analyse-Button im Player eine neue Option:

1. Auf das ↻-Icon neben dem BPM-Wert im Player tippen.
2. Im Menü Bessere Analyse (Mac) wählen. Der Punkt am Icon zeigt den Mac-Status: grün = online, gelb = wird geprüft, rot = offline, grau = nicht eingerichtet.
3. Das iPhone lädt den Song in iCloud, der Mac holt ihn ab, und der Player zeigt Live-Status: wartet → lädt iCloud → trennt Stems → analysiert Akkorde → fertig. Typische Gesamtdauer auf Apple Silicon: 30–90 s pro Song.

Während die Mac-Analyse läuft, kannst du den Player mit der bestehenden On-Device-Analyse normal weiternutzen. Sobald das neue Ergebnis eintrifft, ersetzt es das bisherige an Ort und Stelle.

Schichten im Akkord-Ribbon

Mac-analysierte Songs bieten im Akkord-Ribbon drei Schichten — umschaltbar über die Segment-Leiste oberhalb der Bar:

• Analysis — die rohe Ausgabe der Erkennung, jedes vom Modell entschiedene Akkord-Event. Am nächsten an „was das Modell gehört hat".
• Simplified — eine Popcore-Style-Aufräumung, die transiente Durchgangs-Akkorde und kurze unsichere Events zusammenfasst. Lesbarer, weiterhin in Akkord-Namen.
• Theorie — Stufenanalyse-Sicht mit T-/SD-/D-Funktions-Pins, der echte Akkordname klein darunter. Nur verfügbar, nachdem der LLM-Interpretations-Pass gelaufen ist.

Wenn etwas nicht funktioniert

• Mac zeigt offline. Das Menüleisten-Icon der Companion-App prüfen. Häufigste Ursache: der Mac ist mit pausiertem iCloud-Sync in den Ruhezustand gegangen.
• Analyse hängt bei „lädt iCloud". iOS hat die Audiodatei noch nicht hochgeladen — das iPhone mit GuitarPT im Vordergrund für eine Minute wach halten. Die Companion-App nutzt brctl download, um iCloud nachzuschubsen, sobald die Datei sichtbar wird.
• „Demux: Timeout"-Snackbar. Der Mac hat nicht innerhalb von ~5 Minuten geantwortet. Entweder ist die Datei sehr lang, oder der Mac ist überlastet. Erneut auf Re-Analyse tippen, um wieder einzureihen.
• Theorie-Schicht bleibt leer. Entweder ist der LLM-Modus auf Aus, der OpenAI-Key ist nicht hinterlegt, oder der LLM-Aufruf ist fehlgeschlagen (Netz / Quota). Modus unter Einstellungen → LLM-Interpretation wechseln.

Setting Markers

Markers let you bookmark important positions in a song (e.g. verse, chorus, guitar solo).

• Set a marker — tap the Marker button to place a marker at the current playback position.
• Markers are automatically named alphabetically (A, B, C…) and sorted by time.
• If a marker already exists within 100ms, no duplicate is created.

Working with Markers

When dragging a marker, precision scales with the zoom level — zoom in for fine adjustments.

Looping

A loop automatically repeats a section between two markers:

1. Set at least two markers (e.g. A and B).
2. Tap the Loop button — if two markers are already selected, the loop starts between them. If markers exist but none are selected, the first two are auto-selected.
3. Tap the Loop button again to deactivate.
4. Double-tap the Loop button (while looping) to jump back to the loop start.

• When a loop starts, the waveform zooms to show the entire loop section.
• Moving a marker while looping updates the loop range instantly.
• Manually zooming overrides the auto-zoom; the view then follows the playback position.
• The loop is automatically deactivated if a marker is deleted or deselected.

Loop Sections

Two markers can be merged into a Loop Section — a persistent, named loop region.

• Up to 3 loop sections per song are supported.
• Waveform highlighting — the active loop section is shown prominently; inactive sections are displayed subtly.
• Persistence — loop sections are saved to the database and restored when you reopen the song.

Marker setzen

Marker markieren wichtige Stellen im Song (z. B. Verse, Chorus, Gitarrensolo).

• Marker setzen — „Marker"-Button drücken → setzt Marker an die aktuelle Abspielposition.
• Marker werden automatisch alphabetisch (A, B, C…) benannt und nach Zeit sortiert.
• Existiert bereits ein Marker innerhalb von 100 ms → kein Duplikat.

Marker bearbeiten

Beim Ziehen eines Markers skaliert die Präzision mit der Zoomstufe — für feine Anpassungen reinzoomen.

Loop

Ein Loop wiederholt automatisch einen Abschnitt zwischen zwei Markern:

1. Zwei Marker setzen (z. B. A und B).
2. Loop-Button drücken — sind bereits zwei Marker selektiert, startet der Loop zwischen diesen. Sonst werden die ersten zwei Marker automatisch ausgewählt.
3. Loop-Button nochmal drücken → Loop deaktiviert.
4. Doppeltipp auf Loop-Button (bei aktivem Loop) → springt zum Loop-Anfang.

• Beim Loop-Start zoomt die Wellenform automatisch auf den Loop-Bereich.
• Marker verschieben bei aktivem Loop → Loop-Bereich passt sich sofort an.
• Manuell zoomen → Auto-Zoom wird aufgehoben.
• Loop wird automatisch deaktiviert wenn ein Marker gelöscht oder deselektiert wird.

Loop-Sektionen

Zwei Marker können zu einer Loop-Sektion zusammengeführt werden — ein persistenter, benannter Loop-Bereich.

• Bis zu 3 Loop-Sektionen pro Song möglich.
• Wellenform-Hervorhebung — aktive Sektion wird prominent dargestellt, inaktive dezent.
• Persistenz — Loop-Sektionen werden in der Datenbank gespeichert und beim nächsten Öffnen wiederhergestellt.

Browsing & Searching

• Search — use the search field at the top (autocorrect is disabled). Results filter live as you type.
• Sort — tap the sort button (top right) to sort by date, title (A–Z), or manual order.
• Manual sorting — drag and drop songs to reorder them.

Managing Songs

Each song has a three-dot menu (⋮) with options:

You can also swipe left on a song to delete it.

Song-Leadsheet Bundles

Songs and leadsheets can be linked together so they function as a unit:

• A linked leadsheet shows a key badge in the song's subtitle (e.g. "A" or "Cm") — tap it to jump to the leadsheet editor.
• A larger leadsheet icon appears next to the three-dot menu — tap for quick access.
• A linked song shows an icon in the leadsheet's subtitle — tap it to open the player.
• Links are preserved when saving the leadsheet.

Suchen & Durchsuchen

• Suche — Suchfeld oben, Autokorrektur deaktiviert. Filtert live nach Titel.
• Sortierung — nach Datum, Titel (A–Z) oder manuell (Pfeil-Button oben rechts).
• Manuelle Sortierung — Songs per Drag & Drop umsortieren.

Songs verwalten

Jeder Song hat ein 3-Punkte-Menü (⋮) mit Optionen:

Zum Löschen einen Song nach links wischen.

Song-Leadsheet-Bündel

Songs und Leadsheets können verknüpft werden und funktionieren dann als Einheit:

• Ein verknüpftes Leadsheet zeigt ein Tonart-Badge im Song-Subtitle (z. B. „A" oder „Cm") — antippen zum Öffnen des Editors.
• Ein größeres Leadsheet-Icon erscheint neben dem 3-Punkte-Menü für schnellen Zugriff.
• Ein verknüpfter Song zeigt ein Icon im Leadsheet-Subtitle — antippen öffnet den Player.
• Verknüpfungen bleiben beim Speichern erhalten.

Browsing & Searching

• Sort — tap the sort button (top right) to sort by date, title (A–Z), or manual order.
• Manual sorting — drag and drop leadsheets to reorder them.

Managing Leadsheets

Each leadsheet has a three-dot menu (⋮) with options:

You can also swipe left on a leadsheet to delete it.

Subtitle Information

The leadsheet subtitle shows:

• Linked song name (with audio icon — tap to open player)
• Assigned project name (with folder icon)
• Time signature and section count

Tap the + button (bottom right) while on the Leadsheets tab to create a new chord chart.

Suchen & Sortieren

• Sortierung — nach Datum, Titel (A–Z) oder manuell.
• Manuelle Sortierung — Leadsheets per Drag & Drop umsortieren.

Leadsheets verwalten

Jedes Leadsheet hat ein 3-Punkte-Menü (⋮) mit Optionen:

Zum Löschen ein Leadsheet nach links wischen.

Subtitle-Informationen

Der Leadsheet-Subtitle zeigt:

• Verknüpfter Song-Name (mit Audio-Icon — antippen öffnet Player)
• Zugewiesenes Projekt (mit Ordner-Icon)
• Taktart und Section-Anzahl

+-Button unten rechts im Leadsheets-Tab erstellt ein neues Akkordblatt.

Projects

Projects group songs and leadsheets into themed collections (e.g. "Band Project", "May Concert").

Project Detail View

• Songs and leadsheets are shown in separate sections.
• Each item has a three-dot menu for management.
• Linked leadsheets are integrated into the song list — they don't appear separately. Instead, a tappable key badge (e.g. "A" or "Cm") appears on the linked song.

Adding Items

• Songs: Import files directly into the project using the + button, or assign from the Songs tab.
• Leadsheets: Use the three-dot menu → "Assign to Project".

Removing Items

Three-dot menu → "Remove" (only removes the assignment, not the item itself).

Setlists

Setlists contain songs and leadsheets in a defined order, perfect for gigs and practice sessions.

Adding Items

1. Tap the + button.
2. Choose "Add Song" or "Add Leadsheet".
3. Pick from the available items.

Position numbers are displayed automatically.

Projekte

Projekte bündeln Songs und Leadsheets thematisch (z. B. „Bandprojekt", „Konzert Mai").

Projekt-Detailansicht

• Songs und Leadsheets werden in getrennten Sektionen angezeigt.
• Jedes Item hat ein 3-Punkte-Menü.
• Verknüpfte Leadsheets sind in der Song-Liste integriert — sie erscheinen nicht separat. Stattdessen zeigt ein antippbares Tonart-Badge (z. B. „A" oder „Cm") die Verknüpfung.

Items hinzufügen

• Songs: Import-Dialog im Projekt oder aus dem Songs-Tab zuweisen.
• Leadsheets: 3-Punkte-Menü → „Projekt zuweisen".

Items entfernen

3-Punkte-Menü → „Entfernen" (entfernt nur die Zuordnung, nicht das Item selbst).

Setlisten

Setlisten enthalten Songs und Leadsheets in einer definierten Reihenfolge.

Items hinzufügen

1. +-Button tippen.
2. „Song hinzufügen" oder „Leadsheet hinzufügen" wählen.
3. Aus den verfügbaren Items auswählen.

Position-Nummern werden automatisch angezeigt.

The band folder import is available through the import dialog in the Songs tab:

1. Tap the + button in the Songs tab.
2. Choose "From Band Folder".
3. First time: select an iCloud folder using the iOS picker.
4. The folder contents are listed with name, size, and modification date.
5. Only audio and video files can be imported — non-supported files (PDFs, images, text files) are shown dimmed without an import button.
6. Tap the Import button next to a file.
7. A loading indicator shows the download progress.
8. Once imported, the file appears in your Library immediately.

• Change folder — tap "Change Folder" in the top right.
• Search — the search field filters the file list.

Der Band-Import ist im Import-Dialog (+-Button im Songs-Tab) verfügbar:

1. +-Button im Songs-Tab → „Aus Band-Ordner" wählen.
2. Erstmalig: iCloud-Ordner über den iOS-Picker auswählen.
3. Dateiliste zeigt Name, Größe und Änderungsdatum.
4. Nur Audio- und Video-Dateien können importiert werden — nicht unterstützte Dateien (PDFs, Bilder, Textdateien) werden ausgegraut ohne Import-Button angezeigt.
5. Import-Button neben der Datei tippen → Ladeindikator zeigt Fortschritt.
6. Importierte Datei erscheint sofort in der Bibliothek.

• Ordner wechseln — „Ordner wechseln" oben rechts tippen.
• Suche — das Suchfeld filtert die Dateiliste.

Create chord charts directly in the app — fast and intuitive using gestures.

Creating a Leadsheet

• From a song: tap the three-dot menu → "Create Leadsheet".
• Standalone: tap the + button in the Leadsheets tab.

Key & Time Signature

A circle of fifths appears when creating a new leadsheet, with colorful pie/wedge segments:

• Major keys on the outer ring, minor keys on the inner ring.
• Swipe across the keys — each highlights and enlarges as you touch it.
• Release to select the key.
• Time signature above the circle: 4/4, 3/4, 6/8, or 7/4.
• Segment colors reflect your chosen accent color from Settings.

Working with Sections

Sections represent parts of the song (Intro, Verse, Bridge, Chorus, etc.).

Section colors: sections sharing the same name (case-insensitive) automatically get the same color from an 8-slot palette. The mapping is deterministic by first appearance, so the editor, roadmap strip and Performance View always show identical colors across devices.

Entering Chords

Chords are entered from the palette at the bottom of the screen (diatonic + extended harmonies based on the selected key).

Editing Chords

After deleting a bar, a pulsing colored marker appears. The next chord swiped up fills that position automatically.

Setting BPM

• BPM is shown in the key picker area.
• Tap Tempo: tap the BPM button rhythmically — BPM is calculated automatically.
• +/− buttons adjust BPM by 1. Range: 40–240 BPM.

Playback

Play back your leadsheet with a full backing track (Piano, Bass, and Drums via General MIDI SoundFont).

BPM changes take effect immediately during playback. Double-tap a section name to start playback from that point.

Performance View

• Tap the full-screen icon in the app bar to enter Performance View.
• Chord symbols are rendered in Real Book style: full-size root + small accidental (♯/♭), superscript extensions (7, △7, add9, ♭9, ♯11, …) and subscript bass (/X) — with a constant baseline so all chords align across rows.
• Repeat counters (×2, ×3, etc.) appear prominently on the right side of each section.
• The currently playing chord is highlighted in color.
• Tap the invert button to switch between white-on-black and black-on-white.

Song Roadmap (overview strip)

• A persistent strip at the top shows every section as a colored pill — initials on iPhone, full name on iPad — so the entire song flow is visible at a glance during a hands-free performance.
• The active pill is highlighted, and a thin underline progress bar moves across it bar-by-bar in sync with the BandArranger.
• Empty sections stay visible (dimmed) so the structural overview is always complete.
• The strip auto-scrolls so the active pill is always in view.

Dynamic Row Layout & Merge Gesture

• Bars per row adapts to the device: 8 on iPad in landscape, 4 otherwise. A 5- or 6-bar section sits on a single row instead of being force-split.
• Long-press a short row and drag it up to merge it into the row above it (e.g. 4+4+2 → 4+6). A one-time onboarding banner explains the gesture; it disappears after the first successful merge or when dismissed manually.
• The Reset chip in the section header reverts the layout to the automatic distribution.
• Per-section layouts are stored with the leadsheet and synced.

Volta Endings in Performance View

• 1st and 2nd endings appear as their own colored rows underneath the body bars (amber for 1st, accent color for 2nd).
• During playback the highlight automatically follows the volta path.

Song Flow (explicit play order)

• A compact flow preview bar sits above the section dashboard in the editor: small colored mini-pills show the current order including repeats, with an Edit chip on the right.
• Tapping the bar opens the dedicated Song Flow Editor:
  • Drag-to-reorder of sections, remove individual entries.
  • + Section FAB to append a section to the flow (the picker shows bar count and any 1st/2nd ending markers).
  • Default reset button (top right, only visible when a custom flow is set).
  • An empty list collapses back to the implicit default ("each section once, in editor order").
• Why it exists: a chorus played 3 times is now stored as one section and listed three times in the flow — instead of duplicating chord data across three identical sections.

Photo Import (OCR)

Import handwritten or printed lead sheets by photo:

1. Tap the camera icon in the key picker (circle of fifths).
2. Take a photo or choose one from your gallery.
3. The OpenAI Vision API analyzes the image automatically.
4. A preview shows the recognized key, sections, and chords.
5. Tap Import to apply.

Recognized elements: Chord symbols (Cm, D7, G7, E♭△7, Aø7, etc.), section markers (A, B, Intro, Verse, Chorus, Bridge), repeat counters (2×, 3×, 4×), repeat signs (./. or %), bar lines, and style hints (Medium Swing, Bossa, etc.).

Saving

• Save: tap the save icon (top right). The leadsheet is stored with key, time signature, BPM, and style.
• Song and project links are preserved when saving.
• If you leave without saving, a dialog asks to Save / Discard / Cancel.

Erstelle Akkordblätter direkt in der App — schnell und intuitiv per Gesten.

Leadsheet erstellen

• Aus Song-Kontextmenü: 3-Punkte-Menü eines Songs → „Leadsheet erstellen".
• Global: +-Button im Leadsheets-Tab.

Tonart & Takt wählen

Ein Quintenzirkel erscheint beim Erstellen, neu designt mit farbigen Tortenstück-Segmenten:

• Dur-Tonarten im äußeren Ring, Moll im inneren Ring.
• Wisch-Geste: Finger über die Tonarten wischen — jede leuchtet auf und wird größer.
• Loslassen wählt die Tonart aus.
• Taktangabe oberhalb des Quintenzirkels: 4/4, 3/4, 6/8, 7/4.
• Farben spiegeln das gewählte App-Farbschema wider.

Sections bearbeiten

Sections repräsentieren Teile des Songs (Intro, Strophe, Bridge, Chorus, etc.).

Section-Farben: Sections gleichen Namens (case-insensitive) bekommen automatisch dieselbe Farbe aus einer 8er-Palette. Die Zuordnung ist deterministisch nach Reihenfolge des ersten Auftretens, sodass Editor, Roadmap-Strip und Performance View geräteübergreifend identisch aussehen.

Akkorde eingeben

Akkorde aus der Palette am unteren Bildschirmrand (diatonische + erweiterte Harmonien).

Akkorde bearbeiten

Nach dem Löschen eines Takts erscheint ein farbig pulsierender Marker. Der nächste hochgewischte Akkord füllt diese Position automatisch.

BPM & Tempo

• BPM wird im Tonart-Wähler angezeigt.
• Tap Tempo: Rhythmisch auf den BPM-Button tippen → BPM wird automatisch berechnet.
• +/− Buttons ändern BPM um ±1. Bereich: 40–240.

Wiedergabe

Leadsheet mit vollständigem Backing-Track abspielen (Piano, Bass und Drums via General MIDI SoundFont).

BPM-Änderungen werden sofort übernommen. Doppelklick auf Section-Name startet ab dieser Stelle.

Performance View

• Vollbild-Icon in der AppBar aktiviert den Performance View.
• Akkord-Symbole werden im Real-Book-Stil gerendert: Root in voller Größe + kleine Akzidens (♯/♭), hochgestellte Extension (7, △7, add9, ♭9, ♯11, …) und tiefgestellter Bass (/X) — mit einheitlicher Baseline, damit alle Akkorde sauber auf einer Linie liegen.
• Repeat-Zähler (×2, ×3, etc.) prominent am rechten Rand.
• Aktuell gespielter Akkord wird farbig hervorgehoben.
• Invertierungs-Button wechselt zwischen Weiß-auf-Schwarz und Schwarz-auf-Weiß.

Song-Roadmap (Strip am oberen Rand)

• Persistenter Streifen am oberen Rand zeigt jede Section als farbige Pille — Initialen auf iPhone, voller Name auf iPad — sodass die gesamte Songstruktur im Live-Betrieb auf einen Blick erkennbar ist.
• Die aktive Pille ist hervorgehoben; ein dünner Progress-Underline läuft pro Bar synchron mit dem BandArranger.
• Leere Sections bleiben sichtbar (gedimmt), damit der Überblick immer komplett ist.
• Auto-Scroll: die aktive Pille bleibt immer im sichtbaren Bereich.

Dynamisches Row-Layout & Merge-Geste

• Takte pro Reihe skalieren mit dem Gerät: 8 auf iPad-Landscape, 4 sonst. Eine 5- oder 6-Takt-Section bleibt auf einer Reihe statt zwangsweise gesplittet zu werden.
• Kurze Reihe lange drücken und nach oben ziehen, um sie mit der Reihe darüber zu verschmelzen (z. B. 4+4+2 → 4+6). Ein einmaliger Onboarding-Banner erklärt die Geste; er verschwindet nach dem ersten erfolgreichen Merge oder per Manual-Dismiss.
• Reset-Chip im Section-Header setzt das Layout wieder auf die automatische Verteilung zurück.
• Pro-Section-Layouts werden mit dem Leadsheet gespeichert und gesynct.

Volta-Endings im Performance View

• 1. und 2. Klammer erscheinen als eigene farblich abgesetzte Reihen unterhalb der Body-Takte (Amber für 1., Akzentfarbe für 2.).
• Beim Abspielen folgt der Highlight automatisch dem Volta-Pfad.

Song-Flow (explizite Reihenfolge)

• Eine kompakte Flow-Preview-Bar sitzt über dem Section-Dashboard im Editor: kleine farbige Mini-Pillen zeigen die aktuelle Reihenfolge inkl. Wiederholungen, daneben rechts ein Edit-Chip.
• Tap auf die Bar öffnet den dedizierten Song-Flow-Editor:
  • Drag-to-Reorder von Sections, einzelne Einträge entfernen.
  • + Section-FAB zum Anhängen einer Section an den Ablauf (Picker zeigt Takt-Anzahl und ggf. „1st"/„2nd"-Markierungen).
  • Standard-Reset-Button rechts oben (nur sichtbar wenn ein Custom-Flow gesetzt ist).
  • Eine leere Liste fällt automatisch zurück auf den impliziten Default („jede Section einmal in Editor-Reihenfolge").
• Sinn der Funktion: ein Refrain ×3 wird einmal als Section angelegt und im Flow dreimal eingetragen — statt drei identische Sections mit gleichen Akkorden zu pflegen.

Foto-Import (OCR)

Handgeschriebene oder gedruckte Leadsheets per Foto importieren:

1. Kamera-Icon im Quintenzirkel antippen.
2. Foto aufnehmen oder aus Galerie wählen.
3. OpenAI Vision API analysiert das Bild automatisch.
4. Vorschau zeigt erkannte Tonart, Sections und Akkorde.
5. Importieren übernimmt das Leadsheet.

Erkannte Elemente: Akkord-Symbole (Cm, D7, G7, E♭△7, Aø7, etc.), Section-Marker (A, B, Intro, Verse, Chorus, Bridge), Repeat-Zähler (2×, 3×, 4×), Repeat-Zeichen (./. oder %), Taktstriche und Stilistik-Hinweise.

Speichern

• Speichern: Speichern-Icon oben rechts. Leadsheet wird mit Tonart, Taktangabe, BPM und Stilistik gespeichert.
• Song- und Projekt-Verknüpfungen bleiben beim Speichern erhalten.
• Beim Verlassen ohne Speichern → Warndialog mit „Speichern" / „Verwerfen" / „Abbrechen".

Share leadsheets with other GuitarPT users or back them up as files.

Exporting a Single Leadsheet

1. Tap the three-dot menu (⋮) on a leadsheet.
2. Choose "Export".
3. A .guitarpt.json file is shared via the iOS Share Sheet (AirDrop, Mail, Files, etc.).

Exporting All Leadsheets in a Project

1. Open a project's detail view.
2. Tap the upload icon in the top bar.
3. All leadsheets in the project are bundled into a .guitarpt.zip file and shared via the Share Sheet.

Importing Leadsheets

1. Tap the + button.
2. Choose "Import Leadsheet".
3. Pick a .json or .zip file from your device.
4. The leadsheet(s) are added to your library.

The JSON format includes: title, key, time signature, BPM, style, sections, bars, and chords.

Leadsheets mit anderen GuitarPT-Nutzern teilen oder als Dateien sichern.

Einzelnes Leadsheet exportieren

1. 3-Punkte-Menü (⋮) am Leadsheet.
2. „Exportieren" wählen.
3. Eine .guitarpt.json-Datei wird über das iOS Share-Sheet geteilt (AirDrop, Mail, Dateien, etc.).

Alle Leadsheets eines Projekts exportieren

1. Projekt-Detail öffnen.
2. Upload-Icon in der oberen Leiste tippen.
3. Alle Leadsheets des Projekts werden als .guitarpt.zip exportiert und über das Share-Sheet geteilt.

Leadsheets importieren

1. +-Button tippen.
2. „Leadsheet importieren" wählen.
3. .json- oder .zip-Datei auswählen.
4. Leadsheet(s) werden in die Bibliothek importiert.

Das JSON-Format enthält: Titel, Tonart, Taktart, BPM, Stilistik, Sections, Takte und Akkorde.

Record ideas or practice sessions directly in the app.

1. Open the Songs tab and tap the microphone icon (top right).
2. Tap the large button to start recording.
3. A live waveform scrolls as you record; the timer shows elapsed time (red = recording active).
4. Tap again to stop.

After Recording

If you close without saving, the temporary file is automatically deleted.

Ideen oder Übungssessions direkt in der App aufnehmen.

1. Tab Songs → Mikrofon-Symbol oben rechts.
2. Großen Button drücken zum Aufnahme starten.
3. Wellenform läuft live mit, Timer zeigt verstrichene Zeit (rot = Aufnahme läuft).
4. Nochmal drücken zum Stoppen.

Nach der Aufnahme

Schließen ohne Speichern → temporäre Datei wird automatisch gelöscht.

GuitarPT keeps your library in sync across all your devices through Apple CloudKit. Both metadata (songs, projects, markers, leadsheets, setlists) and the actual media files (audio, video, photos) travel through your private iCloud space — nothing is sent to any third-party server.

Turning Sync On

1. Open Settings (gear icon, top right of the library).
2. Toggle iCloud Sync on.
3. The first sync starts automatically and pulls everything that already exists in iCloud.

What Gets Synced

Cloud Status Badge

In the Songs library every row shows a small cloud icon next to the date that tells you whether the file is on this device:

The badge updates automatically after every sync, heal pass, or download — you don't have to refresh the list manually.

Download on Demand

Opening a song whose file is only in iCloud automatically downloads it before playback. You can also start a download manually by tapping the cloud icon.

Healing & Recovery Tools

After every sync, an automatic heal pass detects songs with a local file but no cloud copy and queues them for the next push.

Storage View & Sync Log

• Storage usage broken down into Local, In iCloud, and Pending.
• Sync history — a scrollable log of every sync run with timestamp and status, useful for diagnosing problems.

GuitarPT hält deine Bibliothek über Apple CloudKit auf allen deinen Geräten synchron. Sowohl Metadaten (Songs, Projekte, Marker, Leadsheets, Setlisten) als auch die Mediendateien (Audio, Video, Fotos) laufen durch deinen privaten iCloud-Bereich — nichts geht an fremde Server.

Sync aktivieren

1. Einstellungen öffnen (Zahnrad-Symbol oben rechts in der Bibliothek).
2. iCloud Sync einschalten.
3. Der erste Sync startet automatisch und holt alles ab, was bereits in iCloud liegt.

Was wird synchronisiert

Cloud-Status-Badge

In der Songs-Bibliothek zeigt jede Zeile neben dem Datum ein kleines Wolken-Symbol, das den Verfügbarkeitsstatus anzeigt:

Das Badge aktualisiert sich automatisch nach jedem Sync-, Heal- oder Download-Lauf — kein manuelles Aktualisieren nötig.

Download bei Bedarf

Wird ein Song geöffnet, dessen Datei nur in iCloud liegt, wird sie automatisch vor der Wiedergabe heruntergeladen. Manuell startest du einen Download durch Tippen auf das Cloud-Symbol.

Heilung & Recovery

Nach jedem Sync läuft automatisch ein Heal-Pass, der Songs mit lokaler Datei aber ohne Cloud-Kopie erkennt und für den nächsten Push einreiht.

Speicheranzeige & Sync-Protokoll

• Speicheranzeige getrennt nach Lokal, In iCloud und Ausstehend.
• Sync-Historie — scrollbare Liste aller Sync-Läufe mit Zeitstempel und Status, hilfreich zur Fehlerdiagnose.

Open the Settings via the gear icon (⚙) in the top-right corner of the library. The screen is one long scroll: theme on top, sync & AI-related settings below, app info at the bottom.

Accent Color

Five themes are available — the colour is applied across every screen: buttons, highlights, the chord-ribbon cells, the circle-of-fifths segments, key-change markers, and more.

• Warm Gold (default), Blue, Copper, Violet, Teal

Your choice persists across app restarts.

Language

The app follows your iOS / iPadOS system language automatically. English and German are fully supported. Switch your device language in Settings → General → Language & Region and GuitarPT picks it up on the next launch.

Audio Analysis

Turn it off if you only need the player for playback, looping or recording without the analysis overhead.

iCloud Sync

Status header showing whether sync is active, how much storage is used in iCloud, and how many songs / leadsheets are pushed up vs. pending. Recovery actions live in the same card:

• Re-upload media files — re-queues any audio/video file whose local copy diverged from iCloud.
• Recover from iCloud Drive — pulls orphaned files in the iCloud container back into the library as fresh songs.
• Import orphaned iCloud files as songs — wraps stray files without local copies as new songs (asks first).
• Show cloud content (diagnosis) — a read-only dump of what's currently in your iCloud container, useful for spotting accidental duplicates.
• Cloud reset & resync — wipes the cloud and uploads everything from this device again. Last-resort fix for sync drift; takes a few minutes.

See Chapter 13 (iCloud Sync) for the full story.

Leadsheet Photo Import (OpenAI API Key)

An OpenAI API key powers the photo-to-leadsheet OCR import (Chapter 10). Without a key the OCR features are simply hidden — everything else continues to work.

• Get a key at platform.openai.com → API keys. Expect a few cents per OCR pass.
• The key is stored encrypted on-device and is also re-used for the LLM Interpretation feature below.

LLM Interpretation (experimental)

Adds a music-theory layer on top of the regular chord analysis: key, mode, Roman numerals, sections (verse / chorus / …), and modulations. The chord events themselves are never modified — this is strictly an enrichment pass.

Runs only on songs that went through the Mac analysis pipeline (see Chapter 4). Costs roughly 1–3 cents per song.

Once the interpretation has run, switch the chord ribbon to the Theory layer in the player to see Roman numerals, T/SD/D function pins, and key-change markers along the ribbon.

About

The footer card shows the app version + build, links to this manual, the privacy policy, and the open-source licences used by the app.

Einstellungen sind über das Zahnrad-Symbol (⚙) oben rechts in der Bibliothek erreichbar. Der Screen ist eine durchgängige Scroll-Liste: Theme oben, Sync- und AI-bezogene Optionen in der Mitte, App-Infos unten.

Akzentfarbe

Fünf Themes verfügbar — die Farbe wird überall in der App angewendet: Buttons, Highlights, Chord-Ribbon-Zellen, Quintenzirkel-Segmente, Tonartwechsel-Marker und mehr.

• Warm Gold (Standard), Blue, Copper, Violet, Teal

Die Auswahl bleibt über App-Neustarts hinweg erhalten.

Sprache

Die App folgt automatisch der iOS-/iPadOS-Systemsprache. Englisch und Deutsch sind vollständig unterstützt. Sprache änderst du unter Einstellungen → Allgemein → Sprache & Region, GuitarPT übernimmt das beim nächsten Start.

Audio-Analyse

Praktisch, wenn du den Player nur für Wiedergabe, Loops oder Aufnahme nutzt.

iCloud Sync

Status-Karte mit aktuellem Sync-Zustand, iCloud-Speicherverbrauch und der Anzahl bereits hochgeladener bzw. noch ausstehender Songs/Leadsheets. Recovery-Aktionen sind in derselben Karte:

• Medien neu hochladen — stellt Audio/Video-Dateien neu in die Upload-Queue, deren lokale Kopie von iCloud abweicht.
• Aus iCloud Drive wiederherstellen — holt verwaiste Dateien aus dem iCloud-Container als frische Songs zurück.
• Verwaiste iCloud-Dateien als Songs importieren — verpackt herumliegende Dateien ohne lokale Kopie als neue Songs (Sicherheitsabfrage).
• Cloud-Inhalte anzeigen (Diagnose) — Read-only-Übersicht, was aktuell im iCloud-Container liegt. Hilft beim Aufspüren von Duplikaten.
• Cloud zurücksetzen & neu syncen — leert die Cloud und lädt von diesem Gerät alles erneut hoch. Last-Resort-Fix bei Sync-Drift, dauert ein paar Minuten.

Vollständige Beschreibung in Kapitel 13 (iCloud Sync).

Leadsheet-Foto-Import (OpenAI API Key)

Der OpenAI-API-Key treibt den Foto-zu-Leadsheet-Import per OCR (Kapitel 10). Ohne Key sind die OCR-Funktionen einfach versteckt — alles andere läuft weiter.

• Key unter platform.openai.com → API keys erstellen. Pro OCR-Lauf ein paar Cent.
• Der Key wird verschlüsselt auf dem Gerät gespeichert und auch für die LLM-Interpretation unten weiterverwendet.

LLM-Interpretation (experimentell)

Erweitert die normale Akkordanalyse um eine Musiktheorie-Schicht: Tonart, Modus, Stufenanalyse (Roman Numerals), Sektionen (Verse / Chorus / …) und Modulationen. Die Akkorde selbst werden dabei nie verändert — es ist rein additiv.

Funktioniert nur für Songs, die durch die Mac-Analyse-Pipeline gelaufen sind (siehe Kapitel 4). Kosten ca. 1–3 Cent pro Song.

Nach erfolgter Interpretation im Player über den Layer-Umschalter auf Theorie wechseln — dann zeigt das Ribbon Roman Numerals, T/SD/D-Funktions-Pins und Tonartwechsel-Marker.

Über

Die Footer-Karte zeigt App-Version + Build, Links zu diesem Handbuch, der Datenschutzerklärung und den Open-Source-Lizenzen.

Video files (MP4, MOV) are fully supported. The video fills the available area and the waveform is overlaid at the bottom (semi-transparent). Video thumbnails in the library are captured at the 5-second mark for more meaningful preview images.

All features — markers, loops, speed, zoom, BPM, chords — work identically to audio mode. Transpose is not available for video.

Video-Specific Controls

Videodateien (MP4, MOV) werden direkt unterstützt. Das Video füllt den gesamten verfügbaren Bereich und die Wellenform wird halbtransparent über das Video gelegt (unten). Video-Thumbnails in der Bibliothek werden bei Sekunde 5 generiert für aussagekräftigere Vorschaubilder.

Alle Funktionen — Marker, Loop, Speed, Zoom, BPM, Akkorde — funktionieren identisch wie bei Audio. Transpose ist im Video-Modus nicht verfügbar.

Video-Steuerung