AudioFly documentation Tracks, Sources, Folder Scan & ID3 Metadata
AudioFly — Tracks, Sources, Folder Scan & ID3 Metadata
AudioFly uses one internal track model whether a track comes from Single Track, a manually built collection or Folder Scan.
1. Single Track
Use Single Track when one audio item should appear independently on a page. Select the audio file and optionally provide manual Title, Artist, Album, Track Number, Year, Publisher, Artwork, Description and Action URL.
When Auto-detect ID3 Metadata is enabled, empty fields fall back to detected metadata. Use Save & Refresh Metadata after changing the file.
2. Playlist and Grid Track Source
Playlist and Grid offer two Track Source modes:
- Manual / Migrated Tracks
- Folder Scan
3. Manual Tracks
The Manual Tracks editor lets you add, remove and reorder tracks. Each track can contain:
- Audio File
- Use ID3 Metadata
- Title, Artist, Album, Track Number, Year, Publisher
- Artwork
- Description
- Action URL and Action Label
- Play Label
Track rows stay compact until opened, making long playlists easier to manage.
Resetting manual metadata to ID3
For tracks using ID3 metadata, manual fields are overrides. Clear/reset the metadata overrides and save to return to detected values.
4. Folder Scan
Folder Scan can build Playlist and Grid collections automatically from Joomla media folders.
- Set Track Source to Folder Scan.
- Enter an Audio Folder below
/imagesor/media. - Optionally enter a separate Artwork Folder.
- Choose whether to scan subfolders.
- Select allowed file types: MP3, OGG, M4A and/or WAV.
- Choose sorting and cache behavior.
- Save & Refresh Tracks.
5. Logical tracks and multiple audio formats
If AudioFly finds alternative formats with the same logical name, they are grouped as one track instead of appearing as duplicates.
Example:
California Gurls.mp3
California Gurls.ogg
→ one logical track with MP3 + OGG sources
This keeps My Music and Up Next clean while still allowing the browser to use an appropriate source.
6. Metadata detected from audio files
AudioFly can detect:
- Title
- Artist
- Album
- Track Number
- Year
- Publisher
- Duration
- Embedded artwork
Detected information is visible in the backend before publication.
7. Artwork source
Folder Scan can use several artwork sources per logical track:
- Auto — detected folder artwork first, then embedded ID3 artwork.
- Embedded artwork (ID3) — force the image stored inside the audio file.
- Detected folder artwork — force the matched JPG/PNG/WEBP image.
- Manual artwork path — use a selected image from Joomla media.
- No artwork — disable artwork for that track.
AudioFly can also match filenames with normalized separators, so 31 Minute to Takeoff.mp3 can match 31-Minute-to-Takeoff.jpg.
8. Excluding a scanned track
Uncheck Include this track to keep a file in the folder without publishing it in the AudioFly collection.
9. Folder Scan cache
Available cache durations are Disabled, 1 minute, 5 minutes and 15 minutes. Use Disabled while building/testing. A cache is useful for stable production folders because ID3 analysis does not need to run on every request.
10. Action links
Each track can include an Action URL and Action Label. Typical uses include Buy, Download, More Info or a product page. The action can appear in source layouts, My Music and Up Next when enabled.