![Logo](https://raw.githubusercontent.com/Ktt-Development/rexedia/main/icon.png)
Metadata editing (including cover art) for bulk files using regular expressions (regex) and back references.
Documentation
•
Issues
Contents:
Compiled binaries can be found in releases.
Rexedia supports all file extensions supported by FFMPEG.
rexedia -i "file.mp4" -c "(.+)" "$1.png" -o "(.+)" "$1.avi"
Complicated tasks simplified:
- Apply cover art and metadata.
- Customize output with regular expressions and back references.
- Support for preset files instead of command-line flags.
- Logging to track changes.
rexedia -i video.mp4 -p preset.yml
# preset.yml
metadata:
- meta: 'title'
regex: '(.+)'
format: '$1'
Rexedia preserves the integrity of the video file.
- Verify file integrity using the
-v
flag. - Backup files will always be saved on format failure.
- Use the
-b
flag to keep backup files even on successful formats.
rexedia -i "file.mp4" -c "(.+)" "$1.png" -b -v 3
Regular expression will test against the file name without the extension.
At least one input required.
A cover, metadata, or output; or preset must be specified. If a preset is specified then the cover, metadata, and output flags will be ignored.
Flag | Type | Description |
---|---|---|
-i -input | [file] |
The file or directory path to format. Can be used multiple times. |
-w -walk | [boolean] |
If true, subdirectories will also be formatted (only for directory input). |
-b -backup | [boolean] |
If true, input files will be backed up. |
-l -logging | [boolean] |
If true, log files will be generated. |
-d -debug | [boolean] |
If true, debug logs will be generated. |
-v -verify | [int] |
File validation level. 0 = off, 1 = frames within range (default), 2 = frames equal to or exceeding within range, 3 = exact frame count. |
-vd -verifyDiscrepancy | [int] |
Frame difference range (only for verify 1 or 2). |
-pc -preserveCover | [boolean] |
If true, files with existing cover art will not get erased unless a new one is specified. |
-pm -preserveMeta | [boolean] |
If true, files will preserve any existing metadata in the final output. |
-p -preset | [file] |
The presets file path. Overrides cover, metadata, and output flags. Can only be used once. |
-c -cover | [regex] [string] |
The regular expression and back reference to use for the cover art. Can only be used once. |
-m -metadata | [string] [regex] [string] |
The metadata tag name, regular expression, and back reference string to use for metadata. Can be used multiple times. |
-o -output | [regex] [string] |
The regular expression and back reference string to use for output file. Uses the extension from the final string or the extension of the input file if none is specified. Can only be used once. |
Assign video a cover art image with the same name
┬ video.mp4
└ video.png
rexedia -i video.mp4 -c "(.+)" "$1.png"
Assign video a cover art image with the same name and save to new file
┬ video.mp4 → video.avi
└ video.png
rexedia -i video.mp4 -c "(.+)" "$1.png" -o "(.+)" "$1.avi"
Assign video metadata based on the name
─ [S01 E02] video.mp4 → ┌ season_number = 1
├ episode_sort = 2
└ show = video
rexedia -i video.mp4 -m "season_number" "\[S0*(\d*) E0*\d*\]" "$1" -m "episode_sort" "\[S0*\d* E0*(\d*)\]" "$1" -m "show" "\[S0*\d* E0*\d*\] (.+)" "$1"
cover: # cover art
regex: '(.+)' # the regex capture string
format: '$1' # the final cover art name (regex backreferences supported)
metadata: # list of metadata tags
- meta: 'name' # the metadata tag name
regex: '(.+)' # the regex capture string
format: '$1' # the final metadata value (regex backreferences supported)
output: # output file
regex: '(.+)' # the regex capture string
format: '$1' # the final output name (regex backreferences supported)
Assign video metadata based on the name from preset
┬ [S01 E02] video.mp4 → ┌ season_number = 1
└ preset.yml ├ episode_sort = 2
└ show = video
# preset.yml
metadata:
- meta: 'season_number'
regex: '\[S0*(\d*) E0*\d*\\]'
format: '$1'
- meta: 'episode_sort'
regex: '\[S0*\d* E0*(\d*)\]'
format: '$1'
- meta: 'show'
regex: '\[S0*\d* E0*\d*\] (.+)'
format: '$1'
rexedia -i video.mp4 -p preset.yml
- Found a bug? Open a new issue.
- Want to contribute? Create a fork and open a pull request.