compresso

Installation
SKILL.md

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)

claude plugin marketplace add codeforreal1/compressO

Homebrew (macOS)

brew install --cask codeforreal1/tap/compresso

Installer (all platforms)

Download from 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)

npx skills add https://github.com/akillness/oh-my-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

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

# 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 — AGPL-3.0 License

Weekly Installs
12
GitHub Stars
11
First Seen
1 day ago