Karuka Image Editor

Built and open sourced by TempleDiary.

Karuka Image Editor is a small Python desktop app for common image editing tasks:

• open and browse local image folders
• drag and drop image files into the app
• resize images with optional exact-size crop
• batch resize folders into another folder while keeping file names
• crop with a drag selection
• rotate left or right
• convert images to JPEG, JPG, PNG, or HEIC
• remove backgrounds with the optional rembg extra
• save edited output to the user's Downloads folder
• bundled Karuka logo and desktop window icon

Screenshot

Requirements

• Python 3.10 or newer
• Tkinter, usually included with Python. On some Linux distributions it is a separate system package such as python3-tk.
• tkinterdnd2, installed by the project, enables desktop drag-and-drop support.

Install From Source

After the public PyPI release:

python -m pip install karuka

From a local checkout:

python -m pip install .

For AI background removal support:

python -m pip install ".[bgremove]"

For HEIC input/output support:

python -m pip install ".[heic]"

For all optional image features:

python -m pip install ".[all]"

For packaging and publishing checks:

python -m pip install ".[dev]"

Run

After installation:

karuka

On Linux, the first karuka launch also creates a desktop menu launcher and icon when possible. If the desktop entry needs to be recreated manually:

karuka-desktop

From a source checkout:

python -m karuka_image_editor

Batch Resize And Convert

Use Batch Resize / Convert in the editor panel to choose a source folder, output folder, target size, exact-size crop mode, and output format.

The output folder defaults to Downloads/karuka_batch_output. Files are saved with the same base name and the selected output extension, for example photo.png becomes photo.jpeg when JPEG is selected.

HEIC support depends on the optional pillow-heif package.

Package Layout

karuka_image_editor/core/   Image operation helpers
karuka_image_editor/ui/     Tkinter application interface
karuka_image_editor/utils/  Shared utility package
karuka_image_editor/misc/   Experimental command-line scripts

The distribution metadata lives in pyproject.toml. Package discovery includes the karuka_image_editor package, and karuka_image_editor.main provides the karuka console command.

Build

python -m build

The generated dist/ directory is ignored by git.

Project Status

This project is early-stage software. Public APIs and packaging details may change before a 1.0.0 release.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

Contact

Maintainer: TempleDiary

License

Released under the MIT License. See LICENSE.