Michael/MKVAudioSubtitleChanger
1
0
Fork 0
mirror of https://github.com/RatzzFatzz/MKVAudioSubtitleChanger.git synced 2026-02-10 17:55:57 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update instructions in readme

Browse Source
This commit is contained in:
RatzzFatzz
2025-12-22 23:34:06 +01:00
parent c7670e36c1
commit 7620771aed
2 changed files with 28 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

64
README.md
View File

@@ -1,8 +1,7 @@
## Introduction ## Introduction
A streamlined solution for managing MKV files, this program leverages MKVToolNix to modify audio and subtitle track properties without the need for time-consuming file reencoding. Users can easily set their track preferences, and the application intelligently applies the best matching configuration. The tool focuses on metadata modification rather than full file rewriting, ensuring quick operations while maintaining the original file integrity. This makes it an ideal choice for managing multilingual media collections or batch processing multiple MKV files. This CLI tool uses MKVToolNix to quickly modify track properties in MKV files without reencoding. Use profiles to set default audio/subtitle tracks and add commentary, hearing impaired, and forced flags in bulk.
![](example.gif)
![](https://github.com/RatzzFatzz/MKVAudioSubtitleChanger/blob/master/example.gif)
## Requirements ## Requirements
@@ -10,58 +9,49 @@ A streamlined solution for managing MKV files, this program leverages MKVToolNix
- mkvtoolnix installation - mkvtoolnix installation
## Execution ## Execution
Portable: ```shell
``` # Portable
java -jar mkvaudiosubtitlechanger-<version>.jar --library "X:/Files" --attribute-config eng:ger eng:OFF java -jar mkvaudiosubtitlechanger.jar --attribute-config eng:ger -s ./videos
``` # Installed
Windows & Linux (installed): mkvaudiosubtitlechanger.jar --attribute-config eng:ger -s ./videos
```
mkvaudiosubtitlechanger --library "X:/Files" --attribute-config eng:ger eng:OFF
``` ```
Remove `--safemode` or `-s` to actually apply the changes. Using safemode for the first execution is recommended.
Add `--safe-mode` oder `-s` to not change any files. This is recommended for the first executions. ### Update defaults
To update the default flag for tracks use `--attribute-config` or `-a`.
This parameter takes in a list of pairs `audio:subtitle` (E.g. `eng:ger`).
The order of these configs matters, because they are processed in order.
The matching stops when the first match was found or when no match was found.
For example `-a ger:OFF eng:ger` first tries to find a match for german audio, if that is not possible it tries the same for english with german subs.
This can be extended indefinitely.
Attribute-config must be entered in pairs: `audio:subtitle`; Example: `jpn:eng`. More about this topic Using this parameter is not required, but it is the reason I originally started developing this tool.
[here](https://github.com/RatzzFatzz/MKVAudioSubtitleChanger/wiki/Attribute-Config).
### Available parameters ### Available parameters
``` ```
* -a, --attribute-config=<attributeConfig>... -a, --attribute-config=<attributeConfig>...
List of audio:subtitle pairs used to match in order List of audio:subtitle pairs for matching defaults in order (e.g. jpn:eng jpn:ger)
and update files accordingly (e.g. jpn:eng jpn:
ger)
* -l, --library=<libraryPath>
path to library
-m, --mkvtoolnix=<mkvToolNix> -m, --mkvtoolnix=<mkvToolNix>
path to mkvtoolnix installation path to mkvtoolnix installation
-s, --safemode test run (no files will be changes) -s, --safemode test run (no files will be changes)
-t, --threads=<threads> thread count (default: 2) -t, --threads=<threads> thread count (default: 2)
-c, --coherent=<coherent> try to match all files in dir of depth with the -c, --coherent=<coherent> try to match all files in dir of depth with the same attribute config. Attempting increasing deeper levels until match is found (worst case applying config on single file basis)
same attribute config -cf, --force-coherent only applies changes if a coherent match was found for the specifically entered depth
-cf, --force-coherent changes are only applied if it's a coherent match
-n, --only-new-file sets filter-date to last successful execution
(overwrites input of filter-date)
-d, --filter-date=<filterDate> -d, --filter-date=<filterDate>
only consider files created newer than entered date only consider files created newer than entered date (format: "dd.MM.yyyy-HH:mm:ss")
(format: "dd.MM.yyyy-HH:mm:ss")
-i, --include-pattern=<includePattern> -i, --include-pattern=<includePattern>
include files matching pattern (default: ".*") include files matching pattern (default: ".*")
-e, --excluded=<excluded>... -e, --exclude=<excluded>...
Directories and files to be excluded (no wildcard) relative directories and files to be excluded (no wildcard)
-o, -overwrite-forced remove all forced flags -o, -overwrite-forced remove all forced flags
--forced-keywords=<forcedKeywords>[, <forcedKeywords>...]... --forced-keywords=<forcedKeywords>[, <forcedKeywords>...]...
Keywords to identify forced tracks (Defaults will Keywords to identify forced tracks (Defaults will be overwritten; Default: forced, signs, songs)
be overwritten; Default: forced, signs, songs)
--commentary-keywords=<commentaryKeywords>[, <commentaryKeywords>...]... --commentary-keywords=<commentaryKeywords>[, <commentaryKeywords>...]...
Keywords to identify commentary tracks (Defaults Keywords to identify commentary tracks (Defaults will be overwritten; Default: comment, commentary, director)
will be overwritten; Default: comment,
commentary, director)
--hearing-impaired=<hearingImpaired>[, <hearingImpaired>...]... --hearing-impaired=<hearingImpaired>[, <hearingImpaired>...]...
Keywords to identify hearing impaired tracks Keywords to identify hearing impaired tracks (Defaults will be overwritten; Default: SDH, CC
(Defaults will be overwritten; Default: SDH
--preferred-subtitles=<preferredSubtitles>[, <preferredSubtitles>...]... --preferred-subtitles=<preferredSubtitles>[, <preferredSubtitles>...]...
Keywords to prefer specific subtitle tracks Keywords to prefer specific subtitle tracks (Defaults will be overwritten; Default: unstyled)
(Defaults will be overwritten; Default: unstyled)
--debug Enable debug logging --debug Enable debug logging
-h, --help Show this help message and exit. -h, --help Show this help message and exit.
-V, --version Print version information and exit. -V, --version Print version information and exit.

2
src/main/java/at/pcgamingfreaks/mkvaudiosubtitlechanger/model/InputConfig.java
View File

@@ -33,7 +33,7 @@ public class InputConfig implements CommandLine.IVersionProvider {
private File libraryPath; private File libraryPath;
@Option(names = {"-a", "--attribute-config"}, arity = "1..*", converter = AttributeConfigConverter.class, @Option(names = {"-a", "--attribute-config"}, arity = "1..*", converter = AttributeConfigConverter.class,
description = "List of audio:subtitle pairs used to match in order and update files accordingly (e.g. jpn:eng jpn:ger)") description = "List of audio:subtitle pairs for matching defaults in order (e.g. jpn:eng jpn:ger)")
private AttributeConfig[] attributeConfig = new AttributeConfig[0]; private AttributeConfig[] attributeConfig = new AttributeConfig[0];
@ValidMkvToolNix(message = "does not exist") @ValidMkvToolNix(message = "does not exist")
@Option(names = {"-m", "--mkvtoolnix"}, defaultValue = "${DEFAULT_MKV_TOOL_NIX}", description = "path to mkvtoolnix installation") @Option(names = {"-m", "--mkvtoolnix"}, defaultValue = "${DEFAULT_MKV_TOOL_NIX}", description = "path to mkvtoolnix installation")