latest to latest

---

name: compresso

allowed-tools: Read Write Bash Grep Glob WebFetch

metadata:

tags: compresso, compression, video-compression, image-compression, batch-compression, ffmpeg, tauri, offline, cross-platform, pngquant, jpegoptim, gifski

platforms: Claude Code, Codex CLI, Gemini CLI, OpenCode

keyword: compresso

version: latest

source: codeforreal1/compressO

license: AGPL-3.0

---

# compresso — Offline Batch Video & Image Compression

> Free, open-source, fully offline desktop compression powered by FFmpeg, pngquant, jpegoptim, and gifski.

`CompressO` is a cross-platform desktop app (Tauri + React/Vite) for compressing, trimming, converting, and enriching video and image files — entirely on your local machine with no external calls.

## Installation

### Plugin (Claude Code)

```bash

claude plugin marketplace add codeforreal1/compressO

```

### Homebrew (macOS)

```bash

brew install --cask codeforreal1/tap/compresso

```

### Installer (all platforms)

Download from [github.com/codeforreal1/compressO/releases](https://github.com/codeforreal1/compressO/releases):

| Platform | Installer |

|----------|-----------|

| Debian/Ubuntu | `CompressO_amd64.deb` |

| Universal Linux | `CompressO_amd64.AppImage` |

| Apple Silicon | `CompressO_aarch64.dmg` |

| Intel Mac | `CompressO_x64.dmg` |

| Windows 64-bit | `CompressO_x64.msi` |

### Skill (any platform)

```bash

npx skills add https://github.com/akillness/jeo-skills --skill compresso

```

## When to use

- Compress a single video or batch of videos without uploading to a third-party service

- Reduce image file sizes (PNG → pngquant, JPEG → jpegoptim, GIF → gifski)

- Trim or split video content without a full video editor

- Convert between video/image formats via the FFmpeg pipeline

- Embed subtitles into video files locally

- Manage file metadata (title, author, date) during compression

## Do not use when

- You need cloud-based transcoding or CDN delivery → route to a managed video service

- You need programmatic FFmpeg scripting in CI/CD → call `ffmpeg` CLI directly

- You need advanced NLE editing (multi-track, color grading) → route to a full video editor

- You need streaming video packaging (HLS, DASH) → route to a dedicated packaging tool

## Key features

| Feature | Detail |

|---------|--------|

| **Batch compression** | Process multiple video and image files simultaneously |

| **Video trimming** | Trim start/end or split video into segments |

| **Format conversion** | Convert between common video and image formats |

| **Metadata management** | Update title, author, date metadata during compression |

| **Subtitle embedding** | Embed SRT/ASS subtitles into video files |

| **Advanced config** | Fine-grained video codec, bitrate, and audio settings |

| **100% offline** | No network calls; all processing is local |

| **Cross-platform** | Linux, macOS, Windows via Tauri |

## Technology stack

| Layer | Tech |

|-------|------|

| Desktop shell | Tauri (Rust) |

| Frontend | React + Vite |

| Video compression | FFmpeg |

| PNG compression | pngquant |

| JPEG compression | jpegoptim |

| GIF compression | gifski |

## Build from source

**Prerequisites**: Rust toolchain + Node.js + pnpm

```bash

git clone https://github.com/codeforreal1/compressO.git

cd compressO

pnpm install

# Development

pnpm tauri:dev # full Tauri + React dev mode

pnpm vite:dev # frontend only

# Production build

pnpm tauri:build # output: src-tauri/target/release/bundle/

```

## Operating rules

1. Always prefer a pre-built installer for end-user machines; build from source only when the user needs a custom Tauri/Rust configuration

2. Confirm FFmpeg, pngquant, jpegoptim, and gifski are available on the system PATH before CLI-based compression workflows

3. Use batch mode for ≥ 3 files to avoid per-file startup overhead

4. Route subtitle embedding through CompressO's built-in flow rather than raw `ffmpeg -vf subtitles=…` for consistent output naming

5. Check the releases page for the latest DMG/MSI/AppImage before building from source

## Examples

```bash

# macOS install

brew install --cask codeforreal1/tap/compresso

# Linux install (AppImage)

chmod +x CompressO_amd64.AppImage && ./CompressO_amd64.AppImage

# Build from source (all platforms)

git clone https://github.com/codeforreal1/compressO.git

cd compressO && pnpm install && pnpm tauri:build

```

Source: [codeforreal1/compressO](https://github.com/codeforreal1/compressO) — AGPL-3.0 License