Uploading Files
The upload interface processes audio files and extracts metadata automatically. Files can be assigned media types, playlists, and media fields during upload.
Prerequisites
Supported Formats
| Format | Extension | Notes |
|---|---|---|
| MP3 | .mp3 | All bitrates supported |
| MP2 | .mp2 | MPEG Audio Layer II |
| WAV | .wav | Converted to configured format |
| FLAC | .flac | Lossless, larger files |
| OGG | .ogg | Ogg Vorbis |
| WebM | .webm | WebM audio |
| M4A | .m4a | MPEG-4 audio |
| AAC | .aac | Advanced Audio Coding |
File Size Limits
The maximum file size is 1 GB per audio file. Cover images are limited to 20 MB.
Upload Interface
Access the upload page via Media Library in the project sidebar, then click Upload.
The interface has two panels:
- Left: File list with metadata fields per file (expandable)
- Right: Upload queue and sidebar for media type, playlist assignment, and upload controls
A storage banner at the top shows current storage usage and available space.
Adding Files
Drag files from your file manager onto the drop zone. Alternatively, click to open the file picker.
Add multiple files at once. Each file appears in the left panel with metadata extracted from tags.
Metadata Extraction
The system extracts metadata from file tags automatically:
| Field | Source | Editable |
|---|---|---|
| Title | ID3/Vorbis tag | Yes |
| Artist | ID3/Vorbis tag | Yes |
| Album | ID3/Vorbis tag | Yes |
| Year | ID3/Vorbis tag | Yes |
| Genre | ID3/Vorbis tag | Yes |
| ISRC | ID3/Vorbis tag | Yes |
| Duration | Audio analysis | No |
| Cover | Embedded image | Yes |
Missing fields can be entered manually before upload. An Autofill button is available to automatically fetch metadata and cover art from external sources.
Duplicate Detection
The system checks for duplicates server-side during upload. When a duplicate is detected:
- A warning appears for the file
- The existing file is referenced
- Choose to skip the duplicate or upload anyway
File Validation
Each file must pass validation before upload:
Required fields:
- 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. If a file fails server-side validation, a re-encode to MP3 can be triggered directly from the upload queue.
Assigning Attributes
Media Type
Select a media type from the dropdown in the sidebar. This determines how files are used in scheduling. See Media Types and Fields for configuration.
Playlists
Select one or more playlists to add files to after upload.
Media Fields
If media fields are configured for the selected type, they appear below the playlist selector.
Starting Upload
- Verify all files show a valid status
- Confirm media types are assigned
- Review metadata for accuracy
- Click Upload
Upload Queue
The upload queue shows each file with:
| Column | Description |
|---|---|
| File | Filename |
| Progress | Upload progress bar |
| Size | File size |
| State | Uploading, Processing, Complete, or Failed |
The number of concurrent uploads is configurable in the upload settings.
Troubleshooting
| Problem | Cause | Solution |
|---|---|---|
| Upload fails immediately | File too large (over 1 GB) | 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 or use Autofill |
| 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 media fields
- Playlists - Organize files into playlists