albums

rules
Cover art
Look for missing artwork and attempt to fill in any blanks. Save an image artwork file to cover. Artwork should be embedded.
bliss will assess and store separate cover art image files for each album with these names, suffixed with the correct image extension, such as '.jpg'. If the image file already exists, no action is taken.
bliss checks whether artwork is (or isn't, in the case of Remove all embedded art) stored inside each music file.
Cover art
Artwork should be at least 500x500.
bliss makes sure your art is larger than this size. bliss will not download and install any art smaller than this size.
Tags
Check that GENRE, DISC_NUMBER, YEAR, TRACK_NUMBER, and TRACK_NAME exists for each album.
Tags
Check the following information is canonically correct for each album: YEAR, TRACK_NUMBER, TRACK_NAME, ALBUM_ARTIST, ALBUM_NAME, and COMPILATION.
Tags
Pad track numbers so the track number is always 2 digits long.
Ensures track number tags are of a minimum length, e.g. assesses that track number 1 is stored as '01'. If too small, suggests a fix to left-pad the track number (e.g. updates '1' to '01').
Tags
Check genres are one of: Blues, Classical, Dub, Electronic, Hardcore, Hip-Hop, House, International, Jazz, Latin, Metal, Pop, R&B, Rap, Reggae, Rock, or Variété Francaise
Checks that all of your albums are in one of the selected genres. If not, bliss suggests a related alternative that has been allowed.
Tags
Check that DISC_NUMBER,YEAR,GENRE,ALBUM_NAME,ARTIST,ALBUM_ARTIST,TRACK_NAME,TRACK_NUMBER tags are trimmed of whitespace.
Tags
Check the capitalisation of ARTIST, ALBUM_NAME, TRACK_NAME, and ALBUM_ARTIST fields are title case.
Album integrity
Check there are no duplicate tracks within any one album.
File paths
Save music files to <album artist>/<album name>/<discnumber>?|Disc <discnumber>/|<discnumber>?|<discnumber:nn>.|<tracknumber:nn> <track name>.
Warning  Moving and renaming music files can mean your music player loses track of your moved albums and may delete existing metadata held by the player, such as play counts or ratings. Furthermore, existing playlists pointing to old locations of files will be broken and must be changed manually to point to the new locations.

Custom paths help

Enclose variables in < and >.

Separate directories with forward slash / NOT backslash.

File extension is added automatically.

album artist
Album artist with spaces
albumartist
Album artist without spaces
album_artist
Album artist spaces replaced by underscores
album-artist
Album artist spaces replaced by hyphens
album name
Album name with spaces
albumname
Album name without spaces
album_name
Album name spaces replaced by underscores
album-name
Album name spaces replaced by hyphens
discnumber
Disc number, with no leading zeros. Optionally add "n" modifiers to dictate minimum length of disc number, e.g. for 01, 02, 10 etc
genre name
Genre with spaces
genrename
Genre without spaces
genre_name
Genre spaces replaced by underscores
genre-name
Genre spaces replaced by hyphens
fileextension
Music file extension
group:var,size
Groups values by their first character into groups of the specified size. E.g. <group:album_artist,1> will create groups for A, B, C etc., or <group:album_artist,3> will create ABC, DEF etc.
track name
Track name with spaces
trackname
Track name without spaces
track_name
Track name spaces replaced by underscores
track-name
Track name spaces replaced by hyphens
track artist
Track artist with spaces
trackartist
Track artist without spaces
track_artist
Track artist spaces replaced by underscores
track-artist
Track artist spaces replaced by hyphens
tracknumber
Track number, with no leading zeros. Optionally add "n" modifiers to dictate minimum length of tracknumber, e.g. <tracknumber:nn> for 01, 02, 10 etc or <tracknumber:auto> to use the highest track number in album.
year
The year of release
tag field
A raw field to use in the tag. Requires a parameter denoting the name of the field, e.g. <tag_field:record_label> would insert the record label. Fields that require it can be further qualified with an additional colon, e.g. <tag_field:COMMENT:iTunNORM>
?
Uses the subsequent token if the preceeding token evaluates to a string
|
Placed either side of a group of tokens, treats them as if they are one

Examples

<album_artist>/albums/<album_name>/<tracknumber>-<track_name>
Stores all albums for each artist in a folder named albums. Uses underscores between words.
<album_artist>/<album_name>/<discnumber>?|Disk <discnumber>/|<tracknumber>-<track_name>
If the <discnumber> is set, create a folder for it, prefixing "Disk "
<album_artist>_<album name>_<tracknumber>-<track name>
Stores all tracks in the entire music library in the root. Uses spaces between words.
<group:album_artist,3>/<album_artist>/<album name>/<tracknumber>-<track name>
Groups artists by ABC, DEF, then artists, albums and finally tracks.
bobs_music/<album_artist>_<album name>_<tracknumber>-<track name>
Same as before, but expects and stores all music under a bobs_music folder
ooops
Renames all files to "ooops" (not recommended!)
Tag types
ID3v2.3 tags must exist.
Choose the version of ID3v2 to require inside MP3 files.
Update | Ideas | Help
bliss version: 20250121