User guide · Before the gig

Share setlists with a link (cloud sync)

Bluetooth keeps a band together in the room. A cloud link keeps a setlist up to date everywhere else: on your own phone, tablet and computer, and on every bandmate's device, all week. Bandmates open the link in the ChordCast app or right in a web browser. Nobody makes an account.

Share a setlist

  1. Open the setlist, tap More (⋯) and choose Share to Cloud….
  2. Tap Make Share Links. You get two links: an edit link and a view-only link.
  3. Send each link with Share, show it as a QR Code for someone across the room, or Copy it.

Once a setlist is shared, the same menu item reads Cloud Sharing… and opens the same sheet. To share a single song, touch and hold it in the library and choose Share to Cloud…: it's shared as a one-song setlist named after the song.

LinkGive it toThey can
Edit linkBandmates, and your own other devicesReorder songs, set keys, fix and add charts
View-only linkA sub, the sound tech, a device on a music standSee the setlist and charts, always up to date, without changing them
The Share dialog in the web app: a Can edit link and a View only link, each with Change, QR code and Copy link buttons.
The same two links in the web app's Share dialog.

Setlists and songbooks

When you share, you can choose Share as a Songbook instead. A shared setlist keeps its order and holds up to 500 songs. A songbook holds up to 5,000, sorted by title and searchable: the band's whole repertoire, to pick setlists from.

Who has it, and changing access

  • Who has it lists every device that joined, by name, marked Can edit or View only. Someone who can edit can change a device's access or Remove it. A removed device loses access until someone sends it a link again.
  • Change a Link… replaces the edit link or the view-only link. The old link stops working for anyone who hasn't opened it yet; everyone already in stays in.
  • Stop Sharing on This Device takes the setlist off the cloud for this device only. The setlist stays in your library.

There are no accounts: having a link is what gives access, so who has the edit link decides who can change the setlist. Devices are known by name: the same name you set as Your Name for band sync, and in the web app, the name it asks for on your first visit.

What syncs, and how edits merge

  • The setlist's name and the order of its songs.
  • Every chart in it.
  • The band's key for each song.

Charts in a setlist you can edit save as you type: the editor shows Saving… and Saved, and has Done instead of Save. If a bandmate changes the same chart while you have it open, their change is merged into yours and the editor says so (“Merged in a bandmate's changes”).

  • Two people edit different bars: both edits are kept.
  • Two people edit the same bar: the newer edit wins.
  • One person reorders the set while another adds a song or renames it: both happen.
  • Two key changes to the same song: the newest wins.

The cloud never moves anyone's screen. Following the leader, the current song and live key changes are Bluetooth band sync, so a band plays the same way with or without a connection.

Offline

A shared setlist keeps working without a connection, and shows whether it's up to date. Edits you make offline are sent when the device reconnects. In the web app, charts you've opened are kept in the browser, and Perform mode tells you when the whole setlist is Saved for offline.

  • On an iPhone or iPad with ChordCast installed, a setlist link opens in the app and the setlist joins your library.
  • Anywhere else, the link opens the web app in the browser. Its Open in App button hands it to the app.
  • If tapping a link doesn't open the app, copy it and use Open Setlist Link… under New Setlist in the sidebar (iPhone, iPad and Mac).
  • With a view-only link, editing a chart offers Duplicate and Edit: an editable copy of your own that never changes the band's.

If a link says it doesn't work any more, someone changed it: ask a bandmate for the new one.

The web app

At chordcast.app a setlist opens in any browser, on any computer, tablet or phone, with no install. Songs are on the left (drag to reorder), the same visual editor the apps use is in the middle, and the details are on the right: the song's title, Key for the band, Download PDF for the song or the whole setlist, Duplicate, and People, where an icon beside each person shows whether they can edit or only view (an editor can click it to change their access). Text at the top opens the chart's text beside the visual editor.

A shared setlist in the web app: the songs list, a chart in the visual editor with a horn part below it, and the details panel with title, key for the band, PDF downloads and people.
A shared setlist in the web app.

You can start a setlist or a chart here too (New setlist, New chart, or iReal Pro to import a playlist), then share it and open it in the app later. The browser keeps no library of its own; your setlists are listed on its home page.

Perform mode

Perform shows one chart at a time, full screen, for the stage. Move between songs by swiping, with ← and → (a page-turner pedal that sends arrow keys works too), or with the buttons at the bottom. The screen stays on while a chart is showing. The toolbar has the songs list with search, Transpose, Display (text size and light or dark), Full screen, and Edit to go back to the workspace. With a view-only link, Transpose sets your key for a song in this browser, on top of the band's. Perform mode opens by default for view-only links and on phones.

Perform mode in a desktop browser: a full-width chart with an intro, a repeated A section with first and second endings, a horn part, and 1 / 4 with the next song's name at the bottom.
Perform mode on a laptop.
Perform mode on a phone with its toolbar and the bar at the bottom showing 1 / 4 and the next song.
Perform mode on a phone. Tap the chart to show or hide the bars.

Bluetooth and the cloud together

The two work side by side. Use cloud links to prepare during the week, and Bluetooth on stage. When a setlist that's shared to the cloud is also shared with the band over Bluetooth, it carries its cloud link, so bandmates join the cloud copy too and stay up to date after they leave the room. If the band edits charts at a gig with no internet, the changes reach the cloud from whichever device gets a connection first.

Deleting a shared setlist

Stop Sharing on This Device removes your device from it. To have a shared setlist deleted from the cloud entirely, follow the steps in the privacy policy.

Read more: How to share chord charts with your band.