Skip to content

sok.media.music.track

Track class for individual music tracks.

Track

class Track(
name: str,
language: str,
media_manager: UniversalMediaManager,
artist: str = '',
album: str = '',
track_number: int = 1,
)

Bases: BaseMedia

Class for managing individual music tracks.

Represents a single music track with metadata.

Initialize a Track instance.

Parameters

NameTypeDefaultDescription
namestrTrack title.
languagestrLanguage code.
media_managerUniversalMediaManagerThe API manager.
artiststr''Artist name.
albumstr''Album name.
track_numberint1Track number in album.
Source

Attributes

NameTypeDescription
album

Album name.

album_idOptional[str]

Album ID.

artist

Track artist name.

durationOptional[int]

Duration in seconds.

explicitbool

Whether track contains explicit content.

isrcOptional[str]

International Standard Recording Code.

track_number

Track number in album.

yearOptional[int]

from_dictclassmethod

def from_dict(
data: Dict[str, Any],
media_manager: UniversalMediaManager,
) -> Track:

Create a Track instance from a dictionary.

Parameters

NameTypeDescription
dataDict[str, Any]Track data.
media_managerUniversalMediaManagerThe API manager.

Returns

Source

get_detailsasync

async def get_details() -> None:

Retrieve detailed track information.

Fills attributes: artist, album, duration, isrc, etc.

Source

get_duration_formatted

def get_duration_formatted() -> str:

Return formatted duration (MM:SS).

Returns

  • strFormatted duration string.
Source

get_folder_structure

def get_folder_structure() -> List[str]:

Return the recommended folder hierarchy.

The batch pages use the music format of the settings instead (see MusicFileOperations.format_track).

Returns

  • List[str]List of folder names [artist, album], without the empty ones.
Source

get_formatted_name

def get_formatted_name() -> str:

Return the formatted track name.

Format: '## - Track Title'

Returns

  • strFormatted track name.
Source

get_full_name

def get_full_name() -> str:

Return the full track name with artist.

Returns

  • strFull track name (e.g., 'Queen - Bohemian Rhapsody').
Source

to_dict

def to_dict() -> Dict[str, Any]:

Convert the track to a dictionary.

Returns

  • Dict[str, Any]Track data as dictionary.
Source
Built with Kiln