Files
mfbatch/README.md
2024-06-30 11:54:53 -07:00

59 lines
1.6 KiB
Markdown

# mfbatch
I've been reorganzing my sound effects library recently and have had to edit a
large number of FLAC files, adding and editing descriptions, normalizing
fields etc. and this is one of the tools I've come up with for updating a large
number of FLAC files in an easy way quickly. It works completely in the command
line and is designed to be used with your favorite text editor.
## Workflow
### 1) Create a new `MFBATCH_LIST` file for a directory of FLAC files.
```sh
$ cd path/to/my/flacs
$ mfbatch -c
```
`mfbatch` will scan the current working directory and
all subdirectories recursively. You can use a `-p` option
to switch to another directory before scanning.
### 2) Edit the `MFBATCH_LIST` file in your `$EDITOR`.
```sh
$ mfbatch --edit
```
The `MFBATCH_LIST` file will contain a transcript of all of the flac files
in the selected folder along with their current metadata.
```sh
:set ALBUM 'Test Album 1'
:set ARTIST 'Test Artist'
:set DESCRIPTION 'Tone file #1, test tone 440Hz'
:setp TITLE DESCRIPTION "^Tone file #(\d+).*" 'Tone \1'
./tone1.flac
:set DESCRIPTION 'Tone file #2, also 440Hz'
./tone2.flac
:unset DESCRIPTION
:set DESCRIPTION 'Tone file #3'
./tone3.flac
```
The `MFBATCH_LIST` format allows you to set metadata once and then write values
to a run of files all at once. Several commands are available to manipulate
the metadata written to the files.
### 3) After you've made the changes you want to make, write them to the files.
```sh
$ mfbatch -W
```
Writing metadata is interactive, `mfbatch` will display the
metdata to be written to each file and metadata can be
edited interactively at a prompt before writing.