Skip to content

TearTyr/Ultra-Galleries

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

Ultra Galleries

Ultra Galleries is a powerful userscript that enhances the browsing and downloading experience on kemono.su, coomer.su, and nekohouse.su by adding features for image manipulation, viewing, and batch downloading. It was originally based on Better Kemono Galleries but has been significantly expanded and improved.

Overview

This userscript provides a seamless and efficient way to interact with image and video content on supported websites, making it easier to view, resize, download, and manage your favorite media.

Features

Image Viewing and Manipulation

  • Original Resolution Loading: Directly loads images in their original resolution.
  • Resize Options:
    • Toggle to resize individual or all images in a gallery to fit:
      • Vertical height (FILL HEIGHT)
      • Horizontal width (FILL WIDTH)
      • Full resolution (FULL)
  • Image Removal: Option to remove individual images from the gallery view.
  • Gallery View: New gallery view for easier browsing of images within a post.
  • Zoom & Pan: Advanced zooming with mouse wheel, buttons, and double-click support, plus smooth panning capabilities.

Downloading

  • Individual Image Download: Download single images with a click.
  • Batch Downloading: Download all images and videos from a post, packaged in a zip file.
  • Custom Naming: Configurable naming patterns for zip files and individual images.
  • Multi-Site Support: Accurately downloads assets from Kemono, Coomer, and Nekohouse by targeting the correct image URLs.

Performance and User Experience

  • Improved Image Loading: Modified image loading mechanism to prevent rate-limiting issues.
  • Retry Mechanism: Implements exponential backoff for failed image loads.
  • Status Updates: Provides real-time status updates for image loading and download progress.
  • Mobile Support: Touch-friendly interface with pinch-to-zoom and double-tap interactions.

Video Handling

  • Includes video files in batch downloads.
  • Preserves original video filenames.

New Features (v3.0.0)

  • Enhanced Zoom Controls: Improved zoom button visibility with color inversion for better accessibility against different backgrounds.
  • Advanced Zoom & Pan: Smooth zoom functionality with mouse wheel, dedicated zoom buttons, and double-click support.
  • Touch Support: Mobile-friendly interface with pinch-to-zoom, double-tap to zoom, and smooth touch panning.
  • Inertia Panning: Momentum-based panning for smooth navigation of zoomed images.
  • Expanded Settings Panel: New settings section for zoom and pan configuration including maximum zoom level and inertia preferences.
  • Performance Improvements: Optimized image handling for smoother operation and better memory management.

Previous Updates (v2.4.0)

  • Gallery Key Binding: Use a customizable key to open the gallery. Configurable in settings. Defaults to 'g'.
  • Expanded View: Images and videos can be viewed in an expanded overlay within the gallery. Navigation through arrow keys or on-screen buttons.
  • Thumbnail Navigation in Expanded View: Provides thumbnails for easy navigation within the expanded view.
  • Video Support in Expanded View: Videos are now playable directly within the expanded gallery view.
  • Settings Panel: Added settings panel accessible via a settings button to adjust zip and image filename formats and the gallery hotkey.
  • Code Clarity and Performance Improvements: Code refactoring and optimization for better readability and reduced overhead.

Usage

After installation, navigate to a post on kemono.su, coomer.su, or nekohouse.su. You'll see new buttons for resizing, downloading, and removing images. Use the DL ALL button to initiate a batch download of all media in the post. The GALLERY button opens the new gallery view. Press the configured gallery key (default 'g') to quickly open the gallery.

Within the gallery view, you can open an image or video in an expanded view by clicking on its thumbnail. Once in expanded view, navigate using the 'k' (previous) and 'l' (next) keys or the on-screen navigation buttons.

To zoom in on an image, use the mouse wheel, the zoom buttons in the toolbar, or double-click on the image. When zoomed in, click and drag to pan around the image. On mobile devices, use pinch gestures to zoom and swipe to pan.

Dependencies

Installation

  1. Ensure you have a userscript manager installed (e.g., Tampermonkey, Greasemonkey).
  2. Visit the script's page on Sleazyfork (link to be provided).
  3. Click on the installation button.

Acknowledgments

Version

Current version: 3.0.0

Releases

No releases published

Packages

No packages published