https://github.com/civilblur/mazanoke
A self-hosted local image optimizer that runs in your browser.
https://github.com/civilblur/mazanoke
image-compression image-compressor image-converter image-optimization image-optimizer
Last synced: 5 months ago
JSON representation
A self-hosted local image optimizer that runs in your browser.
- Host: GitHub
- URL: https://github.com/civilblur/mazanoke
- Owner: civilblur
- License: gpl-3.0
- Created: 2025-03-21T21:41:46.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-17T21:19:09.000Z (6 months ago)
- Last Synced: 2025-04-18T00:47:12.740Z (6 months ago)
- Topics: image-compression, image-compressor, image-converter, image-optimization, image-optimizer
- Language: CSS
- Homepage: https://MAZANOKE.com
- Size: 4 MB
- Stars: 529
- Watchers: 2
- Forks: 14
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-repositories - civilblur/mazanoke - A self-hosted local image optimizer that runs in your browser. (CSS)
README
MAZANOKE
A self-hosted local image optimizer that runs in your browser.
## About
MAZANOKE is a simple image optimizer that runs in your browser, works offline, and keeps your images private without ever leaving your device.
Created for everyday people and designed to be shared with family and friends, it serves as an alternative to questionable "free" online tools.
## Table of Content
- [Features](#features)
- [Install](#install)
- [Screenshots](#screenshots)
- [Attributions](#attributions)
## Features
- 🖼️ **Optimize Images in Your Browser**
- Adjust image quality
- Set target file size
- Set max width/height
- Paste images from clipboard
- Convert between and to `JPG`, `PNG`, `WebP`
- Convert from `HEIC`, `AVIF`, `GIF`, `SVG`
- 🔒 **Privacy-Focused**
- Works offline
- On-device image processing
- Removes EXIF data (location, date, etc.)
- No tracking
- Installable web app ([learn more](#web-app))
**Planned**
- [X] Upload multiple files at once
- [X] Support for more image file types
- Recently added conversion from: `HEIC`, `AVIF`, `GIF`, `SVG` → `JPG/PNG/WebP`
- [X] Remember last-used settings
- [ ] Image cropping
## Install
### Docker
1. Using [Docker Compose](https://docs.docker.com/compose/):
```
services:
mazanoke:
container_name: mazanoke
image: ghcr.io/civilblur/mazanoke:latest
ports:
- "3474:80"
```
2. Access the app at `http://localhost:3474`
### Local
1. Download the [latest source code release](https://github.com/civilblur/mazanoke/releases).
1. Open the `index.html` file to launch the app in your browser.
### Web App
1. Visit [MAZANOKE.com](https://mazanoke.com/), or self-host for even stronger privacy.
1. Click the "Install" button in the top-right.
- If the button isn’t available, you can still install it manually in a few simple clicks. ([See how](./docs/install-web-app.md))
1. A shortcut to MAZANOKE will be added to your device and can even be used offline.
## Screenshots
| | |
| :---: | :---: |
| Dark mode
| Light mode
|
| Settings
| Download images
|
## Attributions
- [Browser Image Compression](https://github.com/Donaldcwl/browser-image-compression)
- [heic-to](https://github.com/hoppergee/heic-to), [libheif](https://github.com/strukturag/libheif), [libde265](https://github.com/strukturag/libde265)
- [JSZip](https://github.com/Stuk/jszip)
[View full list and details](./docs/ATTRIBUTIONS.md)
## License
[GNU General Public License v3.0](https://github.com/civilblur/mazanoke/blob/main/README.md)