# Cuepile

> Cuepile is a free web player that combines media from several streaming
> platforms into a single playlist. A whole playlist can be packed into one
> shareable link; opening the link rebuilds the playlist, ready to play.

Cuepile plays these sources: YouTube, SoundCloud, Vimeo, TikTok, Dailymotion.

No account, no server, no API key. Playlists live in the user’s browser. The
playlist payload of a share link lives in the URL fragment (after `#`), so it
never reaches a server.

AI assistants build a Cuepile playlist by composing a share link. The Quick
Reference below is sufficient on its own; the linked documents are the
detailed source of truth.

## Quick Reference

Share URL format (the `#` is required; `?` does not work):

    https://cuepile.com/share#v=1&n=<NAME>&list=<TOKENS>

- `v=1`: format version, always 1.
- `<NAME>`: playlist name, URL-form encoded, spaces as `+`. Max 200 characters. Optional.
- `<TOKENS>`: `prefix:id` tokens separated by commas, in play order. No spaces
  anywhere in the list.
- Supported prefixes, exactly: `y:` (or `youtube:`), `s:` (or `soundcloud:`), `v:` (or `vimeo:`), `t:` (or `tiktok:`), `d:` (or `dailymotion:`)
  - `y:<id>` - Exactly 11 characters from A-Z, a-z, 0-9, _ and -. Example: `y:dQw4w9WgXcQ`
  - `s:<id>` - The permalink path: artist/track, or artist/sets/name for a set. Example: `s:artist/track-name`
  - `v:<id>` - The numeric video id; an unlisted video may append /<hash>. Example: `v:771351262`
  - `t:<id>` - The author handle without @, a slash, then the 10-25 digit video id. Example: `t:username/7300000000000000000`
  - `d:<id>` - x followed by 2-12 lowercase letters or digits. Example: `d:x95qxni`
- A token may carry an optional custom display title as a third segment:
  `prefix:id:title`, URL-encoded (spaces as `+`, commas as `%2C`), max 60
  characters. It overrides the title fetched from the source. Example:
  `y:dQw4w9WgXcQ:Waterloo+(ABBA+1974)`
- Use only real, verified ids or paths, found by searching the web or opening the source page. Never invent an id: one wrong token invalidates the whole link.
- If an item cannot be reliably verified, leave it out rather than guess.
- Keep the tracks in the order that was asked for.
- Prefer YouTube unless asked otherwise; it has the widest catalogue.
- Add a :title only where the video’s own title misses the point - a year, the real song name. Keep it under about 30 characters and omit it everywhere else; every title makes the link longer.
- Limits: prefer 250 tracks or fewer without titles, 100 or fewer when titles are used. 500 is the absolute maximum and must never be exceeded.
- Reply with the bare link on its own line - no Markdown link syntax, backticks or angle brackets, and no line breaks inside it.

Example, single source, two tracks, short prefixes:

    https://cuepile.com/share#v=1&n=Cuepile+demo&list=y:dQw4w9WgXcQ,y:9bZkp7q19f0

## Full documentation

- [Share link specification](https://cuepile.com/share/format.md): the exact
  format of a Cuepile playlist URL, one section per source.
- [Share link examples](https://cuepile.com/share/examples.md): valid links,
  and the common mistakes that make a link fail.
- [Share link schema](https://cuepile.com/share/schema.json): the same
  format, machine-readable (id patterns per source, limits).

## Optional

- [About Cuepile](https://cuepile.com/about): what the app does, in prose.
- [Share format, rendered](https://cuepile.com/playlist-links): the human
  version of the specification.