Skip to content
goose index

How the listen links work

The buttons

  • ◈ Bandcamp — buys the night from the band, when they have released it. Buying there pays them, which is why it comes first.
  • ▷ Listen on nugs and ▷ Watch — hand the show to Yeti (formerly AppleNugs), a Mac app for nugs.net, at that night. Watch opens its video side.
  • ▷ on a setlist row — the same handoff, started at that song.
  • ↗ Open on nugs.net — the show’s own page in the nugs web player. It appears only when we know that exact page.

What a click does

The Listen, Watch and row buttons hand your browser an applenugs:// link. If Yeti is installed (the current download still carries its old name, AppleNugs), it opens and finds the show on nugs by artist, date and venue. If nothing claims the link after about a second and you are still on the page, you are sent to nugs.net instead — straight to the show’s page when we know it, or to a search for it when we don’t. Watch does the same for the video side, when the show has one.

What you need

  • A nugs.net subscription. These buttons open what a subscription already includes, and nugs.net asks you to sign in.
  • Yeti for macOS — signed, notarized, updates itself. The current release, v1.5, installs as AppleNugs.
  • On iPhone, Yeti is personal-install only — you build it yourself. There is no App Store version and no TestFlight, so on a phone these buttons land on the nugs website.

What this page can't promise

This index holds no nugs catalog. A night listed here isn’t necessarily on nugs, and landing on an empty search means nugs doesn’t have that night — not that the link broke. As of today, 500 of 866 shows here link straight to their page on nugs.net; the rest fall back to a search.

Two shows on one day are told apart by venue. Where that isn’t enough, this site’s web links fall back to a search rather than guessing — the app, given no usable venue, opens the first show it finds on that date. And a web link reaches a show, never one song — the row’s ▷ starts the app at the song, but without the app you land on the whole show.

Try it

These are the real thing, built for 2026-11-21 at Blue Cross Arena the same way every show page builds its buttons. Clicking tells you whether the handoff works on your machine — it doesn’t say whether the show is on nugs.

▷ Listen on nugs

The link behind that button:

applenugs://show/2026-11-21?artist=Goose&venue=Blue%20Cross%20Arena

And the same show, started at “Arrow”:

applenugs://show/2026-11-21?artist=Goose&song=Arrow&venue=Blue%20Cross%20Arena

The same link, asking for video:

applenugs://show/2026-11-21?artist=Goose&venue=Blue%20Cross%20Arena&media=video

Where it sends you if the app doesn’t open:

https://play.nugs.net/#/search?searchTerm=Goose%202026-11-21

How the links are built

The buttons emit this grammar:

applenugs://show/<YYYY-MM-DD>?artist=<name>[&venue=<venue>][&song=<title>&set=<n>&pos=<n>][&media=audio|video]

PartRequiredNotes
applenugs://yesThe scheme the app registers, under either name. Not nugs:// — that belongs to the official app.
show/<YYYY-MM-DD>yesThe performance date — the one identifier this site and nugs share natively.
artist=<name>yesBand name, e.g. Goose. Keeps the app's handler generic instead of hardcoding one artist.
venue=<venue>noTie-break for two-show days (audio; video resolution is date-only). Without it the app opens the first show on the date; a venue matching nothing falls back to search.
song=<title>&set=<n>&pos=<n>noStart playback at one song. set/pos are sent for future disambiguation — matching today is title-only.
media=audio|videonoaudio when omitted.

Query values are percent-encoded with %20 for spaces — never +. Swift’s URLComponents does not decode + to a space, so a + reaches the app literally.

Song titles are matched against the resolved show’s track list in three tiers: exact normalized match, then a track title that contains the song, then the longest track title the song contains (so a segue link like “Madhuvan > Hot Tea” still lands on “Madhuvan”).

Without the app, the same buttons fall back to the nugs web player — https://play.nugs.net/release/<id>, or https://play.nugs.net/watch/release/<id> for video — when this site has resolved the show’s id, and to a search otherwise. There is no per-track web route.

The app, and the full contract, live at github.com/tsvb/yeti.