Skip to content

Track & Song Metadata

Overview

The {track} transformer (and its alias {song}) exposes the full metadata of the active audio track playing in the server.

Base Object: RythraTrack
Aliases: {track}, {song}
Null Behavior: Returns empty string ("") or default values when no track is active.

Properties Reference

PropertyTypeDescriptionExample Output
{track}stringTrack Title (default string output)Bones
{track.title}stringTitle of the audio trackBones
{track.author}stringArtist, channel, or creator nameImagine Dragons
{track.uri}stringOfficial web link / URL to the trackhttps://www.youtube.com/watch?v=...
{track.url}stringAlias for {track.uri}https://www.youtube.com/watch?v=...
{track.thumbnail}stringDirect image URL to album artworkhttps://i.ytimg.com/vi/.../maxresdefault.jpg
{track.duration}numberTotal track duration in milliseconds165000
{track.durationFormatted}stringFormatted track duration (MM:SS or HH:MM:SS)02:45
{track.position}numberActive playback position in milliseconds45000
{track.positionFormatted}stringFormatted playback position (MM:SS)00:45
{track.remainingTime}stringRemaining time before track completes02:00
{track.isSeekable}booleanWhether seeking forward/backward is allowedtrue
{track.isStream}booleanWhether the track is a continuous live streamfalse
{track.hasTrack}booleantrue if a track is active, false otherwisetrue
{track.requester}stringUsername of the member who added the trackerrordoc404
{track.requesterId}stringSnowflake User ID of the requester456130838183280651
{track.requesterMention}stringFormatted Discord mention of requester<@456130838183280651>
{track.identifier}stringUnique audio source identifierV2SVRJ6dcE4
{track.sourceName}stringAudio source provider (youtube, spotify, soundcloud)youtube

Example Usage

Now Playing Embed

{embed(title):🎵 Now Playing}
{embed(description):**[{track.title}]({track.uri})**\nBy **{track.author}**}
{embed(thumbnail):{track.thumbnail}}
{embed(field):Duration~{track.durationFormatted}~true}
{embed(field):Requested By~{track.requesterMention}~true}
{embed(color):0x5865F2}