alto is a program built for audio management. It's purpose is to provide the user the means to write a path construct, or format, to copy/rename audio to a custom path.

For Example:

$ alto -format "{%filename%}" -source path/to/source -destination path/to/destination -operation rename

Would move all files under path/to/source to path/to/destination with their original filename, name collisions are automatically handled, but I intend to make this behavior customizable, as people may have different interpretations of this behavior.

Simply grab a binary from Releases, if it is available. Otherwise go to building to learn how to build alto from source.

You will need Go, Git, and a working internet connection so dependencies in go.mod can be installed.

$ git clone https://github.com/ItsLychee/alto
$ cd alto
$ go build ./cmd/alto
$ ./alto -help
# ...

You may be a bit confused about what the -format argument does, which is understandable. This section is dedicated to teach you on how you can use alto to its fullest to achieve the organization meant for you.

A path construct, as it implies, is a result of alto's processing of the -format string with the current file's metadata being used as reference. So when this manual brings up stuff like "omitting from the path construct" it simply means that X value won't be in the final result.

$ alto -format "{%artist%|unknown artist}/{%album%/}{%title%|%filename%}" -source source -destination destination

# Possible outcomes
Artist/Album/Title.flac # alto automatically appends the file extension if it isn't present in the path construct
Artist/Album/Filename.flac
Artist/Title.flac
Artist/Filename.flac
unknown artist/Album/Title.flac
unknown artist/Album/Filename.flac
unknown artist/Title.flac
unknown artist/Filename.flac

# Alto does the following 

# it checks if %artist% exists, if it doesn't then it'll return unknown artist
# Adds "/" after the first group (which is the contents wrapped with the curly braces)
# Returns %album%/ IF the variable %album% is not empty/nonexistent, otherwise it will return nothing
# Returns %title% IF the variable is not empty/nonexsitent, otherwise it will return %filename%, which will always contains a value

As you may have guessed, %filename% is a variable. Proper variables must have ASCII-only identifiers wrapped around with %, so while %name% is valid, %こんにちは% is not, although this requirement may change in the future.

You are provided with variables representing metadata, metadatic variables are just pipelines to the methods in dhowden's tag metadata interface, and alto will be kept updated to the latest and stable release.

• %title%
• %artist%
• %album%
• %albumartist%
• %genre%
• %composer%
• %year%
• %tracknumber%
• %tracktotal%
• %discnumber%
• %disctotal%
• %comment%
• %format%
• %filetype%
• %filename% this variable is not handled by tag, but it's just a variable of the name of the current file

The variable names should be self-explantory, you can refer the link above to get a grasp of what each variable does based on the name of it.

Groups are a collection of fields which are separated by |, and enwrapped by { and }. A group's job is to start on the first field and see if it has a value, if it does not it will keep iterating over the list of fields until it finds a non-nil field. If it does not find a viable field, it will simply just be omitted from the path construct

A field is a collection of string literals and variables. Unlike the outside of a group where only string literals and groups are parsed, variables are also parsed. So %variable% foobar in a field would be represented Variable StringLiteral in a field, but outside one it would be StringLiteral.

Separators are similar to logical ORs, which if either value is true, then return true, otherwise return false. Instead of returning a boolean, alto returns the evaluated field.