User guide

ChordCast user guide

ChordCast draws clean chord charts for bands, keeps every player's screen on the same song and key, and works on iPhone, iPad, Mac, Android and in a web browser. This guide is organised by what you're trying to do.

What are you trying to do?

New to ChordCast?

Start with Get started: how to install the app on each device, what's on the home screen, and where your songs and setlists live. There are no accounts to make. Your charts are stored on your devices, and leave them only when you share them with your band.

What a ChordCast chart looks like

Charts are drawn in a handwritten-style music font, laid out to fit your screen. A chart can be a plain grid of chords, or it can carry written rhythms on a staff, repeats and endings, codas, notes to the band and melody parts. This one is drawn live on this page by the same renderer the apps use:

An intro with written hits, then a repeated A section with first and second endings.

To write or change one, open it in the visual editor and tap: a chord to change it, a barline to add a repeat, the title to set the key and tempo. Under the hood every chart is also a few lines of text, which you can edit directly if you like, but you never have to (chart text reference).

Every feature, and where it's explained

FeatureWhere
iPhone, iPad, Mac, Android and web; how to get eachGet started
Library, search, sort, templates, duplicate, renameGet started
Band sync over Bluetooth, leader and followers, Take LeadPlay together
The sync control (the Mac's sync pill), turning sync on and offPlay together
Band key and your instrument's transposition (My Instrument)Play together, Setlists on stage
Fixing a chart for the whole band; keeping your own copyPlay together
Cloud sharing: edit and view-only links, QR codes, songbooksShare with a link
The web app and its Perform modeShare with a link
Setlists: add, reorder, per-song key, Play from StartSetlists on stage
Swiping between songs, the previous/next pill, arrow keysSetlists on stage
Full-screen charts on iPhoneSetlists on stage
The tempo dot and Tap tempoSetlists on stage
iReal Pro import (links, exported playlists, the forums)Import from iReal Pro
Visual editor and text editor, ⌘D multi-cursor editingEdit charts
Chart text formatChart text reference
Rhythms, melody parts (ABC), engravingRhythms and melody parts
Roll Chords, the experimental backing bandPractice on your own
Feedback, diagnostics, languagesGet started

All guide pages

Get startedInstall ChordCast on iPhone, iPad, Mac or Android, or open it in a browser. A tour of the library, setlists, templates and settings, with no account to make.Play together (Bluetooth)Band sync over Bluetooth: turn sync on, join a band, follow the leader, call keys and share a setlist with everyone nearby. No Wi-Fi or internet needed.Share with a link (cloud)Share a setlist or song to the cloud with an edit link or a view-only link. Bandmates open it in the app or a browser, edits merge, and it keeps working offline.AI assistantsConnect ChordCast to ChatGPT, Claude, Gemini or any assistant that supports MCP. It writes charts from a song, a photo or a description, checks and draws them, and shares them with your band.Setlists on stageMake a setlist, set each song's key, then play it: swipe or step between songs, full-screen charts, the tempo dot, your own transposition and zoom.Import from iReal ProBring songs and whole playlists from iReal Pro into ChordCast: open a link, share an exported playlist, paste it, or browse the iReal Pro forums from the app.Edit charts (tutorial)Try the real ChordCast editor: change chords, add rhythms, repeats and endings, then use the text editor and ⌘D to change many chords at once.Chart text referenceEverything a ChordCast chart's text can hold: chords, sections, repeats, endings, rhythms, rests, codas, lyrics and melody parts, each drawn as it looks.Rhythms and melody partsWhat a ChordCast chart can hold beyond chord grids: written rhythms and hits on a staff, melody and horn parts in ABC notation, and engraving that fits the page.Practice on your ownUse ChordCast on your own: read in your instrument's key, check a tempo, roll up chord changes to practise over, and try the backing band.

Articles