Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Myaamori/aegisub-cli
Standalone binary for running Aegisub automations from the command line.
https://github.com/Myaamori/aegisub-cli
Last synced: 3 months ago
JSON representation
Standalone binary for running Aegisub automations from the command line.
- Host: GitHub
- URL: https://github.com/Myaamori/aegisub-cli
- Owner: Myaamori
- License: other
- Created: 2020-10-19T15:51:26.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2020-11-14T03:29:48.000Z (almost 4 years ago)
- Last Synced: 2024-04-22T02:58:34.131Z (7 months ago)
- Language: C
- Homepage:
- Size: 35.1 MB
- Stars: 16
- Watchers: 3
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Aegisub CLI
Standalone binary for running Aegisub automations from the command line.
## Usage
```
aegisub-cli [options]
Options:
--help produce help message
--video arg video to load
--timecodes arg timecodes to load
--keyframes arg keyframes to load
--automation arg an automation script to run
--active-line arg (=-1) the active line
--selected-lines arg the selected lines
--dialog arg response to a dialog, in JSON
--file arg filename to supply to an open/save call
--loglevel arg (=3) 0 = exception; 1 = assert; 2 = warning; 3 = info; 4 =
debug
```
Examples:
```
aegisub-cli --dialog '{"button": 0, "values": {"stripComments": true}}' --video premux.mkv --automation l0.ASSWipe.moon script_in.ass script_out.ass ASSWipe
aegisub-cli --selected-lines 0-5,10,15-20 --automation lyger.GradientByChar.lua script_in.ass script_out.ass "Gradient by characte/Apply Gradient"
```
### Dialogs
You can navigate automations that show dialogs using the `--dialog` option.
`--dialog` takes a JSON object with two keys: `button` and `values`.
`button` is an integer specifying which button in the dialog to push, starting at 0.
`values` is a JSON object consisting of control name/value pairs, for specifying values of text fields, checkboxes, and so on.
Valid values include:
* Float controls: A float such as `0.1`
* Integer controls: An integer such as `42`
* Color controls: An integer array of length 3 or 4, such as `[50, 100, 250, 20]`, in the order R, G, B, A
* Checkbox controls: A boolean value, either `true` or `false`
* Others: A string such as `"hello"`
The control names are the names supplied to `aegisub.dialog`.
Refer to the source code of the automation or the debug output printed by `aegisub-cli` when run with `--loglevel 4` to find the correct names.
## Compiling
### Linux
Install Meson and Ninja (e.g. using pip for Python 3), as well as development libraries for ICU, Boost and FFMS2, and run
```
$ meson --prefix=/usr --buildtype=release builddir
$ ninja -C builddir src/aegisub-cli
```
The prefix should be set to the same prefix as your main Aegisub installation, as this is where Aegisub CLI will search for automation modules.
Note however that you do not need to install the actual binary itself to the same directory.
### Windows
Install Visual Studio 2019, Python 3, Meson and Ninja, open the `x64 Native Tools Command Prompt for VS 2019`, run
```
$ meson -Ddefault_library=static -Dlocal_boost=true --buildtype=release builddir
$ ninja -C builddir src/aegisub-cli.exe
```
and sit tight.
Meson will download and build the required dependencies, including ICU, Boost and FFmpeg, so compilation will take a while.
### Development on Windows
You can generate a Visual Studio 2019 project using
```
$ meson -Ddefault_library=static -Dlocal_boost=true --buildtype=debugoptimized --backend vs2019 builddir
```
You can then import the solution generated in `builddir`.
Note that you cannot use `--buildtype=debug` as FFmpeg will fail to compile without optimizations.
## Windows binaries
There are pre-built binaries for Windows available from the releases section.
Simply place aegisub-cli.exe in the same directory as your main Aegisub executable and add the directory to your PATH.