Important
atlas.convert is part of the Atlas Suite—a collection of high-visibility, local-first terminal utilities designed for power users who demand precision and aesthetic clarity.
atlas.convert is a high-performance image conversion tool that simplifies media workflows directly from your terminal. Whether you're batch-processing assets for a project or quickly converting a single HEIC photo from your phone, Atlas Convert provides a seamless, dependency-free experience with the signature Atlas aesthetic.
- 🖼️ Format Support: Seamlessly convert between JPEG, PNG, and HEIC (Decoding).
- 🔄 Batch Processing: Convert entire directories or sets of files using glob patterns.
- 🏷️ Smart Placeholders: Customize output filenames with
{name},{idx}, and{date}tokens. - 🕹️ Interactive Mode: A guided, step-by-step TUI prompt for users who prefer not to memorize flags.
- ⚡ Blazing Fast: Written in Go with native imaging libraries for near-instantaneous conversion.
- 🍎 HEIC Support: Includes built-in decoding for modern iPhone/macOS image formats without needing external system libraries.
- 🎨 Aesthetic CLI: Clean, high-contrast output consistent with the Atlas Suite design language.
- 📦 Zero Dependencies: Compiles to a single, static binary—no
imagemagickorffmpegrequired.
This project uses the Atlas gobake orchestration tool for cross-platform builds.
git clone https://github.com/fezcode/atlas.convert
cd atlas.convert
gobake buildThe compiled binary will be located in the build/ directory.
Convert all HEIC images in a folder to PNG:
atlas.convert -s "*.heic" -d "converted/" -t pngConvert PNGs to JPEGs with a specific naming convention:
atlas.convert -s "raw/*.png" -d "web/{name}_optimized.jpg" -t jpegConvert images and number them sequentially:
atlas.convert -s "snapshots/" -d "archived/IMG_{idx}.png" -f jpg -t png| Flag | Shorthand | Description |
|---|---|---|
--source |
-s |
Source path (file, directory, or glob pattern) |
--destination |
-d |
Destination path (directory or pattern with placeholders) |
--from |
-f |
Source codec/format (jpeg, png, heic) |
--to |
-t |
Destination codec/format (jpeg, png) |
--interactive |
-i |
Launch the interactive guided mode |
--help |
-h |
Print help text and usage examples |
--version |
-v |
Print current version |
When using -d, you can use these tokens to dynamically generate filenames:
{name}: The original filename without its extension.{idx}: The sequence index (0, 1, 2...) during batch processing.{date}: The current date inYYYY-MM-DDformat.
| Format | Read (Decode) | Write (Encode) |
|---|---|---|
| JPEG | ✅ | ✅ |
| PNG | ✅ | ✅ |
| HEIC | ✅ | ❌ (Coming soon) |
- Local-First: All processing happens on your machine. Your photos never touch the cloud.
- Precision: Uses high-quality resampling and encoding parameters to ensure no loss in visual fidelity during conversion.
- Portability: Built with pure Go (WASM-based decoder) to ensure the tool works across all major operating systems with zero setup and no CGO requirements.
MIT License - Copyright (c) 2026 FezCode.