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
Enforce singular embedded art.
Cover art
Artwork should be at least 300x300.
bliss makes sure your art is larger than this size. bliss will not download and install any art smaller than this size.
Cover art
Artwork should be smaller than 1 MB.
Assesses that art consumes less than this amount on disk. bliss will also not download nor install any art larger than this size.
Cover art
Save backups whenever a piece of artwork is changed.
Tags
Check that DISC_NUMBER, GENRE, YEAR, TRACK_NUMBER, TRACK_NAME, and ALBUM_ARTIST exists for each album.
Tags
Check the following information is canonically correct for each album: GENRE, YEAR, TRACK_NUMBER, TRACK_NAME, ALBUM_ARTIST, ALBUM_NAME, and COMPILATION. Check capitalisation matches exactly . Strictly check punctuation is correct
Tags
Pad track numbers with zeros according to the highest track number in the album.
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
Enforce the same track artist throughout an album. Move 'featuring' text from track artist to end of track title.
Check the 'Move featuring artists' option to move featuring artist text from the track artist tag to the track title.
Tags
Assess whether each artist name is a known alias, including common misspellings and acronyms.
Tags
Check that DISC_NUMBER,YEAR,RECORD_LABEL,GENRE,ALBUM_NAME,ARTIST,ALBUM_ARTIST,TRACK_NAME,COMPOSER,TRACK_NUMBER tags are trimmed of whitespace.
Tags
Check the capitalisation of ARTIST, ALBUM_NAME, GENRE, TRACK_NAME, ALBUM_ARTIST, COMPOSER, and RECORD_LABEL fields are title except closed class case.
File paths
Save music files to <album_artist>/<album_name>/<tracknumber>?|<tracknumber:auto> - |<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
ID3v1 tags must exist.
Tag types
ID3v2.4 tags must exist.
Choose the version of ID3v2 to require inside MP3 files.
Update | Ideas | Help
bliss version: 20250121