karuka 0.1.1__tar.gz

karuka-0.1.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,21 @@
+# Code of Conduct
+
+## Our Pledge
+
+We pledge to make participation in this project a harassment-free experience for everyone.
+
+## Expected Behavior
+
+- Be respectful and constructive.
+- Keep discussion focused on improving the project.
+- Accept maintainers' decisions when they are made to protect project quality or community safety.
+
+## Unacceptable Behavior
+
+- Harassment, insults, threats, or personal attacks.
+- Publishing private information without permission.
+- Repeated disruption of project spaces after being asked to stop.
+
+## Enforcement
+
+Maintainers may remove comments, close issues, reject contributions, or block participants when needed to uphold this code of conduct.

karuka-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing
+
+Thanks for helping improve Karuka Image Editor.
+
+## Development Setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install -e ".[dev,bgremove]"
+```
+
+On Windows, activate the virtual environment with:
+
+```powershell
+.venv\Scripts\Activate.ps1
+```
+
+## Local Checks
+
+Run a syntax check before opening a pull request:
+
+```bash
+python -m compileall .
+```
+
+Build the package when changing packaging metadata:
+
+```bash
+python -m build
+```
+
+## Pull Requests
+
+- Keep changes focused on one issue or feature.
+- Include a short description of user-visible behavior changes.
+- Avoid committing generated files such as `__pycache__/`, edited image outputs, build artifacts, or local virtual environments.
+- Update `README.md` when changing install, run, or packaging behavior.

karuka-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TempleDiary
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

karuka-0.1.1/MANIFEST.in

@@ -0,0 +1,9 @@
+include README.md
+include LICENSE
+include CONTRIBUTING.md
+include SECURITY.md
+include CODE_OF_CONDUCT.md
+include pyproject.toml
+include requirements*.txt
+recursive-include karuka_image_editor *.py
+recursive-include karuka_image_editor/assets *.png

karuka-0.1.1/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: karuka
+Version: 0.1.1
+Summary: A small Tkinter desktop image editor for resizing, cropping, rotating, converting, and removing backgrounds.
+Author: TempleDiary
+Maintainer: TempleDiary
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/TempleDiary/karuka-image-editor
+Project-URL: Issues, https://github.com/TempleDiary/karuka-image-editor/issues
+Project-URL: Source, https://github.com/TempleDiary/karuka-image-editor
+Keywords: image-editor,tkinter,pillow,resize,crop,batch-resize,heic,background-removal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: tkinterdnd2>=0.4.3
+Provides-Extra: bgremove
+Requires-Dist: rembg>=2.0.0; extra == "bgremove"
+Provides-Extra: heic
+Requires-Dist: pillow-heif>=0.16.0; extra == "heic"
+Provides-Extra: all
+Requires-Dist: rembg>=2.0.0; extra == "all"
+Requires-Dist: pillow-heif>=0.16.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: build>=1.2.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# 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
+
+![Karuka Image Editor screenshot](karuka_screenshot.png)
+
+## 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:
+
+```bash
+python -m pip install karuka
+```
+
+From a local checkout:
+
+```bash
+python -m pip install .
+```
+
+For AI background removal support:
+
+```bash
+python -m pip install ".[bgremove]"
+```
+
+For HEIC input/output support:
+
+```bash
+python -m pip install ".[heic]"
+```
+
+For all optional image features:
+
+```bash
+python -m pip install ".[all]"
+```
+
+For packaging and publishing checks:
+
+```bash
+python -m pip install ".[dev]"
+```
+
+## Run
+
+After installation:
+
+```bash
+karuka
+```
+
+On Linux, install a desktop menu launcher and icon:
+
+```bash
+karuka-desktop
+```
+
+From a source checkout:
+
+```bash
+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
+
+```text
+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
+
+```bash
+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`.

karuka-0.1.1/README.md

@@ -0,0 +1,127 @@
+# 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
+
+![Karuka Image Editor screenshot](karuka_screenshot.png)
+
+## 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:
+
+```bash
+python -m pip install karuka
+```
+
+From a local checkout:
+
+```bash
+python -m pip install .
+```
+
+For AI background removal support:
+
+```bash
+python -m pip install ".[bgremove]"
+```
+
+For HEIC input/output support:
+
+```bash
+python -m pip install ".[heic]"
+```
+
+For all optional image features:
+
+```bash
+python -m pip install ".[all]"
+```
+
+For packaging and publishing checks:
+
+```bash
+python -m pip install ".[dev]"
+```
+
+## Run
+
+After installation:
+
+```bash
+karuka
+```
+
+On Linux, install a desktop menu launcher and icon:
+
+```bash
+karuka-desktop
+```
+
+From a source checkout:
+
+```bash
+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
+
+```text
+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
+
+```bash
+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`.

karuka-0.1.1/SECURITY.md

@@ -0,0 +1,11 @@
+# Security Policy
+
+## Supported Versions
+
+Security fixes are handled on the latest released version.
+
+## Reporting a Vulnerability
+
+Please report security issues privately by opening a security advisory for the project.
+
+Do not publish exploit details until maintainers have had a reasonable opportunity to investigate and release a fix.

karuka-0.1.1/karuka.egg-info/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: karuka
+Version: 0.1.1
+Summary: A small Tkinter desktop image editor for resizing, cropping, rotating, converting, and removing backgrounds.
+Author: TempleDiary
+Maintainer: TempleDiary
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/TempleDiary/karuka-image-editor
+Project-URL: Issues, https://github.com/TempleDiary/karuka-image-editor/issues
+Project-URL: Source, https://github.com/TempleDiary/karuka-image-editor
+Keywords: image-editor,tkinter,pillow,resize,crop,batch-resize,heic,background-removal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: tkinterdnd2>=0.4.3
+Provides-Extra: bgremove
+Requires-Dist: rembg>=2.0.0; extra == "bgremove"
+Provides-Extra: heic
+Requires-Dist: pillow-heif>=0.16.0; extra == "heic"
+Provides-Extra: all
+Requires-Dist: rembg>=2.0.0; extra == "all"
+Requires-Dist: pillow-heif>=0.16.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: build>=1.2.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# 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
+
+![Karuka Image Editor screenshot](karuka_screenshot.png)
+
+## 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:
+
+```bash
+python -m pip install karuka
+```
+
+From a local checkout:
+
+```bash
+python -m pip install .
+```
+
+For AI background removal support:
+
+```bash
+python -m pip install ".[bgremove]"
+```
+
+For HEIC input/output support:
+
+```bash
+python -m pip install ".[heic]"
+```
+
+For all optional image features:
+
+```bash
+python -m pip install ".[all]"
+```
+
+For packaging and publishing checks:
+
+```bash
+python -m pip install ".[dev]"
+```
+
+## Run
+
+After installation:
+
+```bash
+karuka
+```
+
+On Linux, install a desktop menu launcher and icon:
+
+```bash
+karuka-desktop
+```
+
+From a source checkout:
+
+```bash
+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
+
+```text
+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
+
+```bash
+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`.

karuka-0.1.1/karuka.egg-info/SOURCES.txt

@@ -0,0 +1,34 @@
+CODE_OF_CONDUCT.md
+CONTRIBUTING.md
+LICENSE
+MANIFEST.in
+README.md
+SECURITY.md
+pyproject.toml
+requirements-bgremove.txt
+requirements-heic.txt
+requirements.txt
+karuka.egg-info/PKG-INFO
+karuka.egg-info/SOURCES.txt
+karuka.egg-info/dependency_links.txt
+karuka.egg-info/entry_points.txt
+karuka.egg-info/requires.txt
+karuka.egg-info/top_level.txt
+karuka_image_editor/__init__.py
+karuka_image_editor/__main__.py
+karuka_image_editor/desktop.py
+karuka_image_editor/main.py
+karuka_image_editor/assets/__init__.py
+karuka_image_editor/assets/karuka_logo.png
+karuka_image_editor/core/__init__.py
+karuka_image_editor/core/bgremove.py
+karuka_image_editor/core/convert.py
+karuka_image_editor/core/crop.py
+karuka_image_editor/core/resize.py
+karuka_image_editor/core/rotate.py
+karuka_image_editor/misc/__init__.py
+karuka_image_editor/misc/main.py
+karuka_image_editor/ui/__init__.py
+karuka_image_editor/ui/app.py
+karuka_image_editor/utils/__init__.py
+karuka_image_editor/utils/file_utils.py

karuka-0.1.1/karuka.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

karuka-0.1.1/karuka.egg-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+karuka = karuka_image_editor.main:main
+karuka-desktop = karuka_image_editor.desktop:main
+karuka-editor = karuka_image_editor.main:main
+karuka-editor-install-desktop = karuka_image_editor.desktop:main

karuka-0.1.1/karuka.egg-info/requires.txt

@@ -0,0 +1,16 @@
+Pillow>=10.0.0
+tkinterdnd2>=0.4.3
+
+[all]
+rembg>=2.0.0
+pillow-heif>=0.16.0
+
+[bgremove]
+rembg>=2.0.0
+
+[dev]
+build>=1.2.0
+twine>=5.0.0
+
+[heic]
+pillow-heif>=0.16.0

karuka-0.1.1/karuka.egg-info/top_level.txt

@@ -0,0 +1 @@
+karuka_image_editor

karuka-0.1.1/karuka_image_editor/__init__.py

@@ -0,0 +1,3 @@
+"""Karuka Image Editor package."""
+
+__version__ = "0.1.1"

karuka-0.1.1/karuka_image_editor/__main__.py

@@ -0,0 +1,5 @@
+from .main import main
+
+
+if __name__ == "__main__":
+    main()

karuka-0.1.1/karuka_image_editor/assets/__init__.py

@@ -0,0 +1 @@
+"""Bundled image assets for Karuka Image Editor."""

karuka-0.1.1/karuka_image_editor/core/__init__.py

@@ -0,0 +1 @@
+"""Image operation helpers for Karuka Image Editor."""

karuka-0.1.1/karuka_image_editor/core/bgremove.py

@@ -0,0 +1,34 @@
+from PIL import Image
+
+def remove_bg_ai(input_path, output_path):
+    from rembg import remove
+
+    with open(input_path, 'rb') as i:
+        input_data = i.read()
+
+    output_data = remove(input_data)
+
+    with open(output_path, 'wb') as o:
+        o.write(output_data)
+
+    print("AI background removed!")
+    
+def remove_white_background(input_path, output_path, threshold=240):
+    img = Image.open(input_path).convert("RGBA")
+
+    data = img.getdata()
+    new_data = []
+
+    for pixel in data:
+        r, g, b, a = pixel
+
+        # Detect near-white
+        if r > threshold and g > threshold and b > threshold:
+            new_data.append((255, 255, 255, 0))  # transparent
+        else:
+            new_data.append(pixel)
+
+    img.putdata(new_data)
+    img.save(output_path, "PNG")
+
+    return output_path

karuka-0.1.1/karuka_image_editor/core/convert.py

@@ -0,0 +1,12 @@
+from PIL import Image
+
+def convert_image(input_path, output_path, format):
+    img = Image.open(input_path)
+
+    # Handle JPG (no transparency)
+    if format.lower() in ["jpg", "jpeg"]:
+        img = img.convert("RGB")
+
+    img.save(output_path, format=format.upper())
+
+    return output_path