How BitDek Reads Your Tags

This guide explains exactly which metadata fields BitDek reads from your audio files, how different formats store the same information, and what happens when fields are missing.

The Extraction Process

When you import a file, BitDek:

1. Reads the raw metadata from the file
2. Applies folder-based fallbacks for missing fields
3. Determines the Album Artist (if not explicitly set)
4. Creates or matches database entries

The order matters. Fallbacks happen before album artist detection, which allows the detection system to work even when files have incomplete tags.

Fields by Format

FLAC (Vorbis Comments)

BitDek reads FLAC files using native Vorbis comment parsing. Field names are case-insensitive.

Core Track Fields:

BitDek Field	Vorbis Comment Name	Notes
Title	TITLE	Required for display
Sort Title	TITLESORT	For custom sort order
Artist	ARTIST	The track performer
Sort Artist	ARTISTSORT	For custom sort order
Album	ALBUM	Groups tracks together
Sort Album	ALBUMSORT	For custom sort order
Album Artist	ALBUMARTIST or ALBUM ARTIST	Primary album performer
Sort Album Artist	ALBUMARTISTSORT	For custom sort order
Track Number	TRACKNUMBER	Format: “5” or “5/12”
Disc Number	DISCNUMBER	Format: “1” or “1/2”
Total Tracks	TOTALTRACKS or TRACKTOTAL	Or extracted from TRACKNUMBER
Total Discs	TOTALDISCS or DISCTOTAL	Or extracted from DISCNUMBER
Genre	GENRE	Comma, semicolon, slash, or backslash separated
Compilation	COMPILATION	”1” or “true” for compilations

Date Fields (FLAC):

BitDek Field	Vorbis Comment Name	Notes
Release Date	DATE	Full date or year
Release Year	DATE or YEAR	Year extracted from DATE
Original Release Date	ORIGINALDATE	First release date
Original Release Year	ORIGINALYEAR	Or extracted from ORIGINALDATE
Recording Date	RECORDINGDATE	When recorded

Album Information (FLAC):

BitDek Field	Vorbis Comment Name	Notes
Edition	EDITION or VERSION	”Deluxe Edition”, “Remaster”, etc.
Primary Type	RELEASETYPE	Album, EP, Single, Compilation
Record Label	PUBLISHER or LABEL	Publishing label
Catalog Numbers	CATALOGNUMBER or LABELNO	Label catalog ID
Barcode	BARCODE	UPC/EAN code
Language	LANGUAGE	Album language
Country of Release	RELEASECOUNTRY	Release territory

Multi-Artist Fields (FLAC):

BitDek Field	Vorbis Comment Name	Notes
Track Artists	TRACKARTIST or PERFORMER	Additional performers
Composers	COMPOSER	Song writers
Lyricists	LYRICIST or WRITER	Lyric authors
Producers	PRODUCER	Production credits
Mixers	REMIXER or MIXER	Mix/remix credits

Classical Music Fields (FLAC):

BitDek Field	Vorbis Comment Name
Work	WORK
Movement Name	MOVEMENTNAME
Movement Number	MOVEMENTNUMBER or MOVEMENT
Movement Total	MOVEMENTTOTAL

MP3 (ID3 Tags)

BitDek reads MP3 metadata through iOS AVFoundation, which handles ID3v2.3 and ID3v2.4 tags.

Core Track Fields:

BitDek Field	ID3 Frame	Notes
Title	TIT2	Track title
Sort Title	TSOT	For custom sort order
Artist	TPE1	Lead performer
Sort Artist	TSOP	For custom sort order
Album	TALB	Album title
Sort Album	TSOA	For custom sort order
Album Artist	TPE2	Band/orchestra/accompaniment
Sort Album Artist	TSO2	For custom sort order
Track Number	TRCK	Format: “5” or “5/12”
Disc Number	TPOS	Format: “1” or “1/2”
Genre	TCON	Single value only via AVFoundation
Compilation	TCMP	iTunes compilation flag

Date Fields (MP3):

BitDek Field	ID3 Frame	Notes
Release Date	TDRL (v2.4)	Release date
Year	TDRC (v2.4) or TYER (v2.3)	Recording/release year
Original Release Year	TORY (v2.3) or TDOR (v2.4)	First release
Recording Date	TDRC	When recorded

Album Information (MP3):

BitDek Field	ID3 Frame	Notes
Edition	TXXX:EDITION or TXXX:VERSION	Custom frame
Record Label	TPUB	Publisher
Catalog Numbers	TXXX:CATALOGNUMBER	Custom frame
Barcode	TXXX:BARCODE	Custom frame
Country of Release	TXXX:RELEASECOUNTRY	Custom frame

Multi-Artist Fields (MP3):

BitDek Field	ID3 Frame	Notes
Composers	TCOM	Song writers
Lyricists	TEXT	Lyric authors
Mixers	TPE4	Remixer/mixer

Classical Music Fields (MP3):

BitDek Field	ID3 Frame	Notes
Work	TXXX:WORK or TIT1	Extended frame or Content Group
Movement Name	MVNM	ID3v2.4
Movement Number	MVIN	Format: “3/5”
Movement Total	MVIN	Extracted from “3/5” format

M4A/AAC (iTunes Atoms)

BitDek reads M4A files through iOS AVFoundation.

Core Track Fields:

BitDek Field	iTunes Atom	Notes
Title	©nam	Track name
Artist	©ART	Track artist
Album	©alb	Album name
Album Artist	aART	Album artist
Track Number	trkn	Stored as number pair
Disc Number	disk	Stored as number pair
Genre	©gen	Single genre
Year	©day	Release date
Compilation	cpil	Boolean flag

