# mazanoke

**Repository Path**: anydev/mazanoke

## Basic Information

- **Project Name**: mazanoke
- **Description**: 本地优先的图片压缩工具。这是一款注重隐私保护的浏览器端图片优化工具，无需联网可离线使用。它部署简单、功能丰富，提供图片压缩、格式转换和批量上传等功能，兼容 JPG、PNG、WebP、HEIC、AVIF、GIF、SVG 等图片格式。
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: https://mazanoke.com/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-29
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">
  <img src=".github/images/mazanoke-app-icon.png" alt="mazanoke icon" width="120">

MAZANOKE

</h1>

<h2 align="center"> A self-hosted local image optimizer that runs in your browser.</h2>

<center>
   <img src=".github/images/v1.1.5/featured-desktop-solo-dark.jpg" alt="mazanoke desktop screen capture dark mode" width="1200">
</center>

## 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`, `ICO`
  - Convert from `HEIC`, `AVIF`, `TIFF`, `GIF`, `SVG`
- 🔒 **Privacy-Focused**
  - Works offline
  - On-device image processing
  - Removes EXIF data (location, date, etc.)
  - No tracking
  - Installable web app ([learn more](./docs/install-web-app.md))

## Install

### Docker

1. Using [Docker Compose](https://docs.docker.com/compose/):
   ```yaml
   services:
     mazanoke:
       container_name: mazanoke
       image: ghcr.io/civilblur/mazanoke:latest
       ports:
         - "3474:80"
       restart: unless-stopped
   ```
   Available environmental variables: [Configuration](./docs/configuration.md)
1. 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#manual-install))
1. A shortcut to MAZANOKE will be added to your device and can even be used offline.

<img src=".github/images/install-web-app/capture-install-pwa-button.png" alt="Install MAZANOKE progressive web app button" height="100">

## Screenshots

<center>
   <img src=".github/images/v1.1.5/featured-image-mobile-group-dark-light.jpg" alt="mazanoke mobile devices" width="1200">
</center>

<center>
   <img src=".github/images/v1.1.5/featured-desktop-solo-light.jpg" alt="mazanoke desktop screen capture light mode" width="1200">
</center>

|                                                                                                                           |                                                                                                                                |
| :-----------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------: |
|       Dark mode<br><img src=".github/images/v1.1.5/capture-desktop-dark.jpg" alt="mazanoke dark mode" width="90%%">       |        Light mode<br><img src=".github/images/v1.1.5/capture-desktop-light.jpg" alt="mazanoke light mode" width="90%%">        |
| Settings<br><img src=".github/images/v1.1.5/capture-desktop-solo-settings-dark.jpg" alt="mazanoke settings" width="90%%"> | Download images<br><img src=".github/images/v1.1.5/capture-desktop-solo-output-dark.jpg" alt="mazanoke settings" width="90%%"> |

## 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)