FastResize

• Why Fastest on the Planet?
• Performance Benchmarks
• Key Features
• Installation
• Quick Start
• API Reference
• Documentation
• Architecture
• License
• Contributing
• Contact & Support

FastResize uses 3-4x less RAM than alternatives!

Full Benchmark Details →

gem install fast_resize

brew tap tranhuucanh/fast_resize
brew install fast_resize

# Download latest release
VERSION="1.0.0"
wget https://github.com/tranhuucanh/fast_resize/releases/download/v${VERSION}/fast_resize-${VERSION}-linux-x86_64.tar.gz
tar -xzf fast_resize-${VERSION}-linux-x86_64.tar.gz
sudo cp fast_resize /usr/local/bin/
sudo chmod +x /usr/local/bin/fast_resize

# Verify installation
fast_resize --version

# Resize to width 800 (auto height)
fast_resize input.jpg output.jpg 800

# Resize to exact 800x600
fast_resize input.jpg output.jpg 800 600

# Batch resize all images in directory
fast_resize batch input_dir/ output_dir/ --width 800

# Batch resize specific files (from stdin, NULL-separated)
printf 'photo1.jpg\0photo2.jpg\0photo3.jpg' | fast_resize batch --stdin output_dir/ -w 800

# Convert format (JPG → PNG)
fast_resize input.jpg output.png 800

require 'fast_resize'

# Simple resize (width 800, auto height)
FastResize.resize('input.jpg', 'output.jpg', width: 800)

# Exact dimensions
FastResize.resize('input.jpg', 'output.jpg', width: 800, height: 600)

# With quality and filter options
FastResize.resize('input.jpg', 'output.jpg',
  width: 800,
  quality: 90,
  filter: :catmull_rom
)

# Batch resize - all images in directory
result = FastResize.batch_resize('images/', 'output/', width: 800)
puts "Processed: #{result[:success]}/#{result[:total]}"

# Batch resize - specific files only
files = ['photo1.jpg', 'photo2.jpg', 'photo3.jpg']
result = FastResize.batch_resize(files, 'output/', width: 800)
puts "Processed: #{result[:success]}/#{result[:total]}"

# Maximum speed mode (uses more RAM)
FastResize.batch_resize('images/', 'output/',
  width: 800,
  max_speed: true
)

Full Ruby Guide → • Full CLI Guide →

Complete usage guides:

• CLI Usage Guide - Complete command-line reference
• Ruby Usage Guide - Ruby integration and examples
• Benchmark Details - Full performance analysis
• API Reference - Complete API documentation

FastResize is built on industry-standard, high-performance libraries:

• ⚡ SIMD Optimization - SSE2/AVX (x86) and NEON (ARM) acceleration
• 🚀 Zero-copy Pipeline - Minimal memory allocation
• 💪 Multi-threaded - Parallel batch processing
• 🔥 Memory-mapped I/O - Efficient file reading

FastResize is licensed under the BSD-3-Clause License.

See LICENSE for full details.

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Found a bug? Please open an issue with:

• Your OS and version
• FastResize version
• Steps to reproduce
• Expected vs actual behavior

If FastResize helps you save time and money:

• ⭐ Star this repository
• 🐛 Report bugs and suggest features
• 📖 Improve documentation
• 💬 Share FastResize with others

GitHub: @tranhuucanh • Issues • Discussions

Built with: libjpeg-turbo • libpng • libwebp • stb by Sean Barrett