GIGSMITH

1. Introduction

GigSmith builds a running order out of the songs you already play. You keep a catalog, you describe the gig in a sentence, and it hands back a set that fits the time you have and moves the way a room needs it to move. Then you drag things around until it is yours, and print it.

It is a web app. Nothing to install, nothing to update. It runs in the browser on whatever you brought to the gig.

What it is for

• Cover bands with a big catalog and a different room every weekend.
• Solo acts who write the set in the car park and would like to stop.
• Anyone who has watched a room drain during the wrong song in the wrong slot.
• The one member who always ends up doing the set list. This is for you, specifically.

What it is not

It does not play, tune, or transpose anything. It orders the set. The forty minutes on stage are still yours to lose.

2. Getting In

Creating an account

Open GigSmith and choose INITIALIZE_FREE on the sign-in screen. Two ways in:

• Email and password. Enter an address, choose a password, confirm.
• Google. One click with a Google account.

Either way you land on the Dashboard.

The Dashboard

• Total Songs and Total Setlists, so you know where you stand against the Free limits.
• Recent setlists, with event type and venue, and a View All link.
• Two quick actions: Generate with AI and Add to Catalog.

The sidebar

Songs is your catalog. Generate builds a set from a prompt. Setlists is everything you have saved. Upgrade is where Pro lives. On a phone the sidebar becomes a bar along the bottom.

3. Quick Start

First set in five minutes. This is the whole product in one pass; the rest of the manual is detail.

1. Songs → Import Songs → Paste Song List. Paste the list you already have, one per line, Title - Artist. Messy is fine; it parses all-caps and missing dashes. Click Parse Songs, check the result, add them to the catalog.
2. Songs → Reconcile. It looks each song up and fills in the artist name, duration and genre you did not type, and estimates an energy level. It will not fill in tempo or key; see section 4 for why.
3. Generate. Describe the gig in plain English: "90-minute outdoor wedding reception, upbeat pop and classic rock, nothing too slow." Click Generate Setlist.
4. Save Setlist. Name it, optionally add event type, venue, city and date.
5. Setlists → open it. Drag the order around. Click the arrow between two songs for Transition Ideas. Export as .txt (Free) or .pdf (Pro).

4. Your Catalog

The catalog is the foundation. The AI only picks from songs you have told it you play, so a fuller, better-described catalog produces better sets. Every song carries these fields:

Adding a song by hand

Songs → Add New Song. Title, Artist and Genre are required; Duration is in seconds. Fill in Tempo and Key if you know them; the set will be better for it. Save Song.

Importing songs

Songs → Import Songs opens the importer with three working tabs. (A fourth, Google Drive, is greyed out and not available.)

Paste Song List

One song per line, Title - Artist. The parser copes with all-caps, missing dashes and stray numbering. Click Parse Songs, review the Parsed Songs list, then add them. Anything the parser could not resolve is left for Reconcile.

Upload a File

Drop or select a .txt, .pdf or .xml file containing a song list. The same parser runs on the contents.

Spotify

Paste a public playlist URL. GigSmith pulls the track list with titles, artists, durations and genres, and estimates an energy level for each. Tempo and key arrive blank, for the reason above.

Reconcile

Songs you typed by hand are usually missing something. Reconcile looks every incomplete song up and fills in the canonical artist name, the duration and the genre, and estimates energy. It touches only songs with gaps and never writes tempo or key. If nothing needs it, it says so.

Verify Catalog

Verify Catalog re-checks every song, not just the incomplete ones, and corrects title casing, artist names and durations that have drifted. It fills in a genre only where one is missing, and it never overwrites tempo, key, or a genre you set yourself.

Searching, editing, deleting

The search bar filters by title or artist. The pencil opens Edit Song; the trash deletes, after asking. On Free, the catalog holds twenty songs.

5. Generating A Set

Generate in the sidebar, or Generate with AI on the Dashboard.

The prompt

One text field. Say what the gig is, how long you are on, and what it should feel like. The more of those three you give it, the less it has to guess.

Click Generate Setlist. The result fits the duration you described, matches the mood and genre, and draws from your catalog.

Catalog Incomplete

If your catalog cannot fill the set you asked for, GigSmith tells you so rather than padding it silently. You get two choices: add more songs and try again, or press the button to let the AI supplement the set with well-known songs from its general knowledge. Supplemented songs are not in your catalog; treat them as suggestions to learn, not songs you own.

Saving

Save Setlist. Give it a name. Event type, venue, city and date are optional and appear on the export. On Free you can hold one saved setlist at a time.

6. The Setlist Editor

Setlists lists everything you have saved. Open one to edit it. Changes save as you go.

• Reorder. Drag any row to a new position. The total length updates as you go.
• Remove. The trash icon on a row.
• Add Songs. Opens a panel where you pick from your catalog.
• Transition Ideas. Between any two adjacent songs, click through to Get Suggestions. The AI looks at both songs’ energy and genre and suggests how to get from one to the other: a key move, an energy drop, a spoken intro, a segue. They are ideas, not instructions.

Reading the total

The set’s length is the sum of every song’s duration, which is why Duration is a required field. A song with the wrong duration lies to you about the whole night.

7. Exporting

From the editor’s export menu:

• Export as .txt — plain text: the name, date, total duration and every song numbered with artist and length. Free.
• Export as .pdf — a formatted sheet with title, artist, key, tempo, energy and duration per song, ready for a music stand or a sound engineer. Pro.

8. Free vs Pro

Hitting a limit

When you reach a Free limit, GigSmith shows exactly what is blocked and what Pro unlocks, with an Upgrade button right there. Nothing you have made is lost or locked; you just cannot add the twenty-first song, the second setlist, or the second generation this month.

9. Account And Billing

Upgrading to Pro

Upgrade, from the sidebar or from any limit prompt, opens a secure Stripe Checkout page. Enter payment details there; GigSmith never sees your card. When Stripe confirms, the account is Pro immediately, no refresh needed.

Managing or cancelling

To change your payment method, get an invoice, or cancel, email thump@reclusestudios.net from the address on the account. Cancellation takes effect at the end of the current billing period; Pro stays on until then, and the account reverts to Free automatically afterwards. Nothing is deleted when it does.

10. Troubleshooting

Anything else: thump@reclusestudios.net. Say what you did, what you expected, and what happened instead.

11. Glossary