AutonomousKoi - Trackstar

Configuration

Demo Delay Seconds

trackstar has a built-in demo mode to help while configuring it. If Demo Delay Seconds is greater than 0, trackstar will randomly pick from a built-in list of artist names and from a list of track titles and send that as a newly-played track. It will wait the specified number of seconds and repeat the process.

Track Delay Seconds

When trackstar is notified that a new track is playing it will delay notifying other modules by this number of seconds. When set to 0, there's no delay. A value of 5 means that nothing else will become aware of the new track for at least 5 seconds.

The DJ software that track data comes from (e.g. Rekordbox, VirtualDJ) may impose a configurable delay before a track you've played becomes visible to trackstar. The Track Delay Seconds setting adds a delay on top of that.

Save Sessions

When Save Sessions is checked, trackstar will save a record of the tracks played in this session to the database to be recalled later.

Clear Bracketed Text

You may want to hide specific details of a track you play. For example, it might be a yet unreleased track and while you have permission to play it, you may not have permission to tell people about it. The Clear Bracketed Text setting will cause trackstar to process the Artist and Title of each track. Any text contained in square brackets ([]) will be replaced with a space. Then, duplicate spaces will be removed.

Say you've received the unreleased track by Billain't entitled Smacula. You can edit the track data in your DJ software to have the Artist read Neurofunk Producer [Billain't] and the title to read Unreleased Track [Smacula]. When the track is played with Clear Bracketed Text enabled trackstar will edit the track message to have the artist Neurofunk Producer and the title Unreleased Track. When the track is released you can go back into your DJ software and strip out everything outside the brackets and the brackets themselves to have the original text displayed with future plays.

Track Replacements

The Track Replacements feature serves a similar purpose to Clear Bracketed Text but works in a different way. Each replacement has three parts: Match, Artist, and Title. When a track is played where the Artist or Title matches the text of Match, trackstar will replace the Artist and Title of the track message with the Artist and Title specified in the Track Replacement.

For example, you can create a track replacement like the following:

Match

-UR-

Artist

Artist Redacted

Title

Unreleased Track

You can then update your library so that -UR- appears in the Artist or Title of all unreleased tracks. When you play one of these tracks, the track data will be replaced to show Artist Redacted/Unreleased Track. This requires less editing in your library but is less flexible.

Note: The Match is case-sensitive. -UR- as your match will effect tracks with -UR- in them, but not -Ur- or -ur-.

Tags

The Tags feature allows you to define tags that can be applied to the most recently received track. For example, a banger tag might indicate a particularly good mix. A fix tag might indicate that you need to fix the grid or hot cues of the track. This can keep you in the mix without forgetting something important.

Clicking the + button next to Tags will allow you to add a new tag.

Below the Tags header is a table of the currently-defined tags. Clicking the Delete button will delete the tag after a confirmation. Clicking the Apply button will apply the tag to the most recent track. The link to the right of the Apply button is a direct link to apply this tag. This is useful with tools like a Stream Deck; a Website action can use this URL with GET request in background.

Send Test Track

You may want to test how trackstar will handle some track data but don't want to load up your DJ software and start playing. Using Send Test Track you can send a track through trackstar as if it had come from DJ software.

It will be processed exactly the same as a track that did come from your DJ software, including any delay specified in Track Delay Seconds. It will appear in your track log, in the overlay if you're using trackstaroverlay and will appear in Twitch Chat if you're using trackstartwitchchat.

Track Log

trackstar keeps track of all tracks played during your session. A log of these tracks is displayed here in chronological order.

At the top of the Track Log section is a dropdown where you can select previously-saved sessions. While a previous session is being viewed, newly-played tracks aren't displayed but they are added to the current session.

You can click Download to download a copy of this log in CSV format that you can pull into Excel, Google Sheets, or sqlite.