2.9 KiB
Command line interface (CLI)
LosslessCut has basic support for automation through the CLI. See also HTTP API.
LosslessCut [options] [files]
Note that these examples assume that you have set up the LosslessCut executable to be available in your PATH
(command line environment). Alternatively you can run it like this:
# First navigate to the folder containing the LosslessCut app
cd /path/to/directory/containing/app
# Then run it
# On Linux:
./LosslessCut arguments
# On Windows:
./LosslessCut.exe arguments
# On MacOS:
./LosslessCut.app/Contents/MacOS/LosslessCut arguments
Open one or more files:
LosslessCut file1.mp4 file2.mkv
Override settings (experimental)
See available settings. Note that this is subject to change in newer versions. ⚠️ If you specify incorrect values it could corrupt your configuration file. You may use JSON or JSON5. Example:
LosslessCut --settings-json '{captureFormat:"jpeg", "keyframeCut":true}'
Other options
--locales-path
Customise path to locales (useful for translators).--disable-networking
Turn off all network requests.--http-api
Start the HTTP server with an API to control LosslessCut, optionally specifying a port (default8080
).--keyboard-action
Run a keyboard action (see below.)--config-dir
Path to a directory where theconfig.json
file will be stored and loaded from.
Controlling a running instance (experimental)
If you have the "Allow multiple instances" setting enabled, you can control a running instance of LosslessCut from the outside, using for example a command line. You do this by issuing messages to it through the LosslessCut
command. Currently only keyboard actions are supported, and you can open files. Note that this is considered experimental and the API may change at any time.
Keyboard actions, --keyboard-action
Simulate a keyboard press action in an already running instance of LosslessCut. Note that the command will return immediately, so if you want to run multiple actions in a sequence, you have to sleep
for a few seconds between the commands. Alternatively if you want to wait until an action has finished processing, you can use the HTTP API instead. Note that the HTTP API does not support opening files, and it is currently not possible to wait for a file to have finished opening.
Available keyboard actions
A list of the available action names can be found in the "Keyboard shortcuts" dialog in the app. Note that you don't have to bind them to any key before using them.
Example:
# Open a file in an already running instance
LosslessCut file.mp4
sleep 3 # hopefully the file has loaded by now
# Export the currently opened file
LosslessCut --keyboard-action export
Open files in running instance
LosslessCut file1.mp4 file2.mkv