Classical Music Fields (M4A):

BitDek Field	iTunes Atom
Work	©wrk
Movement Name	©mvn
Movement Number	©mvi
Movement Total	©mvc

Audio Technical Information

BitDek extracts technical details from the audio stream itself, not from tags:

Field	Source	Notes
Format	File analysis	FLAC, MP3, AAC, etc.
Codec	File analysis	Encoder used (e.g., “LAME 3.100”)
Bit Rate	Audio stream	In kbps
Sample Rate	Audio stream	In Hz (e.g., 44100, 96000)
Channels	Audio stream	1 (mono) or 2 (stereo)
Bits Per Sample	Audio stream	16 or 24 bit depth
Duration	Audio stream	Calculated from samples
File Size	File system	In bytes

These values appear in the Track Info sheet under “Audio Technical.”

Folder-Based Fallbacks

When a file lacks certain metadata, BitDek uses folder names as fallbacks. This happens automatically during import.

Album Fallback

If the album field is empty:

• BitDek reads the parent folder name
• Example: /Music/Pink Floyd/Dark Side of the Moon/track.flac
• Album becomes: “Dark Side of the Moon”

Title Fallback

If the title field is empty:

• BitDek uses the filename
• Track number prefixes are stripped (“01 - ” or “01.” patterns)
• Example: 01 - Speak to Me.flac becomes “Speak to Me”

Artist Fallback

If the artist field is empty:

• BitDek checks the grandparent folder (assumes Artist/Album/Track structure)
• Example: /Music/Pink Floyd/Dark Side of the Moon/track.flac
• Artist becomes: “Pink Floyd”
• Skipped if grandparent is “Music” or empty

Edition Fallback

If the edition field is empty, BitDek attempts to extract it from the album title using common patterns:

• Parentheses: Album Name (Deluxe Edition) → Edition: “Deluxe Edition”
• Brackets: Album Name [2023 Remaster] → Edition: “2023 Remaster”

This works for all supported formats.

Why Fallbacks Matter

The fallback system allows BitDek to organize files that lack proper tags. But fallbacks have limits:

• They assume a specific folder structure (Artist/Album/Track)
• They can’t distinguish compilation albums from regular albums
• They may produce incorrect results for unusually organized collections

For the best experience, properly tagged files beat folder-based guessing.

Extraction Order (Technical Detail)

The extraction sequence is critical for correct album artist detection:

1. Extract raw metadata from file tags
2. Apply folder-based fallbacks (album, title, artist)
3. Three-Tier Album Artist Detection
4. Multi-genre parsing (FLAC only)
5. Artwork extraction
6. Database entity creation/matching

Folder fallbacks occur BEFORE album artist detection. This matters because the detection system queries existing tracks by album name. Without the album fallback first, tracks without album tags would skip detection entirely.

See Album Artist and Compilations for details on the three-tier detection system.

Multi-Value Fields

FLAC Genre Handling

FLAC files can store multiple genres in a single GENRE comment. BitDek recognizes four separators:

• Comma: Rock, Alternative (preferred)
• Semicolon: Rock;Alternative
• Forward slash: Electronic/Ambient
• Backslash: Electronic\Ambient

Each value becomes a separate genre in your library. A track tagged Jazz, Fusion, Instrumental appears in all three genre categories.

Multi-Artist Fields

FLAC supports multiple values for artist-related fields. When you have multiple composers or performers, separate them with commas, semicolons, or slashes:

• Composers: John Lennon, Paul McCartney (preferred)
• Producers: George Martin, Phil Spector

BitDek also recognizes collaboration patterns like “feat.”, “featuring”, “with”, ”&”, and “vs.” when parsing artist names. Each name becomes a separate artist entry in your library.

Other Formats

MP3, M4A, and AAC files are limited to a single genre through AVFoundation. If your MP3 has multiple TCON frames, BitDek sees only the first one.

This is an iOS platform limitation, not a BitDek design choice. The workaround is using FLAC for genre-heavy collections.

Special Cases

Compilation Detection Without Tags

Some older files lack the compilation flag but are clearly compilations. BitDek detects this by watching for multiple artists within the same album folder. See Album Artist and Compilations for the full detection process.

Track Numbers With Leading Zeros

BitDek handles track numbers in various formats:

• 5 → Track 5
• 05 → Track 5
• 5/12 → Track 5 of 12
• 05/12 → Track 5 of 12

Leading zeros are normalized to integers.

Date vs. Year

Some taggers use full dates (2023-03-15) while others use just the year (2023). BitDek extracts the year portion from full dates for consistent display.

Case Sensitivity

Artist and album matching in BitDek is case-insensitive. “Pink Floyd” and “pink floyd” are treated as the same artist. The display preserves the case from the first imported file.

Verification Tips

To check how BitDek will read your files:

1. Import a sample of files from your collection
2. View the track details in BitDek (tap the info button)
3. Compare against what your tagging software shows
4. Look for discrepancies in album artist, genre, or classical fields

If you see unexpected results, the most common causes are:

• Missing album artist tag (triggers fallback detection)
• Multiple genre values in MP3 (only first appears)
• Unusual folder structure (affects fallback accuracy)

Further Reading

• Album Artist and Compilations - Three-tier album artist detection
• Multi-Genre Tagging - Working with multiple genres in FLAC
• Classical Music Tags - Work and movement field details
• Recommended Tagging Tools - Software for editing your metadata