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

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 rename settings it won't need to re-encode them

Limitations

• Recursive directories currently not supported - the input directory can contain only files
• OGG covers not supported - ffmpeg limitation. Use -vn when encoding to OGG otherwise the files will be unplayable

Configuration examples

config.json can contain comments, so you can just copy-paste the example. jsonc { // Input and output directory // The output directory needs to exist "inputDirectory": "FLAC", "outputDirectory": "Encoded", // 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", // 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 featuresS

• Recursive directory support
• OGG cover support
• Support of files on an rclone remote instead of the local filesystem
• 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.