Initial commit: PixieSwitch - batch image converter

Author: HackingPain

.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+dist/
+build/
+*.spec
+.venv/
+venv/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+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.

README.md

@@ -0,0 +1,68 @@
+# PixieSwitch — Batch Image Converter (GUI)
+
+**PixieSwitch** is a fun, simple GUI to convert images between popular formats. Drop in files, pick an output format, tweak a few options, and go. It handles batch conversion, optional metadata preservation/stripping, basic resizing, and animations (GIF/WebP).
+
+## Features
+
+- Drag & Drop multiple images
+- Output formats: JPG/JPEG, PNG, GIF, WebP, TIFF, BMP, JPEG2000 (JP2/J2K), and optional HEIF/HEIC/AVIF (with pillow-heif)
+- Animation-aware: Keep animation for GIF/WebP (when source is animated)
+- Metadata: preserve EXIF (JPEG) or strip all metadata
+- Resize: constrain longest edge (px)
+- Quality: set lossy compression quality for JPEG/WebP/AVIF/etc.
+- PNG compression level: 0 (fast/big) … 9 (slow/small)
+- Suffix & Output folder controls
+- Multithreaded conversion
+
+## Install
+
+Python 3.9+ recommended (tested on 3.13). Windows, macOS, Linux.
+
+1. Create & activate a virtual env (recommended)
+2. `pip install -r requirements.txt`
+3. `python main.py`
+
+### Optional extras
+
+- HEIF/HEIC/AVIF: install pillow-heif (included in requirements). If your platform lacks libheif, follow the package docs.
+- Animated WebP: we include imageio for better animated WebP handling. If issues arise, Pillow fallback is used.
+
+## Build a standalone app
+
+### Windows (EXE)
+
+```
+pip install pyinstaller
+pyinstaller --noconfirm --windowed --name PixieSwitch --icon NONE main.py
+# Output in dist/PixieSwitch/
+```
+
+### macOS (App bundle/DMG)
+
+```
+pip install pyinstaller
+pyinstaller --noconfirm --windowed --name PixieSwitch --icon NONE main.py
+# Optional: codesign/notarize per Apple docs
+```
+
+### Linux (AppImage)
+
+Use pyinstaller for a folder build, then package with tools like appimagetool if desired.
+
+## Usage tips
+
+- Transparency → JPEG: JPEG has no alpha; we composite on white by default.
+- EXIF vs Strip: "Strip ALL metadata" overrides "Preserve EXIF."
+- Animated output: Only GIF & WebP are guaranteed here. Other targets will use the first frame.
+- JPEG2000: Quality handling varies by Pillow build. If unsupported, you'll see an error per file.
+
+## Roadmap
+
+- APNG output (where Pillow supports it)
+- Color profile controls, ICC copy
+- Presets & CLI runner
+- Bulk folder watch mode
+
+## License
+
+MIT