ffmusicsync

A simple utility which creates an encoded music folder out of your library and keeps it updated using as least ffmpeg runs as possible.

Requirements

• ffmpeg installed and added to PATH
• rclone installed and added to PATH (Optional, only when using remotes)

Features

• Encode an entire folder, copying already encoded songs
• Keep the folder updated with subsequent runs - you can remove and add songs to the original one
• Remove brackets from the filenames - no more (Original Mix) in every single name, customizable
• Lots of file formats supported - acts as a ffmpeg wrapper, supports everything ffmpeg does
• Keep a list of the encoded files so even if you change the renaming settings it won't need to re-encode them
• Copy covers to files post-encode*
• Support files being on rclone remotes - automatically downloads them, encodes locally and uploads

*See the lofty crate for a list of supported formats to copy from/to

Configuration examples

config.json can contain comments, so you can just copy-paste the example. jsonc { // Input and output directory // Can be either a string or an object: // If it's a string and contains a ':', it will be treated as an rclone remote "inputDirectory": "MyStorage:FLAC", "outputDirectory": { // Both fields are optional // If remote is not present or blank it will be treated as a local location "remote": "MyStorage", "path": "Encoded" }, // Optional, used only when either the input or output directory is remote "tempDirectory": "temp", // An array of all extensions that will be encoded // All that are not present here (such as mp3 in this case) will be just copied to the output directory "extensionsToEncode": [ "flac" ], // A string containing the extension for encoded files "encodedExtension": "ogg", // Add covers to files after encoding them // ffmpeg can't do that by itself for OGG files // The option doesn't need to be present, defaults to false "copyCovers": true, // A string containing the ffmpeg params // ffmpeg command looks like: // ffmpeg -i <INPUT> <PARAMS> <OUTPUT> "ffmpegParams": "-c:a libopus -b:a 128K -vn", // Whether to remove brackets, the options don't need to be present, // in which case it will behave the same way as if they were set to false // When set to true it will remove everything in between the brackets as well as one leading/trailing space // Example with the below config: // [LABEL] Author - Title (Original Mix) [YEAR].mp3 // Would be renamed to: // Author - Title (Original Mix).mp3 "removeRoundBrackets": false, // () "removeSquareBrackets": true, // [] "removeCurlyBrackets": false, // {} "removeAngleBrackets": false, // <> }

Command-line arguments

• -c, --config - Specify the config file (default: config.json)
• --color - Force colors to be enabled
• --dry-run - Do a trial run with no actual changes
• -e, --encoded - Specify the file storing info which songs are already encoded (default: encoded.json)
• -h, --help - Print help information
• -q, --quiet - Suppress ffmpeg output
• -V, --version - Print version information
• -y, --yes - Always assume "yes" as the answer to all prompts and run non-interactively

Planned features

• ViSQOL support for automatic bitrate mode

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.