huuhuybn/micompress repository overview

⁠MiCompress CLI (Docker)

docker run --rm -v "$PWD":/data huuhuybn/micompress photo.jpg
# → photo-min.jpg in the current directory

⁠Usage

Mount the folder with your files into /data, then pass file names and options:

docker run --rm -v "$PWD":/data huuhuybn/micompress *.png --preset extreme
docker run --rm -v "$PWD":/data huuhuybn/micompress report.pdf -o out/
docker run --rm -v "$PWD":/data huuhuybn/micompress big.jpg --max-width 1920 --json

Options: -o/--output, -p/--preset (lossless|recommended|extreme), --max-width, --api-key, --json, -q/--quiet (--token is the legacy login-token option). Run with --help for the full list.

⁠API key

Anonymous use works within per-type size limits. For bigger files, sign in (free) at https://micompress.com/account⁠, copy your personal key (mc_…) and pass it as an environment variable (or with --api-key):

docker run --rm -e MICOMPRESS_API_KEY=mc_yourkey -v "$PWD":/data huuhuybn/micompress big-video.mp4

With a key, files up to 100 MB are accepted. A free account includes 50 compressions/month through the API; Plus ($9.99/mo) includes 1,000/month and Pro ($19.99/mo) 5,000/month, shared with website usage — see https://micompress.com/plans⁠.

⁠Tags

• latest, 0.1.2 — Alpine + Node 20.

⁠Build locally

Built from the repository's extend/ directory as context:

docker build -f docker/Dockerfile -t huuhuybn/micompress:latest .

⁠Supported formats

Image, PDF, Office documents, video, audio, archives. Full list: https://micompress.com/all-tools⁠

⁠License

MIT © MiCompress⁠. Files are sent over HTTPS to micompress.com for compression; anonymous use is supported within per-type size limits.