Guide
How to use Rep Jam Gig.
A walk through the app, screen by screen — what each screen is for and how the pieces fit together. Screens shown here have a little example data in them so there’s something to point at; your own copy starts completely empty.
Add a song, the credits fill themselves in
Tap + on Repertoire and start typing a title. The built-in songbook — 2,545 jazz standards — offers matches as you type. Pick one and it fills in composer, lyricist and year. The key is yours to set — the app never assumes the chart key is the one you do it in.
Three buckets: Ready, In Progress, To Learn
Every song has a status. Performance Ready is what you’d call on a gig tonight. In Progress is under construction. To Learn hasn’t started. The stats strip at the top of Repertoire always shows your counts at a glance, and the list below splits the same way.
Log a jam in a few taps
Add a date, venue, and the song you played. Write musicians as “Name (instrument)” — e.g. Dana (piano) — and the app remembers that pairing in your Musicians directory automatically, so you never type it twice.
Let the app build your set list
From Gigs, tap the wand icon. Set how many sets and songs per set, and it suggests a set list from your ready repertoire — balancing keys, favouring songs you haven’t played in a while, and leaning on tunes you’ve played with the specific musicians on this gig if you name them.
Every gig keeps its own set list
However it got there — built automatically or typed by hand — a gig's sets and songs live right on the gig, alongside the venue, date and who played. Tap any gig to see the full running order.
Plan your jam calendar — and let performed songs file themselves
The Calendar tab holds the sessions you plan to attend — weekly jams, “third Monday of the month” nights, one-offs — with stars to pin the important ones and search across names, places and rules. Import any calendar’s .ics file and it lands intact. And when you log a jam or gig with a song that isn’t catalogued yet, it files itself under In Progress with its songbook credits — nothing falls through the cracks, and there’s no queue to tend.
Musicians remember themselves
Everyone you’ve named in a jam or gig entry appears in Musicians automatically, rolled up with every session you’ve played together. Add people by hand too, with a note on where you met — instrument, Instagram handle and play history all live in one place.
Move your whole library in one file
Import / Export (top-left of Repertoire) covers everything — repertoire, musicians, jams and gigs — in one CSV. Re-importing a file, including your own export, never erases or duplicates anything already in the app: matched songs and musicians are merged, and jam or gig entries already logged are skipped.
Bringing in an existing repertoire? The step-by-step import guide walks through filling in the file, with exactly what each row type needs.
Quick answers
The practical stuff
- How do I mark a song performance-ready?
- Tap the song in Repertoire to open it, then change Status to Performance Ready and save. It moves to the top bucket immediately.
- How do I delete a song, jam, gig or musician?
- Press and hold its row in the list, then tap Delete. Deleting a song only removes it from your repertoire — the jam and gig entries where you played it are kept. For a musician, the option is Remove from directory: it takes them out of the directory, but the jams and gigs you logged with them stay, so they'll still appear if they played on one.
- Can I move my data to a new phone without iCloud?
- Yes — use Export All Data on the old device, then Import that file on the new one. See Privacy for how iCloud sync works if you’d rather do it automatically.
- Something here doesn’t match what you’re seeing?
- The app changes between builds — check Release Notes for what’s new, or reach us through the support page.