# Tonaly - User guide

## Tonaly - User guide

- [Welcome](https://guide.tonaly.app/master.md): Welcome to the Tonaly user guide for iOS, iPad and macOS. Here you can find information and video tutorials about using Tonaly.
- [General information](https://guide.tonaly.app/general/general-info.md)
- [Difference between the three app workspaces](https://guide.tonaly.app/general/general-info/what-is-the-difference-between-the-three-app-modes.md)
- [Circle of fifths](https://guide.tonaly.app/general/general-info/circle-of-fifths.md)
- [Popular songs](https://guide.tonaly.app/general/general-info/where-do-i-find-popular-songs.md)
- [Colors](https://guide.tonaly.app/general/general-info/colors.md)
- [Change the playback sound](https://guide.tonaly.app/general/general-info/change-the-playback-sound.md)
- [Enharmonic equivalents](https://guide.tonaly.app/general/general-info/enharmonic-equivalents.md)
- [Android App](https://guide.tonaly.app/general/general-info/android-app.md)
- [New app name](https://guide.tonaly.app/general/general-info/new-app-name.md)
- [Tuner](https://guide.tonaly.app/general/general-info/tuner.md)
- [Background audio mode](https://guide.tonaly.app/general/general-info/background-mode.md)
- [Display hints again](https://guide.tonaly.app/general/general-info/display-hints-again.md)
- [Keyboard shortcuts](https://guide.tonaly.app/general/keyboard-shortcuts.md): For macOS and iPad with connected keyboard (from version 3.4.0)
- [How to compose](https://guide.tonaly.app/songwriting/how-to-compose.md): In this guide, I'll walk you through the workflow of composing with the app. This is just one approach, so don't worry if your workflow looks different...
- [Start a new song](https://guide.tonaly.app/songwriting/start-new-song.md)
- [Song settings](https://guide.tonaly.app/songwriting/song-settings.md)
- [Change the key of a song](https://guide.tonaly.app/songwriting/song-settings/change-key-of-song.md)
- [Change song to minor](https://guide.tonaly.app/songwriting/song-settings/change-song-to-minor.md): You can change the mode of the song to mi
- [Change the tempo](https://guide.tonaly.app/songwriting/song-settings/change-tempo.md)
- [Change the time signature](https://guide.tonaly.app/songwriting/song-settings/change-time-signature.md)
- [Modulation](https://guide.tonaly.app/songwriting/song-settings/modulation.md)
- [Edit a chord](https://guide.tonaly.app/songwriting/edit-a-chord.md)
- [Enter the chord edit mode](https://guide.tonaly.app/songwriting/edit-a-chord/add-optional-tones-to-a-certain-chord.md): Create chords like: Cm7, D13, Gsus4, G/B...
- [Change root note](https://guide.tonaly.app/songwriting/edit-a-chord/change-root-note.md)
- [Change quality](https://guide.tonaly.app/songwriting/edit-a-chord/edit.md)
- [Add chord extensions like 7th, 9th etc.](https://guide.tonaly.app/songwriting/edit-a-chord/add-optional-tones.md)
- [Get a chord suggestion](https://guide.tonaly.app/songwriting/edit-a-chord/get-a-chord-suggestion.md)
- [Mute a chord](https://guide.tonaly.app/songwriting/edit-a-chord/mute-a-chord.md)
- [Create a slash chord](https://guide.tonaly.app/songwriting/edit-a-chord/create-a-slash-chord.md)
- [Add more chords to a bar](https://guide.tonaly.app/songwriting/edit-a-chord/add-more-chords-to-a-bar.md): You can add up to four chords to each bar (needs app version 3.4.4 or greater)
- [Adjust the chord length](https://guide.tonaly.app/songwriting/edit-a-chord/adjust-the-chord-length.md)
- [Long-press a chord](https://guide.tonaly.app/songwriting/edit-a-chord/long-press-a-chord.md)
- [Copy & Paste chords](https://guide.tonaly.app/songwriting/edit-a-chord/copy-and-paste-chords.md): This feature is available for iOS from app version 3.5.2
- [Step out of the key](https://guide.tonaly.app/songwriting/step-out-of-the-key.md)
- [In theory: Borrow a chord](https://guide.tonaly.app/songwriting/step-out-of-the-key/borrow-a-chord.md): What does this mean, "borrow a chord"?
- [In the app: Borrow a chord](https://guide.tonaly.app/songwriting/step-out-of-the-key/in-the-app-borrow-a-chord.md): How do I use "borrowed chords" within the TONALY app?
- [Chord statistics](https://guide.tonaly.app/songwriting/step-out-of-the-key/chord-statistics.md): See statistics of tones in- and out-of-key, related to the mode of your song.
- [Chord suggestions](https://guide.tonaly.app/songwriting/step-out-of-the-key/chord-suggestions.md)
- [Edit song structure](https://guide.tonaly.app/songwriting/edit-song-structure.md)
- [Add or delete lines and parts](https://guide.tonaly.app/songwriting/edit-song-structure/add-or-delete-lines-and-parts.md)
- [Add or delete bars](https://guide.tonaly.app/songwriting/edit-song-structure/add-or-delete-bars.md): How to add or delete bars/measures from a song
- [Add or delete chords from a bar](https://guide.tonaly.app/songwriting/edit-song-structure/add-or-delete-chords-from-a-bar.md)
- [Adjust the chord length](https://guide.tonaly.app/songwriting/edit-song-structure/adjust-the-chord-length.md)
- [Drag and drop lines and parts](https://guide.tonaly.app/songwriting/edit-song-structure/drag-and-drop-lines-and-parts.md): This feature is available from app version 3.2.7 (which is currently in beta testings)
- [Change the name of a part](https://guide.tonaly.app/songwriting/edit-song-structure/change-the-name-of-a-part.md): This feature is available from app version 3.2.7 (which is currently in beta testings)
- [Repeat lines, loop parts](https://guide.tonaly.app/songwriting/edit-song-structure/repeat-lines-loop-parts.md)
- [Maximum song length](https://guide.tonaly.app/songwriting/edit-song-structure/maximum-song-length.md)
- [Playback settings](https://guide.tonaly.app/songwriting/playback-settings.md)
- [Metronome](https://guide.tonaly.app/songwriting/playback-settings/metronome.md)
- [Octave of the payback](https://guide.tonaly.app/songwriting/playback-settings/octave-of-the-payback.md)
- [Change the playback sound](https://guide.tonaly.app/songwriting/playback-settings/change-the-playback-sound.md)
- [Loop song](https://guide.tonaly.app/songwriting/playback-settings/loop-song.md)
- [Display settings](https://guide.tonaly.app/songwriting/display-settings.md)
- [Undo & redo changes](https://guide.tonaly.app/songwriting/undo-redo.md)
- [Save song](https://guide.tonaly.app/songwriting/save-song.md)
- [Song templates](https://guide.tonaly.app/songwriting/song-templates.md)
- [MIDI](https://guide.tonaly.app/export/midi.md)
- [PDF Lead sheet](https://guide.tonaly.app/export/pdf-leadsheet.md)
- [Share song](https://guide.tonaly.app/export/share-song.md)
- [Open songs in ChordButter app](https://guide.tonaly.app/export/open-songs-in-chordbutter-app.md): Starting with app version 3.6.4 you can open Tonaly songs in the ChordButter app
- [Export saved songs](https://guide.tonaly.app/export/export-saved-songs.md)
- [Learn and practice scales](https://guide.tonaly.app/scales-and-modes/learn-and-practice-scales.md)
- [What is the difference between scales and modes?](https://guide.tonaly.app/scales-and-modes/what-is-the-difference-between-scales-and-modes.md)
- [Traditional "Circle of fifths"](https://guide.tonaly.app/scales-and-modes/traditional-circle-of-fifths.md)
- [Change key of scale](https://guide.tonaly.app/scales-and-modes/change-key-of-scale.md)
- [Change scale](https://guide.tonaly.app/scales-and-modes/untitled.md)
- [Included scales](https://guide.tonaly.app/scales-and-modes/additional-scales.md): Find a list of included scales here
- [Display note names next to scale](https://guide.tonaly.app/scales-and-modes/display-note-names-next-to-scale.md)
- [Display intervals next to scale](https://guide.tonaly.app/scales-and-modes/display-intervals-next-to-scale.md)
- [Display the instrument](https://guide.tonaly.app/instrument/display-instrument.md)
- [Switch the instrument](https://guide.tonaly.app/instrument/switch-instrument.md)
- [Fullscreen mode](https://guide.tonaly.app/instrument/fullscreen.md)
- [Display staff next to the instrument](https://guide.tonaly.app/instrument/display-staff-on-instrument.md)
- [Piano](https://guide.tonaly.app/instrument/piano.md)
- [Interactive piano](https://guide.tonaly.app/instrument/piano/interactive-piano.md)
- [Display key](https://guide.tonaly.app/instrument/piano/display-key.md)
- [String instruments](https://guide.tonaly.app/instrument/string-instruments.md)
- [Position of scale](https://guide.tonaly.app/instrument/string-instruments/position-of-scale.md)
- [Alternate chord position](https://guide.tonaly.app/instrument/string-instruments/alternate-chord-position.md)
- [Change tuning](https://guide.tonaly.app/instrument/string-instruments/change-tuning.md)
- [Reset to standard tuning](https://guide.tonaly.app/instrument/string-instruments/reset-to-standard-tuning.md)
- [Left-hand fretboard](https://guide.tonaly.app/instrument/string-instruments/left-hand-fretboard.md)
- [Display key](https://guide.tonaly.app/instrument/string-instruments/display-key.md)
- [Restore purchases](https://guide.tonaly.app/pro-access/restore-purchases.md): Learn how to unlock all features of the app
- [Musical preferences](https://guide.tonaly.app/settings/musical-preferences.md)
- [Navigate to musical preferences](https://guide.tonaly.app/settings/musical-preferences/untitled.md)
- [Auto inversions (voice-leading)](https://guide.tonaly.app/settings/musical-preferences/auto-voice-leading.md): Default setting: ON; Octave: C3
- [Change octave of playback](https://guide.tonaly.app/settings/musical-preferences/change-octave-of-playback.md)
- [Use 4-note chords](https://guide.tonaly.app/settings/musical-preferences/use-4-note-chords.md): Default setting: OFF
- [Transpose playback](https://guide.tonaly.app/settings/musical-preferences/transpose-playback.md): Default setting: OFF
- [Small minor chords](https://guide.tonaly.app/settings/musical-preferences/small-minor-chords.md): Default setting: OFF
- [Use german note names](https://guide.tonaly.app/settings/musical-preferences/use-german-note-names.md): Default setting: OFF if you are not located in Germany, else the default setting is ON
- [Numerals](https://guide.tonaly.app/settings/musical-preferences/numerals.md): Default numerals type: "Roman"; Default Numerals relation: "Relative to root note..."
- [App settings](https://guide.tonaly.app/settings/app-settings.md)
- [Navigate to app settings](https://guide.tonaly.app/settings/app-settings/navigate-to-app-settings.md)
- [Playback chord on tap](https://guide.tonaly.app/settings/app-settings/playback-chord-on-tap.md): Default setting: ON
- [Color themes](https://guide.tonaly.app/settings/app-settings/color-themes.md): Default setting: Dark
- [Animate playback](https://guide.tonaly.app/settings/app-settings/animate-playback.md): Default setting: ON
- [Shake gesture](https://guide.tonaly.app/settings/app-settings/shake-gesture.md): Default setting: ON
- [Change language](https://guide.tonaly.app/settings/app-settings/change-language.md)
- [iCloud](https://guide.tonaly.app/settings/app-settings/icloud-sync.md): Default setting: ON; Available from version 3.2.0
- [App plays in background](https://guide.tonaly.app/settings/app-settings/app-plays-in-background.md): Default setting: OFF; Available from version 3.4.0
- [Core-MIDI-Out](https://guide.tonaly.app/midi/core-midi-out.md): This is a Tonaly Pro feature only
- [The circle displays 4-note chords such as Gm7 or C△](https://guide.tonaly.app/troubleshooting/the-circle-displays-4-note-chords-such-as-gm7-or-c.md)
- [The circle displays "H" instead of "B"](https://guide.tonaly.app/troubleshooting/the-circle-displays-h-instead-of-b.md)
- [The app asks me to pay again](https://guide.tonaly.app/troubleshooting/the-app-asks-me-to-pay-again.md): The app prompts me to pay even though I already paid to download it.
- [Wrong playback notes](https://guide.tonaly.app/troubleshooting/wrong-playback-notes.md)
- [Only colors visible in the song](https://guide.tonaly.app/troubleshooting/only-colors-visible-in-the-song.md)
- [Lost saved songs after updating](https://guide.tonaly.app/troubleshooting/lost-saved-songs-after-updating.md): Available from version 3.2.0
- [Lost saved songs after syncing with iCloud](https://guide.tonaly.app/troubleshooting/lost-saved-songs-after-syncing-with-icloud.md): Available from version 3.2.0
- [Error loading the app](https://guide.tonaly.app/troubleshooting/error-loading-the-app.md)
- [Blank screen after app logo](https://guide.tonaly.app/troubleshooting/blank-screen-after-app-logo.md)
- [Performance of app is slow](https://guide.tonaly.app/troubleshooting/performance-of-app-is-slow.md)
- [Core-MIDI with Ableton Live](https://guide.tonaly.app/troubleshooting/core-midi-with-ableton-live.md)
- [Reset the app to the initial state](https://guide.tonaly.app/troubleshooting/reset-the-app-to-the-initial-state.md)
- [Useful links](https://guide.tonaly.app/further-infos/useful-links.md)
- [Contact](https://guide.tonaly.app/further-infos/contact.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on a page URL with the `ask` query parameter:
```
GET https://guide.tonaly.app/master.md?ask=<question>
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.