> ## Documentation Index
> Fetch the complete documentation index at: https://docs.setlist.dj/llms.txt
> Use this file to discover all available pages before exploring further.

# Read the list

> What every column, colour and mark in the table means, what the track drawer holds, and where the Maybe and Removed tracks go.

The table is the list: one row per track, in the order of the set. Each row says what the track is, how it mixes with
the one before, how hot it makes the room, what the crew thinks of it and who brought it. A click on a row opens the
[track drawer](#the-track-drawer) with everything else.

![Ten rows of a list under the column heads Title, Artist, BPM, Key, Energy, SET with a small flame, Year, Time, Rating, Added by and Columns. Each row has its position, a grey cover with a T, the title with emoji reactions and a count beside some titles (a flame with 2, raised hands with 2, a heart with 1) and a speech bubble with the number of comments, then the artist, the BPM from 124 to 132, a coloured Camelot key chip from 8A to 1A, some solid and some outlined, the energy, the SET score with a flame (grey, and yellow for 90 and 82), a dash for the unknown year, the length, the viewer's own stars in yellow with the crew's average beside them such as 4.3 from 3, the initials CA, AN or JU of whoever added it, a clock, a drag handle and a three-dot menu. The second row is hovered and shows a smiley to add a reaction.](https://mintcdn.com/setlist-dj/qvfs5uejTkbunr5n/guide/images/table.webp?fit=max\&auto=format\&n=qvfs5uejTkbunr5n\&q=85\&s=293a1eb8365bf46f6bcf33eef5c70d7a)

The table on a computer. Reactions ringed in yellow are your own, and so are the yellow stars. The SET flame turns yellow from 80.

## The columns

Point at a column head to see what it means. The heads and their explanations:

| Column | What it shows |
| - | - |
| **Title** | The track. A click opens the details, the player and the comments. The reactions and the comment count sit beside it. |
| **Artist** | Who made it. |
| **BPM** | Beats per minute: the tempo. |
| **Key** | The key on the Camelot wheel. Solid when it mixes with the track before, an outline for a jump. See [Keys](#keys). |
| **Energy** | How hard the track hits, 0 to 100. |
| **SET** | The SET score, 0 to 100: how hot the track makes the room. See [The SET score](#the-set-score). |
| **Year** | The release year. |
| **Time** | The track's length. |
| **Rating** | Your own stars, one to five, and beside them the crew's average. See [Stars](#stars). |
| **Added by** | Who put it on the list, as initials. Point at them for the name. |

A dash means the value is not known. BPM, key and energy are filled in for you when setlist.DJ knows the track, and
they are estimates; see [Add tracks](https://docs.setlist.dj/guide/add-tracks.md#bpm-key-and-energy).

### Show and hide columns

**Columns**, at the end of the column heads, has a checkbox for each column but the title. Untick the ones you do not need and the
rest close up. A few more start switched off and are there to turn on:

| Column | What it shows |
| - | - |
| **Dance** (Danceability) | How well it moves people, 0 to 100. |
| **Mood** | Dark to euphoric, 0 to 100. |
| **Pop.** (Popularity) | How much it is streamed now, 0 to 100. |
| **dB** (Loudness) | How loud the master is, in dB: closer to 0 is louder. |
| **Genre** | The genre its source gives. |
| **Album** | The release it is on. |
| **Label** | The record label. |

Your choice is kept in this browser and holds for every list you open in it. It changes what you see, not what the
others see.

On a narrow screen the table makes room: the artist moves under the title, the stars become a second line under it,
and the year, the words (genre, album, label) and the **Added by** column show only on a wide screen. On a phone the
BPM, key, energy and the other figures give way too; a click on the row still shows everything in the drawer.

## Keys

The **Key** column shows each key as a chip in the colour of its place on the Camelot wheel: twelve colours round the
wheel, the minor key (A) a shade darker than its major (B). Neighbours on the wheel have neighbouring colours, so a run
of tracks that drifts round the wheel reads as a gradual change of colour.

* **A solid chip** means the key mixes with the track before it: the same key, one step round the wheel, or the
  relative major or minor.
* **An outlined chip** means a key jump from the track before.
* **No chip** means a key the wheel does not know: it is shown as it was written, without colour.

Point at a chip to read why, for example *4A, F minor: mixes with the track before (5A)*. Run your eye down the column
and the outlines show where the set changes key.

## The SET score

**SET** (with the small flame) scores every track 0 to 100 on how hot it makes the room. It weighs the track's energy,
groove, popularity and loudness for your crowd and your sound, and the crew's stars nudge it: five stars push it up,
one star pulls it down. The flame is grey, and from 80 it turns yellow with the number in bold: a track that sets the
room on fire. A track without enough to go on has no score and shows a dash.

The crowd and the sound are two dials an editor sets in **List settings**: **The crowd** runs from **Underground** to
**Commercial**, **The sound** from **Deep** to **Driving**. Turn them and every score changes with them. How the score
is made, part by part, is in [Order the set](https://docs.setlist.dj/guide/order-the-set.md#the-set-score).

## Stars

Everyone who can comment or edit gives each track one to five stars. The stars in a row are yours: the ones you gave
are yellow. Beside them is the crew's average and how many gave stars, such as *4.3 from 3*. While nobody has given
any, the stars are empty and nothing stands beside them.

Tap a star to give that many, and another to change it. Tap the star you gave again to take your stars back. The same
stars are in the track drawer and in the player bar. Someone with a view-only link sees them greyed out and cannot
tap them.

## Reactions and comments

The reactions sit beside the title, each emoji with how many gave it. Your own are ringed in yellow. Point at one to
see who gave it, and tap one to add yours or take it back. To add a new one, point at the row and press the smiley
beside the title (**React**; on a phone it is always there): pick an emoji from the row, or type any emoji.

The speech bubble with a number is the comment count. A click on it opens the track on its
[Discussion](#discussion).

## Who added it, and what happened to it

The initials in **Added by** are whoever put the track on the list. The clock beside them shows the track's last
changes when you point at it or tap it: who added it and where, who moved it and where it landed, who removed it and
put it back. For example *Carl moved it from 7 to 3, after Marlo Vesk - Low Tide Theory*. **Show everything**, under
those lines, opens the track, with its whole story under [History](#history).

At the end of the row, for an editor, the drag handle moves the track, and the **⋯** menu has **Move up**, **Move
down**, **Move to maybe**, **Edit title and artist** and **Remove from list**. Moving tracks is in
[Order the set](https://docs.setlist.dj/guide/order-the-set.md#move-tracks-in-the-table).

## The track drawer

A click on a row (or on a track in the timeline at the top) opens the track drawer at the right, with the list still
in sight. On a computer the track is on one side and the talk about it on the other, with **Discussion** and
**History** as two tabs above it. On a phone or a tablet a switch at the top shows one at a time: **Track**,
**Discussion** and **History**.

![A drawer over the right of the list for Saltwater Signal (Night Mix) by Pell and Marrow. On the left a large grey cover with a T, the line No player for this one: it is your own file, or typed in by hand, then the facts: Length 7:12, BPM 126, Key 9A, Energy 58 of 100, Danceability 79 of 100, Mood 50 of 100, Popularity 63, SET score 71, Added by Anna, with Estimates, from the track's own audio under them. Then an Edit title and artist button, Notes for the booth with the note Mix in from the breakdown at 3:10, out before the vocal, and Save notes. On the right the tabs Discussion 3 and History, five stars with 4.7 from 3, a raised-hands reaction with 2 and a plus, then three comments from Anna, Carl and Jules, each with Delete, and at the foot a field saying Say the thing. Short is fine. with a Comment button.](https://mintcdn.com/setlist-dj/qvfs5uejTkbunr5n/guide/images/drawer.webp?fit=max\&auto=format\&n=qvfs5uejTkbunr5n\&q=85\&s=b9f3b6621ba5d299675ba971cc674766)

The track drawer: the track and its facts on the left, the Discussion on the right.

### The track

* **The cover** plays the track: press it and the track plays in the player bar at the foot of the window, which keeps
  playing while you scroll. Press it again to stop. Nothing loads from YouTube, SoundCloud or Spotify before you press
  it. A track without a player, such as your own file or a typed track, says *No player for this one* instead. See
  [Play tracks](https://docs.setlist.dj/guide/play-tracks.md).
* **Open on** with the source's name (**Open on Spotify**, **Open on Beatport**) takes you to the track's own page.
  Beside it a badge with the source's name, or **Your copy** for a track from your rekordbox export or your own files,
  or **Not found** for a track its source told nothing about.
* **The facts**: **Length**, **BPM**, **Key** (on the Camelot wheel and by name), **Album**, **Year**, **Genre**,
  **Label**, **Energy**, **Danceability**, **Mood**, **Popularity**, **SET score** and **Added by**, as far as they are
  known. Energy, danceability and mood are out of 100, with *Estimates, from the track's own audio* under them.
* **Edit title and artist** (editors) opens a form for the **Title**, the **Artist**, the **Length**, the **BPM** and
  the **Key**. Use it for a track whose source gave little, or to correct one. **Save** keeps it, **Cancel** leaves it.
* **Notes for the booth** is for the practical things: *Cue at the drop, mix out before the vocal, that kind of thing.*
  Editors write them and press **Save notes**; everyone on the list reads them.
* **Remove from list** (editors) takes the track off. See [Removed](#removed).

### Discussion

**Discussion**, with the number of comments beside it, holds your stars with the crew's average and the reactions,
then the comments, oldest at the top, and a field at the foot. Type in the field (*Say the thing. Short is fine.*) and press
**Comment**. A comment can be up to 600 characters. You can delete your own comments with **Delete**; the list's owner
can delete any.

To tell someone in particular, type **@** and pick a name from the people on the list. A person who has signed in gets
a mail with your comment and a button to reply on the list. A guest has no address, so they see it on the list
instead; the picker marks guests as such. The mail goes out when you are signed in yourself, and after you send the
comment a line says who got one. A list sends a limited number of these mails a day; after that the mention still shows
on the list.

Commenting, stars and reactions are for everyone whose link lets them comment or edit. Someone who can only look reads
the discussion but cannot join in.

### History

**History** is the track's whole story on this list, oldest first: who added it and where, every move, every edit,
when it went to Maybe and back, and when it was removed and put back.

## Maybe

Under the set sits **Maybe**: tracks kept in reserve, not on the set. They keep everything they have (stars, comments,
notes, history), but nothing that measures the set counts them: not the track count and the running length under the
title, not the timeline, not **Analyse set**, not the downloads for rekordbox and other DJ apps, not **Copy as text**.
**Download CSV** has both the set and the Maybe list.

![Under the add panel the Maybe section, count 1, with a Hide button, and a table with the same column heads as the set holding one track: Quiet Car by Hollis Ward, 122 BPM, key 7A, energy 40, SET score 43, length 6:20, five empty stars, added by AN. Below it the Removed section, count 1, with Hide, holding Everything Is a Remix by Bram Oost, removed by Jules just now, with the buttons Put it back and Permanently delete. At the foot of the page the link Something missing? Tell us.](https://mintcdn.com/setlist-dj/qvfs5uejTkbunr5n/guide/images/maybe-removed.webp?fit=max\&auto=format\&n=qvfs5uejTkbunr5n\&q=85\&s=976c932d49ea63870d206c89af1ac8a1)

Maybe with one track in reserve, and Removed with one track that can be put back or deleted for good.

For an editor:

* **Move to maybe** in a set row's **⋯** menu puts the track at the end of the Maybe list.
* **Move to the set** in a Maybe row's **⋯** menu puts it back at the end of the set.
* **Drag** a row from the set onto the Maybe list, onto a row there or anywhere on the section, even while it is empty
  or folded away. Drag a Maybe row onto the set to put it back at that place. Within either list, drag to reorder.

Editors see the Maybe section as soon as the set has a track; everyone else once it holds tracks. **Hide** and **Show**
fold it away and open it again.

## Removed

**Remove from list**, in the drawer or the row's **⋯** menu, takes a track off. A line says it is under **Removed** now,
with **Undo** for a few seconds, which puts it back where it was.

Removing a track takes its stars, reactions and comments with it. The track itself is kept, with its facts and notes,
in **Removed** at the foot of the page. That section shows only while it holds something and starts folded: press
**Show**. Each removed track shows its artist, who removed it and when.

An editor has two buttons on each:

* **Put it back** returns the track to the end of the set, or of the Maybe list if that is where it was.
* **Permanently delete** asks first: *Delete Everything Is a Remix for good? Its notes and its history go too, and
  nothing brings it back. Added again later, it starts afresh.* Press **Delete** to confirm, or **Cancel**. The
  track, its notes and its whole story go. The list's history keeps one line, such as *Jules deleted Bram Oost -
  Everything Is a Remix for good*. If you add the track again later, it comes in as a new track, and setlist.DJ finds
  its BPM, key and energy again.

Removed tracks are also listed at the top of the list's **History**, in the **⋯** menu, with the same two buttons.

## Questions

> [accordion] A track has no BPM, key or energy
>
> setlist.DJ fills them in when it knows the track, usually within a minute of it landing. A track it cannot
> identify, such as an unreleased edit, keeps a dash. An editor can type the BPM and key with **Edit title and
> artist**.

> [accordion] A track says Not found
>
> Its source told nothing about it: the link is private, the track is gone, or the source did not answer. The link is
> kept, and the drawer says *Private link: fill in the title and artist yourself.* An editor does that with **Edit
> title and artist**.

> [accordion] I cannot give stars or comment
>
> Your link lets you look, not comment. The stars show greyed out. Ask the owner for a link that can comment or edit.

> [accordion] A column is missing
>
> It may be switched off under **Columns**, or the screen may be too narrow for it. Open the track to see all of its
> facts.

> [accordion] The others see different columns
>
> **Columns** is kept per browser. What you switch on or off changes your view only.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.