Skip to content

Achieve 20-50% space savings with zero quality loss. JXL-Pure is an ultra-fast, mathematically lossless JPEG XL batch converter optimized for Linux power users. Handles massive PNG/JPEG archives over 1TB with lightning-fast 'fd' traversal and state-of-the-art 'libjxl' compression. Professional performance meets simplicity.

License

Notifications You must be signed in to change notification settings

void0x14/JXL-Pure

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JXL-Pure Banner

💎 JXL-Pure

The ultimate, ultra-fast, and mathematically lossless JPEG XL batch converter for Linux.

License: MIT Bash Fish VHS


JXL-Pure Demo

Can't see the GIF? It's being generated by GitHub Actions right now!


JXL-Pure is designed for power users who want to reclaim massive amounts of disk space (20-50%) without losing a single bit of image quality. Optimized for modern CPUs (like Ryzen) and large image collections on local or portable HDDs.


⚡ Quick Installation (One-Liner)

Install JXL-Pure to your system with a single command:

curl -sSL https://raw.githubusercontent.com/void0x14/JXL-Pure/main/install.sh | bash

✨ Key Features

  • 🎯 100% Mathematically Lossless: Uses -d 0 and --lossless_jpeg=1 to ensure bit-for-bit accuracy.
  • 🚀 Lightning Fast Discovery: Powered by fd-find for near-instant file scanning even on 1TB+ drives.
  • 💾 Massive Space Savings: Save up to 50% storage space while keeping your memories in state-of-the-art JPEG XL format.
  • 🔄 Resumable Logic: Interrupted? No problem. The script automatically skips already converted files.
  • ⚙️ Flexible Effort Levels: Choose between "I need it now" (Effort 1) and "I want the smallest file" (Effort 9).
  • 🛡️ Safety First: Optional --delete-originals only triggers after a verified successful conversion.
  • 🐧 Universal Linux Support: Native scripts for both Bash and Fish Shell.

🛠️ Installation (Manual)

1. Requirements

Ensure you have the following tools installed (Available on Arch/CachyOS AUR):

sudo pacman -S libjxl fd

2. Clone the Repository

git clone https://github.com/void0x14/JXL-Pure.git
cd JXL-Pure
chmod +x jxl-pure.sh convert.fish

🚀 Usage

Simple Conversion (Keeps Originals)

./jxl-pure.sh /path/to/my/photos

Power User (Convert & Delete Originals)

./jxl-pure.sh /run/media/hdd/photos --delete-originals --effort 3

CLI Arguments

Argument Description Default
[path] Target directory to process . (Current)
--delete-originals Delete JPEGs/PNGs after successful JXL creation false
--effort [1-9] Compression level (1=Fastest, 9=Max Compression) 7
-h, --help Show help information -

📊 Speed vs. Compression (Ryzen 3600 Tested)

Effort Speed Compression Use Case
1 (Lightning) ⚡⚡⚡ High Large archives (1TB+) where time is money.
3-4 (WebP-like) ⚡⚡ Very High Sweet spot. Best balance for most users.
7 (Squirrel) 🐢 Maximum Small collections where every byte counts.

🤝 Contributing

Forks and Pull Requests are welcome! If you find a bug or have a feature request, please open an issue.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Developed with ❤️ for the Linux community.

About

Achieve 20-50% space savings with zero quality loss. JXL-Pure is an ultra-fast, mathematically lossless JPEG XL batch converter optimized for Linux power users. Handles massive PNG/JPEG archives over 1TB with lightning-fast 'fd' traversal and state-of-the-art 'libjxl' compression. Professional performance meets simplicity.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages