The trackstar module helps DJs by facilitating the exchange of data
about currently playing tracks. trackstar isn't useful on its own.
It needs a module like
trackstarrekordboxdb,
trackstarstagelinq, or
trackstarvirtualdj to provide
track data, and a module like
trackstaroverlay or
trackstartwitchchat to
display the track data.
The trackstar module has one link: an interface for configuring
the module and retrieving a log of all tracks played during the session.
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.
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-.
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. This log is
not saved between sessions. You can click Download to download
a copy of this log in CSV format that you can pull into Excel, Google Sheets,
or sqlite.