The settings pane is divided into sections, each controlling a different aspect of Chordle. Tap a section to expand it.

Exporting, importing and sharing settings
The Import, Export and Share buttons at the top of the settings page let you copy your settings to another device, keep a backup, or pass them on to other Chordle users.
Exporting and sharing
Tap Export to save your settings to a file, or Share to send them straight to someone else or to another of your devices. Either way, Chordle asks which settings sections to include. Everything is selected to begin with: untick any sections you don’t want, so you can share just your song color theme or your instruments, for example.

The settings are saved as a .cdlsettings file. When you include the Instruments section, your own instruments go with it, so the file is all you need to set them up on another device.
Importing
Tap Import and pick a .cdlsettings file. On Windows and Android you can also open the file with Chordle. Chordle shows the sections in the file, so you can choose which ones to apply; the settings in those sections replace your current ones, and the rest stay as they are.
Once the import is done, Chordle tells you how many settings were imported. Any values in the file that couldn’t be used are listed, and those settings keep their current values.
Interface
Controls the general look and feel of Chordle:
- UI theme - choose Light theme, Dark theme or Use system theme.
- List density - adjust the text size and spacing of the song and set list rows in your libraries. Compact shrinks the font and padding to fit more on screen, Sparse gives each row more room, and Normal is the default.
- Set list position - choose where the currently playing set list appears: Bottom (with player controls), or Left or Right so it stays beside your library. Not shown on phones. See Docking the set list.
- Force edge to edge display (Android only) - use the whole screen, ignoring camera cutouts.
- Show navigation labels - show or hide the text labels beneath the navigation bar icons.
- Enable animations - animate page transitions and other interface elements. Turn this off if animations feel distracting or slow on your device.
- Show fullscreen quick search button - show a quick search button when in full screen. The keyboard shortcut (
Ctrl + F) always works regardless of this setting. - Take over the screen when playing (Windows only) - fill the whole screen when you play a song, hiding the title bar and taskbar. Turn this off to keep Chordle in its window so you can see your other apps - the song still fills the window either way. On a phone or tablet there’s no window to stay in, so playing always fills the screen and this option isn’t shown. See Playing songs.
- Always hide the library when playing - hide the song library and set list every time you start playing, even if you had them showing last time. Turn this off to keep them however you last left them. Either way, the reveal button on the player shows and hides them. See Playing songs.
- Require double tap to change songs - when enabled, you double-tap the edges of the screen to change songs or pages, so a stray tap doesn’t move you on.
- Double-tap set list - choose what happens when you double-tap a set list in the library: Open for editing or Start the set list.
Song presentation
Controls how songs are displayed when you’re playing them:
- Song layout - choose between different layout styles for presenting songs. See Song presentation modes for more information.
- Capo reminder - choose whether songs played with a capo show a reminder: Show and animate, Show or Do not show.
- Always show uncapoed chords - when enabled, the underlying (uncapoed) chords are shown instead of the capoed ones, whatever the capo position. Turn it off to see the chord shapes you play with the capo on. See Capoed chords.
- Reduce slash chords when only bass note changes - simplifies consecutive slash chords by showing only the changing bass note. For example,
G/B G/F♯becomesG/B /F♯. - Display notation - choose how chords are shown: Standard (
A B C D E F G), German (A H C D E F G), Latin (DO RE MI FA SOL LA SI), Nashville Number System or Roman numerals. Songs can be written in any notation, and this only changes how they’re shown. See Chord notation. - Chord grid style - choose whether chord grids are drawn with thin barlines (Flat) or with each bar as a panel (Blocks).
- Show section headers - show or hide section labels such as Verse and Chorus.
- Lyrics only - hide chords, tablature and chord grids, showing only the lyrics.
- Text style - choose Modern or Typewriter. Typewriter uses a fixed-width font, which guarantees chords line up exactly as they were written in chords above text.
- Text size - set your preferred font size. If the song text is too large to fit on screen, it’s scaled down.
- Chord spacing - set the minimum gap between adjacent chords on the same line.
- Chord overlap mode - choose what happens when a chord is wider than the lyrics under it: Hyphenate words or Move chords. See Chord overlap mode.
- Connect split words - with Hyphenate words, draw a line across the gap when a chord splits a word.
- Minimum join line length - with Hyphenate words, set the shortest line drawn across a split word.
Song header
Shows details such as the title, key and tempo at the top of every song:
- Show song header - turn the header on or off.
- Alignment - place the header on the left, in the center or on the right.
- Position - for fit-to-screen and paginated songs, show the header with the song, or across the top or bottom of the page.
- Text size - set the size of a header at the top or bottom of the page.
- Header template - choose what the header shows. Use the Insert and Format menus below the template to add song values and formatting, and Reset to default to start again.
See Song header for how to write a template.
External monitor
(Windows only) Controls a second screen presentation while you perform. See External monitor for full details.
- Show Present button - show a button in the song player to start a presentation on an external display.
- Presentation mode - choose Lyrics only or Replicate display.
- Hide song notes - with Replicate display, keep song comments and notes off the external display.
- Custom font size - set a separate Font size for the external display.
Editing
- Song editing format - choose whether the song editor opens songs as Chords above text or ChordPro.
- When pasting tab characters - tab characters can throw chords out of line, so the editor changes them when you paste. Choose Strip tabs, Replace with single space or Replace with 4 spaces.
See Editing songs for more on the song editor.
Annotations
Controls ink annotation behavior. See Ink annotations for full details.
- Show annotations - display saved ink annotations on songs. When disabled, the annotate button is also hidden.
- Default annotation scope - choose where annotations are saved when you annotate a song in a set list: Choose every time, Save to set list or Always save to song.
Metronome
Controls the visual and audio metronome. See Visual metronome and Audio metronome for full details.
- Enable audio metronome - play a sound on each beat while a song with a tempo is playing.
- Only play in fullscreen - on by default. The audio metronome stays silent while a song is open beside your library, and only plays once the song has the screen to itself.
- Accent sound - the sound played on the first beat of each bar (only used when a time signature is set).
- Beat sound - the sound played on each regular beat. You can preview both sounds before choosing them.
- Metronome volume - how loud the metronome sounds are.
- Show visual metronome - when a song has a tempo specified, a visual metronome is shown at the bottom of the screen.
- Use multi-beat metronome - when a song also has a time signature, show all beats of the bar rather than a single beat. When turned off, a simple single-beat metronome is used.
- Accent beat color and Beat color - the colors of the first beat of the bar and the other beats.
- Beat size - adjust the size of the metronome indicator.
Song color theme
Customize the colors that songs are displayed in. Pick Chordle classic or Nighttime, or choose Custom theme to set your own colors for the background, chords and each section type. A live preview is shown alongside the settings.
Hotkeys
Customize the keyboard or foot pedal shortcuts used while performing, and choose whether Scrolling past top moves to previous song and Scrolling past bottom moves to next song. See Keyboard and pedal shortcuts for the full list of shortcuts and how to change them.
Song hotkey buttons
Add up to 3 quick-access buttons to the Bottom left and Bottom right of the song player, giving you one-tap access to any hotkey action without a keyboard or pedal. See Song player hotkey buttons for full details.
Instruments
Choose your Default instrument for chord diagrams, and create your own instruments with the tunings you play under My instruments.
Help
Links to the online documentation, release notes and our email address, as well as:
- Show tips - enable or disable the contextual tips that appear as you use Chordle.
- Reset all tips - show all previously dismissed tips again from the beginning.
Logging and error reporting
Controls diagnostic data collection. See Reporting issues for guidance on using these settings when troubleshooting.
- Send anonymous analytics - allow Chordle to send anonymous usage data to help improve the app. See our privacy policy.
- Error report uploads - choose Ask every time, Always send error reports or Never send error reports.
- Log level - set the verbosity of Chordle’s diagnostic log. Information is the default. If you’re investigating a specific problem, switching to Verbose captures more detail. The change takes effect straight away, with no restart.
- Copy logs - copies the current session log to the clipboard so you can paste it into an email.
- Send log report - sends this session’s log to us, with a description of the problem. You can preview the log first, and optionally include a copy of your song database.
- Screenshot behavior - choose whether the screenshot hotkey asks where to save the file (Prompt to save) or copies the screenshot to the clipboard (Copy to clipboard).
Troubleshooting
Contains reset and repair options for when something isn’t working correctly. These actions are generally only needed if advised by support.
- Reset all preferences - restores all settings to their defaults. Your songs, set lists and synced data aren’t touched, but you’ll need to set up syncing again.
- Recreate database - clears all songs and set lists from this device. Anything you’ve synced downloads again the next time you sync. If you haven’t set up syncing, your songs and set lists are lost, and this can’t be undone.
- Reset search index - rebuilds the search index used by the song library. Use this if search results look incomplete or wrong. Your songs don’t change.
- Re-import legacy library data - only shown if you upgraded from an older version of Chordle. Imports the songs and set lists from that version again.
License
Shows your store purchase or subscription, and the Chordle account the app is signed in with. See Set up Chordle Drive for signing in, and Issues with purchases if something isn’t unlocked.