User Guide ChordFlow
1. INTRODUCTION
ChordFlow is a simple and intuitive application for musicians to organize their setlists and songs with chords. Available for Android (optimized for stage use) and Windows (for creating and editing repertoires).
2. MAIN MENU
When you open ChordFlow, you'll see the main menu with the following options:
- Setlists: View and manage your song collections
- Import Songs: Add new songs from text files
- Settings: Configure application preferences
- About: Information about the application
3. SETLISTS
- View Setlists: The list shows all created setlists
- Add Setlist: Tap on the yellow "+" button in the bottom right corner
- Open Setlist: Tap on any setlist to see the songs it contains
- Context Menu: Long press on a setlist to access additional options like deleting or exporting the setlist
4. SONG LIST
This screen shows all songs within a selected setlist.
- View Songs: Displays all songs in the selected setlist
- Add Song: Tap the yellow "+" button to create a new song
- Open Song: Tap any song to view its chords
- Search: Use the search box to quickly find songs
- Change Order: Use the floating buttons to reorder songs
- Context Menu: Long press a song to edit or delete it
5. SONG DETAILS SCREEN
This screen displays the formatted chords to play.
- View Song: See the chords organized by sections
- Scroll: Slide up and down to view the full song
- Zoom: Pinch to zoom in or out
- Reset Zoom: Double-tap to restore default size
- Transpose: Tap the transpose icon (musical note) to open the transpose dialog
- Transpose Dialog: Use the slider to change semitones and choose between sharp (#) or flat (b) notation
- Return to List: Swipe from left to right to go back
6. SONG EDIT SCREEN
This screen allows you to create or edit a song.
- Edit Title: Enter the song name
- Set Key: Specify the original key (e.g., C, D, Am)
- Add Sections: Enter section name (e.g., Verse, Chorus), type chords and tap "Add Section"
- Edit Sections: Long press an existing section to edit or remove
- Save Song: Tap "Save Song" at the bottom
7. GESTURES & INTERACTIONS
- Swipe in Details: Swipe left to right to return to list
- Zoom in Details: Pinch to zoom; double-tap to reset
- Context Menu: Long press an item to see options
8. KEY TRANSPOSITION
Feature to change the song key for different vocals or instruments.
- Open a song in the details screen
- Tap the transpose icon (musical note) to open the dialog
- Use the slider to adjust semitones (positive = up, negative = down)
- Choose your preferred notation: sharps (#) or flats (b)
- Tap "Apply" to see the transposed chords
- The current key is shown next to the song title
- Transposition is saved automatically
Note: Flat notation is useful for brass and wind instruments.
9. SONGS WITH LYRICS & CHORDS
ChordFlow allows adding songs with embedded lyrics and chords.
- Tap the "+" button in the song list
- Select "Add Song with Lyrics"
- Enter the title and key
- Add chord lines with a dot (.) above the lyrics:
[Verse]
. C G Am F
Imagine there's no heaven
. C G Am F
It's easy if you try
- For standalone chords, use [D]
- Use [Verse] or [Chorus] to mark sections
- Tap "Save"
Songs with lyrics are marked with a lyrics icon and can be transposed too.
10. IMPORTING SONGS
ChordFlow supports multiple import methods to speed up setlist creation:
- File: import songs from .txt files in supported formats
- Paste: paste song text directly into the importer
- Link: import from compatible web pages
- OCR: extract lyrics/chords from images or photos
Link import: ChordFlow tries to extract title, artist, key, and song content automatically. Dedicated adapters are available for Cifra Club and Ultimate Guitar, with fallback handling for other websites when possible.
Note: because this depends on third-party websites, compatibility may change over time.
Supported text formats:
- Compact format (Sections): chords grouped by section in one line
- Multiline format (Lyrics + Chords): chord lines above lyrics using dot prefix (.)
WONDERFUL TONIGHT;G;INTRO,G D C D G D C D|VERSE,G D C D G D C D|CHORUS,C D G Em C D G|
===MUSIC_SEPARATOR===
Hotel California (Dm)
Eagles
[Verse]
.Dm A7
On a dark desert highway, cool wind in my hair
Backup & Restore (Backup Center)
ChordFlow includes a Backup Center to save and restore all your setlists and songs.
- Open Backup Center from the setlists screen
- Select a folder on first use (it will be reused automatically)
- Create a central JSON backup file
- Change backup folder anytime if needed
- Restore from a backup file to recover data
Tip: create a backup before large edits in your repertoire.
11. TIPS & TRICKS
- Use zoom on the song details screen to fit your needs
- Prevent screen timeout during rehearsals
- Swipe to switch between songs quickly
- Organize songs in themed setlists for fast access
12. FILE EXAMPLES
Try our song format examples! Download the .txt files and test the import feature in the ChordFlow app.
13. WINDOWS VERSION INSTALLATION
The Windows version of ChordFlow is now distributed through an installer that simplifies the installation process. You may still receive some security warnings from Windows Defender or your antivirus software. This happens because:
- ChordFlow is not signed with a commercial certificate (which is expensive)
- Windows SmartScreen may display a warning about an "unrecognized app"
Important: ChordFlow is completely safe and does not contain any malware or viruses.
To install ChordFlow on Windows:
- Download the installer from our website
- If you see a Windows SmartScreen warning, click on "More info"
- Then click on "Run anyway"
- Follow the installation wizard instructions to complete the process
- After installation, ChordFlow will be available in your Windows Start menu
The application does not collect any personal data and works entirely offline. You can verify our Privacy Policy for more information.
14. USING AI TO GENERATE FILES
You can speed up the creation of your music files using AIs like ChatGPT, Gemini, etc.
Just ask the AI to write songs in the format recognized by the app.
For lyrics with chords:
Imagine (C)
John Lennon
[Intro]
.C F C F
[Verse]
.C F C F
Imagine there's no heaven
.C F C F
It's easy if you try
===MUSIC_SEPARATOR===
For chord sections:
IMAGINE;C;INTRO,C F C F|VERSE,C F C F|CHORUS,F C G C
After generating the file, import it directly into ChordFlow.