Concert playlist plugin
Prepare a private Spotify playlist for an upcoming concert without revealing the order in which songs were played. This GitHub Copilot plugin includes a local canvas for the GitHub Copilot App.
The canvas searches setlist.fm for an artist and recent concerts, collects distinct songs, and lets you choose their Spotify versions. The preview groups tracks by album, from newest to oldest, with cover songs at the end. You can create a new private playlist. Nothing is written to Spotify until you confirm.
Requirements
- A GitHub Copilot App installation that supports canvas extensions, and a local session on the computer where the browser runs.
- A setlist.fm API key. Sign in or create an account first. See the API documentation for terms.
- A Spotify account and a Spotify developer application. For an application in development mode, Spotify requires the app owner to have Premium and limits access to up to five authorized users. See Spotify quota modes.
- Internet access and local port
43821available for the Spotify callback. No Azure resources or hosting are required.
Install from the marketplace
The repository includes an Agent Plugins 1.0 plugin and a GitHub-hosted marketplace catalog. Once these files are published to the repository's default branch, install it in GitHub Copilot App:
- Open Customize and choose the marketplace settings beside the marketplace selector.
- Add
bmoussaud/github-copilot-concert-plugin. - Browse for concert-playlist and select Install.
- Configure the setlist.fm and Spotify credentials below, then restart Copilot App and start a new local session. Approve the extension and environment variable permission if prompted.
The marketplace catalog is .github/plugin/marketplace.json; the plugin
manifest is plugin.json. The canvas implementation is bundled under
com.github.copilot/extensions/concert-playlist-canvas. The whole repository
is the plugin source, so no separate hosting or npm install is needed.
Copilot CLI can also install the plugin from the same marketplace:
copilot plugin marketplace add bmoussaud/github-copilot-concert-plugin
copilot plugin install concert-playlist@concert-tools
The canvas UI requires a canvas-capable host such as GitHub Copilot App; CLI installation alone does not provide a graphical canvas.
Configure setlist.fm and Spotify
-
Apply for a setlist.fm API key.
-
Sign in to the Spotify Developer Dashboard and create an application, or use an existing one.
-
In the Spotify application's settings, add this exact redirect URI and save:
http://127.0.0.1:43821/callbackUse
127.0.0.1, notlocalhost. The port and path must match. See Spotify redirect URI requirements. -
Copy the Spotify application's Client ID. This extension uses OAuth authorization code with PKCE and does not require a Client Secret. If another Spotify account will use a development-mode app, add it under Settings > Users Management in the Spotify dashboard.
-
On Windows, search for Edit environment variables for your account. Add these user variables with your own values:
Variable Value SETLISTFM_API_KEYYour setlist.fm API key SPOTIFY_CLIENT_IDYour Spotify application's Client ID -
Quit GitHub Copilot App completely, reopen it, and start a new local session so the plugin inherits the variables. If Copilot asks permission to pass
SETLISTFM_API_KEYto the extension, approve it.
On other platforms, make both variables available to the process launching Copilot App. A graphical app may not inherit variables from shell startup files.
Do not put the key in the repository or paste it into chat. To check that the Windows user variables exist without displaying their values:
foreach ($name in 'SETLISTFM_API_KEY', 'SPOTIFY_CLIENT_ID') {
$value = [Environment]::GetEnvironmentVariable($name, 'User')
Write-Output ("{0}: {1}" -f $name, (-not [string]::IsNullOrWhiteSpace($value)))
}
Create a playlist
- In a local Copilot App session where the extension is installed, ask: “Open the Spoiler-free playlist canvas.”
- Under Source, search for the artist and select the correct result. The MusicBrainz identifier is retrieved automatically. Choose the Number of concerts (1 to 25, default 5), then load the setlists; if coverage is incomplete, choose whether to expand the search or continue. Each selected concert links to setlist.fm; opening it can reveal the concert order.
- Under Connect, sign in to Spotify and grant the requested permissions.
- Under Selection, check the proposed versions, edit a search title if necessary, or exclude a song. Missing matches are highlighted. Spotify album artwork is shown in the version menu when available. Covers are searched by their original artist when known, or by title alone otherwise.
- Under Preview, review the album-sorted tracks.
- Under Confirmation, optionally add today's local date (
YYYYMMDD) to a new playlist's name, then explicitly confirm the Spotify write. Choose Start a new preparation to return to Source without writing; your Spotify connection remains available.
The source uses up to your selected number of recent documented concerts, preferring the latest tour when it has enough; otherwise it uses the most recent concerts. If fewer are available, expanding to older concerts or continuing with incomplete coverage requires your choice. Changing the count clears the previous source so you can reload it. A version appearing most often among this preparation's search results is preselected, with Spotify's first result breaking ties. Verify matches yourself: the original studio version cannot be guaranteed.
Privacy and troubleshooting
- Spotify authorization uses a browser and the loopback callback. Tokens are kept in the extension process's memory, not persisted; reconnect after an extension or app restart. In-progress canvas selections can also be lost when the canvas reloads.
- Spotify search results and playlists remain in the local canvas and extension process; the extension's agent action does not return their contents to Copilot. Artist and track searches are still sent to setlist.fm and Spotify, respectively, and artwork is loaded from Spotify's image service.
- Canvas not found: confirm the marketplace plugin is installed and enabled, restart the app, and use a local session.
- Missing key or Client ID: check the user variables, approve any extension permission prompt, and restart the app. A variable set in a different process may not be inherited by an already-running app.
- Spotify authorization fails: check the exact redirect URI, that port
43821is free, and the development-mode Premium and user-allowlist rules. - Write interrupted: an empty or incomplete playlist may have been created. Check it in Spotify before retrying.
For canvas details, see the GitHub Copilot App canvas documentation. For marketplace publishing details, see the GitHub plugin marketplace documentation.
Development
To run the local tests from the repository root, install Node.js and run:
node --test tests\concert-playlist.test.mjs