titlefmt

titlefmt is a title formatting library for media files written in Rust. The aim of the project is to be conformant to the foobar2000 formatting syntax.

For more reference about the Foobar syntax, please refer to http://wiki.hydrogenaud.io/index.php?title=Foobar2000:TitleFormattingReference

To try out the formatting features, an example is included with the titlefmtr executable binary. Use a formatting expression as first argument, such as "%track%. %title%", and the audio files you want to apply the title formatting to as subsequent arguments.

Example: $ cargo run --release --bin titlefmtr "%track%. [%artist% - ] %title%" test01.flac test02.mp3 music/**/*.flac

Currently implemented functionalities

• Field references, such as %artist% or %title%
• Conditional selection with square brackets [ ] for optional sub-expressions
• Advanced tag handling (expanding %tracknumber% with a leading zero if it's only one digit, aliasing %album artist% and %artist%, etc.)
• Functions available
  • add
  • div
  • greater
  • max
  • min
  • mod
  • mul
  • muldiv
  • sub
  • and
  • or
  • not
  • xor
  • if
  • if2
  • if3
  • ifequal
  • ifgreater
  • iflonger
  • select
  • abbr
  • caps
  • caps2
  • crlf
  • cut
  • directory
  • directory_path
  • ext
  • filename

Currently unimplemented functionalities

• Variables