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.

Override rule: manual value → detected ID3 value → filename fallback.

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.

AudioFly manual Playlist track editor with one track expanded in the Joomla backend.
Manual / Migrated Tracks editor showing compact rows, reordering controls, add/remove buttons and one expanded track for detailed editing.

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.

  1. Set Track Source to Folder Scan.
  2. Enter an Audio Folder below /images or /media.
  3. Optionally enter a separate Artwork Folder.
  4. Choose whether to scan subfolders.
  5. Select allowed file types: MP3, OGG, M4A and/or WAV.
  6. Choose sorting and cache behavior.
  7. Save & Refresh Tracks.
AudioFly Folder Scan settings and unified track list in the Joomla backend.
Folder Scan configuration with audio folder, allowed file types, sorting, cache setting and the generated logical track list in a single workflow.

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.

Expanded AudioFly Folder Scan track showing detected metadata fields in the Joomla backend.
A scanned track can be reviewed before publication, including detected values such as title, artist, album, year, duration and the linked source context.

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.

AudioFly Artwork Source section showing embedded ID3 artwork and detected folder artwork.
Artwork Source with both embedded ID3 artwork and detected folder artwork visible, making it clear how Auto or a specific artwork source can be chosen.

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.