Repository navigation
Venues
A venue is a place you sing — a bar, a KJ's regular Thursday night, wherever you're holding the mic. Add a venue, make it active, and every performance you log from then on gets tagged to it, so each venue builds up its own history of what you've sung there and how it went.
Every page has a venue chip in the header (next to your singer avatar), showing the active venue's icon and name — or "Set venue" if none is active. Tap it to open the switcher:
- Your venues, each with its icon and name; the active one has a ✓.
- "🚫 Not at a venue" — appears when a venue is active, and clears it.
- "Manage venues ›" — closes the switcher and opens the full Venues list.
Only venues with "Show in quick switch" turned on (see below) appear in this dropdown — everything still shows on the full Venues list regardless.
If auto-detect is on and at least one venue has a saved location, the switcher also shows a small 📍 Auto / 📌 Pinned toggle — see Auto-detect below.
Open it from the header ⋮ menu → Venues, or "Manage venues ›" in the switcher. Each row shows:
- The venue's icon and name, with a ★ if it's a favorite.
- How many performances you've logged there ("3 performances here") — blank if you've never sung there yet.
- An Active badge on whichever venue is currently active.
- A muted Hidden badge if the venue is hidden from the quick switcher (it's still fully usable — not in that dropdown).
A search box (placeholder "Search venues") filters the list by name once you have any venues. The list itself always sorts plain A→Z — favorites and the active venue don't jump to the top, so rows never move under your finger.
The page shows the hint "Press and hold a venue to make it active." Tap + Add to add a new one. With no venues yet, you'll see "No venues yet" and an Add your first venue button.
Tap + Add, or tap a venue and then Edit, to open the venue editor:
| Field | What it does |
|---|---|
| Name | Required — up to 16 characters. Save is disabled until you enter one. |
| Icon | Pick from a set of mic, instrument, nightlife and drink icons via the icon picker next to the name field. |
| KaraFun venue ID | Optional — see KaraFun below. |
| Location | Optional — tap 📍 Use my current location to capture where you're standing; once set you can Update (re-capture) or Clear it. |
| ⭐ Favorite | Floats the venue to the top of dropdown lists (the switcher). The Venues page itself always stays A→Z and marks favorites with a ★ instead. |
| ⚡ Show in quick switch | On by default. Turn it off to keep a venue out of the header switcher while leaving it fully usable everywhere else. |
| Notes | Optional free text, e.g. "ask for the KJ, cash only." |
Tap a venue in the list to open its details:
-
Open KaraFun Catalog — shown when Enable KaraFun Features is on and a KaraFun ID is set; opens that venue's whole KaraFun songbook. The chevron beside it opens one more choice:
- Show QR Code — displays a QR code for that songbook, big and high-contrast, for someone else to scan off your screen. It opens the same catalog their end, so you can hand the songbook to a friend without them typing anything. The URL is printed under the code too, for reading out or typing by hand. Tap ✕, the backdrop, or pull down to close and go back to the venue.
- Active — a toggle. Turning it on makes this venue active (and pins it, same as press-and-hold); turning it off clears the active venue, same as picking "Not at a venue."
- Favorite — a toggle, same effect as the edit sheet's Favorite switch.
- KaraFun Id — shows the saved ID, or "Not set." Hidden while Enable KaraFun Features is off.
- "Your history here" — your performance count, the average rating ("avg here"), and the date of your last performance at this venue. Reads "You haven't logged a performance here yet" until you have.
- "Go-to songs here" — the songs you rate highest at this venue, each with its average rating and how many times you've sung it there.
- "Recent performances here" — your most recent performances at this venue, newest first, with rating and date.
- Edit and Delete venue at the bottom.
Deleting a venue does not touch your performance history — those performances lose their venue tag; they aren't deleted.
Settings → Venues has a group of controls that decide whether the app picks your venue for you as you move around:
| Setting | What it does |
|---|---|
| "Enable Venue Auto-detect" | Switches to your nearest saved venue as you move. Only runs while the app is open in the foreground. |
| "Re-check location every" | How often to check again while the app is open: 2, 5, 10, 15, or 30 minutes. |
| "Default Venue Radius" | How close counts as "here": 50, 100, 250, 500, or 1000 feet (or the metric equivalent — 15, 30, 75, 150, or 300 meters — when feet are turned off). |
| "Show distances in feet" | Switches the radius labels between feet and meters. |
| "Venue history length" | How many entries appear in "Go-to songs here" and "Recent performances here": 3, 5, or 10. |
Auto-detect only considers venues that have a saved location — venues without one are never matched. It picks the closest venue within the radius; leaving every venue's range doesn't clear the active venue, it stops changing it.
Pinning: any manual pick — from the switcher, from the Venues list, or the detail sheet's Active toggle — pins that venue, so the periodic re-check won't override it. When at least one venue has a location and auto-detect is on, the switcher shows a small 📍 Auto / 📌 Pinned control to flip back to automatic picking; switching to Auto re-checks your location immediately.
No venue has a location saved: auto-detect never even checks your location until at least one venue has one, so a fresh install with no geolocated venues won't prompt for location permission at all.
Location permission denied (or location services off, or no fix available): the app leaves the active venue as it was — auto-detect never nags you about it. In the edit sheet, trying to capture a location under those conditions shows "Couldn't get your location. Check that location is on and permission is granted."
Everything on this page's KaraFun sits behind Settings → KaraFun → Enable KaraFun Features (on by default). Turn it off and the catalog button, its QR code, and the KaraFun ID field all disappear — a venue keeps any ID already saved, so turning it back on restores everything.
A venue can carry a KaraFun venue ID, which powers the Open KaraFun Catalog button in its detail sheet (the whole songbook for that venue, openable directly or shareable as a QR code), and per-song KaraFun search elsewhere in the app (see Lyrics & quick links).
Three ways to set the KaraFun venue ID in the edit sheet:
-
Paste a link — a full venue URL like
https://www.karafun.com/012345/…. -
Type the ID — just the number, e.g.
012345. - Scan the QR code — tap the scan button next to the field and point your camera at a KaraFun venue QR code. Scanning is available on Android and iOS only — the button doesn't appear on other devices.
A scanned code that isn't a real KaraFun venue link shows "That QR code isn't a KaraFun venue link." and leaves the field unchanged.
| Gesture | Effect |
|---|---|
| Tap a row | Opens its detail sheet. |
| Press and hold a row | Makes that venue active (with a short confirming buzz, if haptics are on) — the row's own Active badge is your confirmation. |
| Swipe left | Removes the venue, with a few seconds to Undo before it's gone for good. |
Since press-and-hold has no accessible equivalent, the detail sheet's Active toggle does exactly the same thing and is reachable without a gesture.