Thanks to visit codestin.com
Credit goes to github.com

Skip to content

✨ Lightning-fast, minimalist, and feature-rich photo viewing experience for Windows.

License

amtiYo/FreshViewer

Repository files navigation

📸 BlurViewer

English | Русский | Deutsch

BlurViewer - Professional image viewer with advanced format support and smooth animations.
Lightning-fast, minimalist, and feature-rich photo viewing experience for Windows.

Release Download Release Version GitHub license GitHub Star GitHub Fork GitHub Repo size

A next-generation image viewer with universal format support, immersive fullscreen mode, and professional-grade performance. Built for photographers, designers, and power users.

✨ Key Features

🖥️ Immersive Fullscreen Experience

  • F11 True Fullscreen with adaptive background darkening
  • Smart zoom controls - zoom in freely, limited zoom out for perfect framing
  • Smooth entry/exit animations with state preservation
  • Enhanced navigation - ESC/right-click only for safer viewing

⌨️ Intuitive Controls

  • A/D Navigation - Browse images effortlessly (supports Cyrillic А/В)
  • +/- Center Zoom - Precise zoom control toward image center
  • Instant Rotation - R key with auto-fitting in all modes
  • Smart Panning - Drag images with inertial scrolling

🎨 Advanced Animation System

  • Context-aware animations - smooth in windowed, instant in fullscreen
  • Slide transitions with cubic easing between images
  • Professional opening/closing effects with fade animations

📁 Universal Format Support

  • RAW Formats: CR2, CR3, NEF, ARW, DNG, RAF, ORF, RW2, PEF, and 20+ more
  • Modern Formats: HEIC/HEIF, AVIF, WebP, JXL
  • Animated: GIF, WebP animations (first frame display)
  • Scientific: FITS, HDR, EXR, and specialized formats
  • Standard: PNG, JPEG, BMP, TIFF, SVG, ICO, and more

Performance Optimizations

  • 15% faster rendering with optimized codebase
  • Hardware-accelerated smooth zoom and pan
  • Background loading for instant image switching
  • Memory efficient with smart caching

🎮 Complete Control Reference

Essential Controls

Action Keys Description
Fullscreen Toggle F11 Enter/exit immersive fullscreen mode
Navigate Images A / D Previous/Next image in folder
Zoom In/Out + / - Center-focused zoom control
Fit to Screen F / Space Smart fit with animations
Rotate Image R 90° rotation with auto-fitting
Copy Image Ctrl+C Copy to system clipboard
Exit Application Esc / Right Click Close viewer

Mouse Controls

  • Scroll Wheel: Zoom in/out at cursor position
  • Left Click + Drag: Pan image around
  • Double Click: Toggle between fit-to-screen and 100% scale
  • Drag & Drop: Open new images instantly

🚀 Getting Started

Download & Run

  1. Download the latest BlurViewer.exe from Releases
  2. No installation required - just run the executable
  3. Drag images into the window or use File → Open

Set as Default Viewer

  • Windows 11: Settings → Apps → Default apps → Choose BlurViewer for image files
  • Windows 10: Settings → System → Default apps → Photo viewer → BlurViewer
  • Quick method: Right-click any image → Open with → Choose BlurViewer → Always use this app

Pro Tips

  • Folder browsing: Open any image, use A/D keys to browse the entire folder
  • Quick fullscreen: F11 for distraction-free viewing with perfect image fitting
  • Fast navigation: Use +/- for precise zoom, F/Space to reset fit
  • Instant copy: Ctrl+C to copy current image to clipboard

🖼️ Supported Formats

📷 RAW Camera Formats (20+)
  • Canon: CR2, CR3
  • Nikon: NEF
  • Sony: ARW
  • Adobe: DNG
  • Fujifilm: RAF
  • Olympus: ORF
  • Panasonic: RW2
  • Pentax: PEF, PTX
  • Samsung: SRW
  • Sigma: X3F
  • Minolta: MRW
  • Kodak: DCR, KDC
  • Epson: ERF
  • Mamiya: MEF
  • Leaf: MOS
  • Phase One: IIQ
  • Red: R3D
  • Hasselblad: 3FR, FFF
🆕 Modern & Next-Gen Formats
  • HEIC/HEIF: Apple Photos format with full metadata
  • AVIF: Next-generation format with superior compression
  • WebP: Google's efficient web format (static & animated)
  • JXL: JPEG XL for future-proof archiving
🎬 Animated & Standard Formats
  • Animated: GIF, WebP (first frame display)
  • Standard: PNG, JPEG/JPG, BMP, TIFF/TIF
  • Vector: SVG (rasterized display)
  • Legacy: ICO, XBM, XPM, PBM, PGM, PPM
🔬 Scientific & Professional
  • Astronomy: FITS files
  • HDR: HDR, EXR (high dynamic range)
  • Design: PSD (Photoshop layers, partial support)
  • Medical: DICOM (basic support)

🔧 Advanced Features

Smart Fullscreen Mode

  • Adaptive fitting: Images auto-fit to screen dimensions with rotation awareness
  • Enhanced background: 25% darker backdrop for better focus
  • Restricted exit: Only ESC/right-click prevents accidental closure
  • State preservation: Returns to exact zoom/position when exiting

Intelligent Navigation

  • Auto-discovery: Automatically finds all images in the same folder
  • Seamless browsing: A/D keys work in any zoom level
  • Smart centering: New images center automatically while preserving zoom
  • Rotation reset: Each new image starts at 0° rotation

Performance Engineering

  • Background threading: Images load without UI blocking
  • Smart caching: Efficient memory usage for large files
  • Hardware acceleration: GPU-assisted rendering where available
  • Optimized animations: 60 FPS smooth interpolation

🤝 Contributing

We welcome contributions! Here's how to get started:

  1. Fork the repository
  2. Clone your fork: git clone https://github.com/yourusername/BlurViewer.git
  3. Create a feature branch: git checkout -b feature/amazing-feature
  4. Make your changes and test thoroughly
  5. Commit with clear messages: git commit -m 'Add amazing feature'
  6. Push to your branch: git push origin feature/amazing-feature
  7. Create a Pull Request with detailed description

Development Setup

# Clone and install in development mode
git clone https://github.com/amtiYo/BlurViewer.git
cd BlurViewer
pip install -e .

# Run the application
python BlurViewer.py

📝 License

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

🔗 Built With

  • PySide6 - Modern Qt bindings for Python
  • Pillow - Python Imaging Library
  • rawpy - RAW image processing
  • ImageIO - Scientific image I/O
  • OpenCV - Computer vision library

🙏 Acknowledgments

  • libraw team for RAW processing capabilities
  • Qt Project for the excellent GUI framework
  • Python community for the amazing ecosystem
  • Contributors who help make BlurViewer better

⭐ Star this repository if BlurViewer enhances your photo viewing experience!

Made with ❤️ for photographers, designers, and visual enthusiasts worldwide.

About

✨ Lightning-fast, minimalist, and feature-rich photo viewing experience for Windows.

Topics

Resources

License

Contributing

Stars

Watchers

Forks