mcpField
C
compresso

compresso

github.com/akillnessCreative & media53273 installsUpdated 4d ago
Repository

About compresso

CompressO is an offline desktop app for batch-compressing, trimming, and converting video and image files. It is for people who want local file processing, with metadata editing and subtitle embedding also included.

Key features

  1. 01Batch video and image compression
  2. 02Trim or split video
  3. 03Convert common media formats
  4. 04Edit file metadata
  5. 05Embed SRT/ASS subtitles
  6. 06Configure codecs and bitrate

Use cases

  1. 01Compressing multiple local videos or images
  2. 02Trimming clips without a full video editor
  3. 03Converting media formats on a desktop
  4. 04Embedding subtitles before sharing a video

Install

Copy the command and run it in a terminal.

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

After installing, type/compressoin Claude Code to confirm it loaded.

Bundled filesSKILL.toon

Details

From the project README

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:

PlatformInstaller
Debian/UbuntuCompressO_amd64.deb
Universal LinuxCompressO_amd64.AppImage
Apple SiliconCompressO_aarch64.dmg
Intel MacCompressO_x64.dmg
Windows 64-bitCompressO_x64.msi
Skill (any platform)
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

FeatureDetail
Batch compressionProcess multiple video and image files simultaneously
Video trimmingTrim start/end or split video into segments
Format conversionConvert between common video and image formats
Metadata managementUpdate title, author, date metadata during compression
Subtitle embeddingEmbed SRT/ASS subtitles into video files
Advanced configFine-grained video codec, bitrate, and audio settings
100% offlineNo network calls; all processing is local
Cross-platformLinux, macOS, Windows via Tauri

Technology stack

LayerTech
Desktop shellTauri (Rust)
FrontendReact + Vite
Video compressionFFmpeg
PNG compressionpngquant
JPEG compressionjpegoptim
GIF compressiongifski

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

Comments

Markdown supported