Skip to content
huanfe1Public

About

A sleek, ultra-fast, and modern image viewer extension for Chromium-based browsers.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

PicoView Banner

PicoView

A sleek, ultra-fast, and modern image viewer extension for Chromium-based browsers

English | 简体中文

Manifest V3 Version 1.0.1 Dependencies None License MIT


📖 Introduction

When opening standalone image tabs in Chromium browsers, the native viewer experience is often bare-bones: zoom increments are rigid, panning and rotating are unsupported, and transparent backgrounds or pixel-level details are difficult to inspect.

PicoView is a modern, lightweight, and dependency-free browser extension built on the Manifest V3 standard. It turns plain image tabs into a fluid, feature-rich viewing studio. Whether you are browsing photographs, inspecting transparent SVGs, or analyzing pixel art, PicoView delivers a seamless and delightful experience.


✨ Features

  • 🚀 Blazing Fast & Lightweight: Crafted in pure vanilla JavaScript and CSS with zero external libraries or bundle bloat.
  • 🔍 Smooth Stepless Zoom: Continuous zoom from 2% to 4000% anchored around your cursor.
  • 🖐️ Fluid Panning: Drag images freely across the viewport with optional boundaries to prevent losing sight of the image.
  • 🔄 Rotation & Flip: 90° clockwise/counter-clockwise rotation, plus instant horizontal (H) and vertical (V) flipping.
  • 🏁 Checkerboard Background: One-key toggle for a high-contrast transparency grid behind transparent PNGs, WebP, and SVGs.
  • 👾 Pixelated Mode: Crisp nearest-neighbor rendering without blur or bilinear interpolation—ideal for pixel art, sprites, and icons.
  • 🎨 Immersive Backdrops:
    • Solid background colors with independent palettes for standard bitmaps and transparent vector SVGs.
    • Dynamic blurred backdrop generated from the current image.
  • 🌐 Built-in Internationalization (i18n):
    • Full English and Simplified Chinese support with automatic system language detection and manual language override.
  • ⚡ Thoughtful Interactions:
    • Dedicated SVG background color ensures dark vector paths remain clearly visible.
    • Context menu item, "Open image in current tab", off by default and available in settings.
    • Accessible design with live screen reader announcements and keyboard navigation.
  • 🛠️ Customizable Controls: Interactive shortcut recorder to rebind or disable any key, plus independent inversion toggles for wheel zoom, pan, and rotation.

⌨️ Controls & Default Shortcuts

All keyboard shortcuts can be rebound or cleared in the Settings page:

Shortcut / Action Function
Mouse Wheel Smooth zoom centered on cursor (default mode)
Ctrl + Wheel Vertical pan
Shift + Wheel Horizontal pan
Alt + Wheel Precise rotation
Left Click + Drag Pan image freely
Esc Exit PicoView and restore native browser rendering
T Toggle transparent checkerboard background
P Toggle pixelated rendering (disable smoothing)
Q Rotate 90° counter-clockwise
E Rotate 90° clockwise
H Flip horizontally
V Flip vertically
↑ ↓ ← → Pan viewport (hold Shift for faster panning)

🚀 Installation & Usage

  1. Download the archive: Open Releases and download the latest PicoView-v*.zip.
  2. Unzip: Unzipping it gives you a PicoView folder. Keep the folder intact instead of pulling out individual files.
  3. Open the extensions page: In Chrome, go to:
    chrome://extensions
    
    Edge uses edge://extensions. Brave, Arc, Vivaldi, and other Chromium browsers use their own extensions page.
  4. Turn on Developer mode: Enable Developer mode in the top-right corner.
  5. Load the extension: Click Load unpacked and select the unzipped PicoView folder.
  6. Start viewing: Open a standalone image URL to enter PicoView. The webpage image context menu is off by default and can be enabled in settings.

⚙️ Options & Customization

Click the PicoView icon in the browser toolbar or right-click it and choose "Options" to open the settings:

  • Appearance & View:
    • Interface Language: Follow System (Auto) / English / 简体中文.
    • Background Style: Solid color or blurred backdrop from the image.
    • Bitmap Background Color: Custom background color behind JPG, PNG, and WebP images.
    • SVG Background Color: Independent color dedicated to vector SVGs.
    • Initial Zoom: Fit if larger (Recommended) / Always fit window / Actual size (100%).
    • Initial Alignment: 9 alignment anchor presets (Center, Top-Left, etc.).
    • Smooth Transitions: Enable or disable fluid CSS transitions.
  • Controls & Gestures:
    • Wheel Default Mode: Zoom image (Recommended) or native page scroll.
    • Inversion Options: Individually invert directions for zoom, vertical pan, horizontal pan, and rotation.
    • Context Menu Item: Off by default. When enabled, right-click a webpage image and choose "Open image in current tab".
  • Keyboard Shortcuts:
    • Click any key button to record a new key binding.
    • Right-click an assigned key to clear its shortcut.

📁 Directory Structure

PicoView/
├── src/                           # Extension source; release archives are packed from here
│   ├── _locales/                  # Chrome Extension i18n locales
│   │   ├── en/messages.json       # English messages
│   │   └── zh_CN/messages.json    # Simplified Chinese messages
│   ├── manifest.json              # Manifest V3 extension configuration
│   ├── background.js              # Background service worker (context menu & routing)
│   ├── content.js                 # Content script for standalone image tabs
│   ├── i18n.js                    # Lightweight unified i18n manager & dictionaries
│   ├── viewer-core.js             # PicoView view engine (pan/zoom/gestures/transforms)
│   ├── viewer-css.js              # Core injected styles and animations
│   ├── viewer-page.js             # Standalone viewer sandbox runner
│   ├── viewer.html                # Isolated viewer sandbox page
│   ├── settings.js                # Centralized settings loading & schema normalization
│   ├── options.html               # Options page layout
│   ├── options.js                 # Options page logic & key recording
│   ├── options.css                # Options page modern UI styling
│   └── icons/                     # Extension icons (16px to 128px)
├── assets/                        # Design assets and documentation media (not shipped)
│   ├── logo.png                   # PicoView high-resolution app icon (512x512)
│   └── banner.png                 # README official display banner
├── README.md                      # Documentation (English)
└── README_CN.md                   # Documentation (简体中文)

📄 License

This project is licensed under the MIT License.

About

A sleek, ultra-fast, and modern image viewer extension for Chromium-based browsers.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages