Uploading Files

The upload interface processes audio files and extracts metadata automatically. Files can be assigned media types, playlists, and custom fields during upload.

Prerequisites

Supported Formats

Format	Extension	Notes
MP3	.mp3	All bitrates supported
WAV	.wav	Converted to configured format
FLAC	.flac	Lossless, larger files
AAC	.aac, .m4a	Including iTunes format
OGG	.ogg	Vorbis codec

File Size Limits

The maximum file size is 500 MB per file. Files exceeding this limit are rejected before upload begins.

Upload Interface

Access the upload interface via Project → Media Library → Upload or by clicking the upload button in the library toolbar.

The interface has three columns:

• Left: File list with status indicators
• Center: Metadata editor for selected file
• Right: Media type and playlist assignment

Adding Files

Drag files from your file manager onto the upload area. Alternatively, click Select Files to open the file picker.

Add multiple files at once. Each file appears in the left column with a pending status.

Metadata Extraction

The system extracts metadata from file tags automatically:

Field	Source	Editable
Artist	ID3/Vorbis tag	Yes
Title	ID3/Vorbis tag	Yes
Album	ID3/Vorbis tag	Yes
Year	ID3/Vorbis tag	Yes
Genre	ID3/Vorbis tag	Yes
ISRC	ID3/Vorbis tag	Yes
BPM	ID3/Vorbis tag or analysis	Yes
Duration	Audio analysis	No
Cover	Embedded image	Yes

Missing fields can be entered manually before upload.

Duplicate Detection

The system checks for duplicates using two methods:

1. ISRC match: Files with identical ISRC codes are flagged
2. String similarity: Artist and title combinations with 95% or higher similarity trigger a warning

When a duplicate is detected:

• A warning icon appears next to the file
• Click the icon to view the existing file
• Choose to skip the duplicate or upload anyway

File Validation

Each file must pass validation before upload:

Required fields:

• Artist
• Title

Validation states:

State	Icon	Description
Valid	Green check	Ready to upload
Warning	Yellow triangle	Duplicate detected or optional field missing
Error	Red circle	Required field missing or invalid format

Files with errors cannot be uploaded until the issues are resolved.

Assigning Attributes

Media Type

Select a media type from the dropdown. This field is required.

Media types determine how files are used in scheduling. See Media Types and Fields for configuration.

Playlists

Select one or more playlists to add the file to after upload. This field is optional.

Click Create New to create a playlist without leaving the upload interface.

Custom Fields

If custom fields are configured, they appear below the playlist selector. Fill in values as needed.

Starting Upload

Before starting:

1. Verify all files show a valid status
2. Confirm media types are assigned
3. Review metadata for accuracy

Click Start Upload to begin processing.

Upload Queue

Files upload with a maximum of 5 concurrent transfers. The queue displays:

Information	Description
Progress	Percentage and progress bar
Speed	Current upload speed in MB/s
ETA	Estimated time remaining
Status	Uploading, Processing, Complete, or Failed

Processing occurs after upload completes. This includes audio analysis and waveform generation.

Troubleshooting

Problem	Cause	Solution
Upload fails immediately	File too large	Reduce file size or split into parts
Format not recognized	Unsupported codec	Convert to a supported format
Metadata not extracted	Corrupt or missing tags	Enter metadata manually
Duplicate warning incorrect	Similar but different tracks	Click upload anyway to proceed
Upload stuck at processing	Server load	Wait or retry later
Connection error	Network issue	Check connection and retry

Related Topics

• Media Library - Browse and manage uploaded files
• Media Types and Fields - Configure types and custom fields
• Playlists - Organize files into playlists