Struct TrackMetadata 

pub struct TrackMetadata {

    pub title: String,
    pub artist: String,
    pub album: String,
    pub album_artist: String,
    pub date: String,
    pub year: String,
    pub lyrics: String,
    pub prompt: String,
    pub comment: String,
    pub style: String,
    pub style_summary: String,
    pub model: String,
    pub handle: String,
    pub parent: String,
    pub root: String,
    pub lineage: String,
    pub id: String,
    pub url: String,
    pub track: u32,
    pub track_total: u32,
}

The metadata tags written into a downloaded audio file.

Fields

title: String

artist: String

album: String

album_artist: String

date: String

year: String

The album’s release year (YYYY): the lineage root’s creation year, or the clip’s own year when the root’s is unavailable.

lyrics: String

prompt: String

comment: String

style: String

style_summary: String

model: String

handle: String

parent: String

root: String

lineage: String

id: String

The clip’s own Suno id, embedded as SUNO_ID.

url: String

The canonical https://suno.com/song/<id> page URL, embedded as SUNO_URL. Empty when the clip has no id.

track: u32

This track’s 1-based position within its lineage album, or 0 when unnumbered. Written as TRACKNUMBER/TRCK/trkn.

track_total: u32

The album’s track count paired with track, or 0 when unnumbered.

Implementations

impl TrackMetadata

pub fn from_clip(clip: &Clip, lineage: &LineageContext) -> TrackMetadata

Map a Clip plus its resolved LineageContext to its tag set, mirroring ha-suno’s to_track_metadata.

artist and album_artist fall back to "Suno", and date is the YYYY-MM-DD prefix of created_at. year is the lineage root’s creation year (the clip’s own year when the root’s is unavailable), so an album whose tracks cross a calendar boundary groups under one year. The album, parent, root, and lineage tags come from the resolved context, not the clip’s own edited_clip_id pointer, and the generation prompt is preserved in its own SUNO_PROMPT tag.

Trait Implementations

impl Clone for TrackMetadata

fn clone(&self) -> TrackMetadata

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TrackMetadata

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TrackMetadata

fn default() -> TrackMetadata

Returns the “default value” for a type.

impl Eq for TrackMetadata

impl Hash for TrackMetadata

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TrackMetadata

fn eq(&self, other: &TrackMetadata) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TrackMetadata