Add sort order tags

README.md

@@ -108,9 +108,9 @@ tag.write_with_path("music.m4a", &write_cfg).unwrap();
 
 ## Useful Links
 - QuickTime spec
-    - [Overview of QTFF](https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/QTFFChap1/qtff1.html)
-    - [Movie Atoms](https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/QTFFChap2/qtff2.html)
-    - [Metadata](https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/Metadata/Metadata.html)
+    - [Overview of QTFF](https://developer.apple.com/documentation/quicktime-file-format)
+    - [Movie atoms](https://developer.apple.com/documentation/quicktime-file-format/movie_atoms)
+    - [User data atoms](https://developer.apple.com/documentation/quicktime-file-format/user_data_atoms)
 - [MultimediaWiki QuickTime container](https://wiki.multimedia.cx/index.php/QuickTime_container)
 - [AtomicParsley docs](http://atomicparsley.sourceforge.net/mpeg-4files.html)
 - [Mutagen docs](https://mutagen.readthedocs.io/en/latest/api/mp4.html)

src/atom/ident.rs

@@ -172,6 +172,20 @@ pub const WORK: Fourcc = Fourcc(*b"\xa9wrk");
 /// (`shwm`)
 pub const SHOW_MOVEMENT: Fourcc = Fourcc(*b"shwm");
 
+// Sort order
+/// (`soaa`)
+pub const ALBUM_ARTIST_SORT_ORDER: Fourcc = Fourcc(*b"soaa");
+/// (`soal`)
+pub const ALBUM_SORT_ORDER: Fourcc = Fourcc(*b"soal");
+/// (`soar`)
+pub const ARTIST_SORT_ORDER: Fourcc = Fourcc(*b"soar");
+/// (`soco`)
+pub const COMPOSER_SORT_ORDER: Fourcc = Fourcc(*b"soco");
+/// (`sonm`)
+pub const TITLE_SORT_ORDER: Fourcc = Fourcc(*b"sonm");
+/// (`sosn`)
+pub const TV_SHOW_NAME_SORT_ORDER: Fourcc = Fourcc(*b"sosn");
+
 // Freeform
 /// Mean string of most freeform identifiers (`com.apple.iTunes`)
 pub const APPLE_ITUNES_MEAN: &str = "com.apple.iTunes";

src/tag/mod.rs

@@ -37,11 +37,16 @@ impl DerefMut for Tag {
 impl fmt::Display for Tag {
     fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
         self.format_album_artists(f)?;
+        self.format_album_artist_sort_orders(f)?;
         self.format_artists(f)?;
+        self.format_artist_sort_orders(f)?;
         self.format_composers(f)?;
+        self.format_composer_sort_orders(f)?;
         self.format_lyricists(f)?;
         self.format_album(f)?;
+        self.format_album_sort_order(f)?;
         self.format_title(f)?;
+        self.format_title_sort_order(f)?;
         self.format_genres(f)?;
         self.format_year(f)?;
         self.format_track(f)?;
@@ -57,6 +62,7 @@ impl fmt::Display for Tag {
         self.format_copyright(f)?;
         self.format_encoder(f)?;
         self.format_tv_show_name(f)?;
+        self.format_tv_show_name_sort_order(f)?;
         self.format_tv_network_name(f)?;
         self.format_tv_episode_name(f)?;
         self.format_tv_episode(f)?;

src/tag/userdata/generate.toml

@@ -1,30 +1,37 @@
 # This file is used to generate the `generated.rs` file with userdata accessors.
 
 [accessors.single_strings]
-"album"           = "©alb"
-"copyright"       = "cprt"
-"encoder"         = "©too"
-"lyrics"          = "©lyr"
-"movement"        = "©mvn"
-"title"           = "©nam"
-"tv_episode_name" = "tven"
-"tv_network_name" = "tvnn"
-"tv_show_name"    = "tvsh"
-"work"            = "©wrk"
-"year"            = "©day"
-"isrc"            = "----:com.apple.iTunes:ISRC"
+"album"                   = "©alb"
+"copyright"               = "cprt"
+"encoder"                 = "©too"
+"lyrics"                  = "©lyr"
+"movement"                = "©mvn"
+"title"                   = "©nam"
+"tv_episode_name"         = "tven"
+"tv_network_name"         = "tvnn"
+"tv_show_name"            = "tvsh"
+"work"                    = "©wrk"
+"year"                    = "©day"
+"isrc"                    = "----:com.apple.iTunes:ISRC"
+"album_sort_order"        = "soal"
+"title_sort_order"        = "sonm"
+"tv_show_name_sort_order" = "sosn"
+
 
 [accessors.multiple_strings]
-"album_artist" = "aART"
-"artist"       = "©ART"
-"category"     = "catg"
-"comment"      = "©cmt"
-"composer"     = "©wrt"
-"custom_genre" = "©gen"
-"description"  = "desc"
-"grouping"     = "©grp"
-"keyword"      = "keyw"
-"lyricist"     = "----:com.apple.iTunes:LYRICIST"
+"album_artist"            = "aART"
+"artist"                  = "©ART"
+"category"                = "catg"
+"comment"                 = "©cmt"
+"composer"                = "©wrt"
+"custom_genre"            = "©gen"
+"description"             = "desc"
+"grouping"                = "©grp"
+"keyword"                 = "keyw"
+"lyricist"                = "----:com.apple.iTunes:LYRICIST"
+"album_artist_sort_order" = "soaa"
+"artist_sort_order"       = "soar"
+"composer_sort_order"     = "soco"
 
 [accessors.bool_flags]
 "compilation"      = "cpil"