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
| Name | Type | Default | Description |
|---|---|---|---|
name | str | Track title. | |
language | str | Language code. | |
media_manager | UniversalMediaManager | The API manager. | |
artist | str | '' | Artist name. |
album | str | '' | Album name. |
track_number | int | 1 | Track number in album. |
Attributes
| Name | Type | Description |
|---|---|---|
album | Album name. | |
album_id | Optional[str] | Album ID. |
artist | Track artist name. | |
duration | Optional[int] | Duration in seconds. |
explicit | bool | Whether track contains explicit content. |
isrc | Optional[str] | International Standard Recording Code. |
track_number | Track number in album. | |
year | Optional[int] |
from_dictclassmethod
def from_dict( data: Dict[str, Any], media_manager: UniversalMediaManager,) -> Track:Create a Track instance from a dictionary.
Parameters
| Name | Type | Description |
|---|---|---|
data | Dict[str, Any] | Track data. |
media_manager | UniversalMediaManager | The API manager. |
Returns
TrackTrack instance.
get_detailsasync
async def get_details() -> None:Retrieve detailed track information.
Fills attributes: artist, album, duration, isrc, etc.
Sourceget_duration_formatted
def get_duration_formatted() -> str:Return formatted duration (MM:SS).
Returns
strFormatted duration string.
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.
get_formatted_name
def get_formatted_name() -> str:Return the formatted track name.
Format: '## - Track Title'
Returns
strFormatted track name.
get_full_name
def get_full_name() -> str:Return the full track name with artist.
Returns
strFull track name (e.g., 'Queen - Bohemian Rhapsody').
to_dict
def to_dict() -> Dict[str, Any]:Convert the track to a dictionary.
Returns
Dict[str, Any]Track data as dictionary.