Media
Audio
A collection of audio tracks.
Formats
| format | extension | description |
|---|---|---|
| FLAC | flac | Free Lossless Audio Codec. |
| MP3 | mp3 | MPEG-1 Audio Layer III. |
| MP4 | m4a | MPEG-4 Part 14. |
Tags
| field | FLAC | MP3 | MP4 |
|---|---|---|---|
| album | ALBUM | TALB | ©alb |
| artist | ARTIST | TPE1 | ©ART |
| disc | DISCNUMBER | TPOS | disk |
| disc total | DISCTOTAL | TPOS | disk |
| title | TITLE | TIT2 | ©nam |
| track | TRACKNUMBER | TRCK | trkn |
| track total | TRACKTOTAL | TRCK | trkn |
A number and total with the same tag name means the tag contains both values.
ID3 frames contain the number and total separated by a slash, for example
5/14, and MP4 atoms contain a pair of integers.
Tagging
FLAC files can be tagged with metaflac. If necessary, first remove old artwork:
metaflac --remove --block-type=PICTURE foo.flac
Then tag and add new artwork:
metaflac \
--remove-tag=ALBUM --set-tag=ALBUM=foo \
--remove-tag=ARTIST --set-tag=ARTIST=bar \
--remove-tag=DISCNUMBER --set-tag=DISCNUMBER=1 \
--remove-tag=DISCTOTAL --set-tag=DISCTOTAL=2 \
--remove-tag=TITLE --set-tag=TITLE=baz \
--remove-tag=TRACKNUMBER --set-tag=TRACKNUMBER=3 \
--remove-tag=TRACKTOTAL --set-tag=TRACKTOTAL=4 \
--import-picture-from=cover.jpg \
foo.flac
MP3s can be tagged with eyeD3:
eyeD3 \
--album foo \
--artist bar \
--disc-num 1 \
--disc-total 2 \
--title baz \
--track 3 \
--track-total 4 \
--remove-all-images \
--add-image cover.jpg:FRONT_COVER \
foo.mp3
MP4s can be tagged with ExifTool:
exiftool \
-overwrite_original \
-ItemList:Album=foo \
-ItemList:Artist=bar \
-ItemList:DiskNumber='1 of 2' \
-ItemList:Title=baz \
-ItemList:TrackNumber='3 of 4' \
'-ItemList:CoverArt<=cover.jpg' \
foo.m4a
Image
A collection of images.
Formats
| format | extension | description |
|---|---|---|
| JPEG | jpg | Joint Photographic Experts Group. |
| PNG | png | Portable Network Graphics. |
Tags
| field | JPEG | PNG |
|---|---|---|
| orientation | EXIF Orientation | EXIF Orientation |
| title | XMP dc:title | Title text chunk |
Tagging
Images may be tagged with ExifTool.
For JPEGs:
exiftool -overwrite_original -XMP-dc:Title=foo foo.jpg
For PNGs:
exiftool -overwrite_original -PNG:Title=foo foo.png
If necessary, orientation may be corrected:
exiftool -overwrite_original -Orientation='Rotate 90 CW' foo.jpg
Video
A collection of videos.
Formats
| format | extension | description |
|---|---|---|
| MP4 | mp4 | MPEG-4 Part 14. |
| WebM | webm | WebM. |
Tags
| field | MP4 | WebM |
|---|---|---|
| title | ©nam | segment info Title |
Tagging
MP4s may be tagged with ExifTool:
exiftool -overwrite_original -ItemList:Title=foo foo.mp4
WebM videos may be tagged with mkvpropedit:
mkvpropedit foo.webm --edit info --set title=foo
Web
Arbitrary web content. Currently unstable. Content is served out of the static
directory under the package root with static/index.html as the entry point.