A unified CLI for running batch operations over files in a folder on Linux — wraps external tools behind a single, consistent interface.
"Molim" means "please" in Croatian, Serbian, Bosnian, and Montenegrin — a polite way to ask for something useful to be done.
Many useful command-line tools have their own interfaces, flags, and conventions. molim provides a single, consistent entry point for running batch operations over files in a folder — regardless of the underlying tool doing the work.
The current command set focuses on image and video processing, wrapping RawTherapee, ImageMagick, and FFmpeg, but the design is not limited to these use cases.
Point it at a folder, pick a command, and it handles the rest.
- Linux (no other platforms are tested or planned for support)
- Python 3.12+
- The following tools installed and available on
PATH:
| Tool | Used for | Install (Debian / Ubuntu) |
|---|---|---|
| RawTherapee | RAW file processing | sudo apt install rawtherapee |
| ImageMagick | Format conversion, resizing | sudo apt install imagemagick |
| FFmpeg | Video processing | sudo apt install ffmpeg |
Requires jq for parsing the GitHub API response:
sudo apt install jqInstall or update to the latest release:
uv tool install --reinstall \
$(curl -s https://api.github.com/repos/nightjarrr/molim/releases/latest \
| jq -r '.assets[] | select(.name | endswith(".whl")) | .browser_download_url')Requires uv only. Replace <VERSION> with the desired version number
(e.g. 0.3.6):
uv tool install --reinstall \
https://github.com/nightjarrr/molim/releases/download/v<VERSION>/molim-<VERSION>-py3-none-any.whlAll available releases are listed on the Releases page.
usage: molim [-h] [--version]
[jpegify | rawtherapee | rawtherapee-hq | resize | suffix | video]
...
| Command | Description |
|---|---|
jpegify |
Convert images of other formats into JPEG using ImageMagick |
rawtherapee |
Process image files with RawTherapee profiles |
rawtherapee-hq |
Process image files with RawTherapee profiles (high-quality JPEG variant) |
resize |
Resize images using ImageMagick |
suffix |
Add a suffix to file names |
video |
Process and optimise video files using FFmpeg |
Run molim --help for general help, or molim <command> --help for
per-command options.
- Linux only. There are no plans to support Windows or macOS.
- Use at your own risk. Always back up your files before processing — batch operations on large folders can be destructive if misconfigured.
- Personal project. The primary goal is to be useful to the author. Features and design decisions reflect personal workflows and preferences. PRs from external contributors are not being accepted.
- Feel free to fork and adapt to your liking if you find it useful but not exactly fitting your needs.
MIT — see LICENSE for details.