QViewer
A fast, lightweight image viewer built with PyQt5 and optimized with Cython. Navigate through multiple images with keyboard shortcuts!
Features
- 🖼️ View images from local files or URLs
- ⚡ Auto-scaling to fit screen
- 🎨 Frameless window design
- ⌨️ Keyboard navigation (Arrow keys, Space)
- 🔄 Cycle through multiple images
- 📁 Directory scanning (with recursive depth control)
- 📋 Clipboard support
- 🚀 Cython-optimized for performance
Supported Formats
JPG, JPEG, PNG, GIF, BMP, TIFF, TIF, WEBP, ICO, SVG, HEIC, HEIF, AVIF, JFIF, APNG
Installation
pip install qviewer
Usage
Command Line
# View single image
qviewer image.jpg
# View multiple images (navigate with arrow keys)
qviewer img1.jpg img2.png img3.gif
# View all images in a directory
qviewer /path/to/images/
# View images in directory (max depth 2 subdirectories)
qviewer -d 2 /path/to/images/
# View only current directory (no subdirectories)
qviewer -d 0 /path/to/images/
# Mix files and directories
qviewer image1.jpg /path/to/more/images/ image2.png
# View image from URL
qviewer https://example.com/image.png
# Load from clipboard
qviewer c
Keyboard Shortcuts
Arrow Right/Arrow Down/Space- Next imageArrow Left/Arrow Up- Previous imageQ/Escape- Quit
Python API
from qviewer import show, collect_all_images
# View single image
show(['/path/to/image.jpg'])
# View multiple images
images = [
'/path/to/img1.jpg',
'/path/to/img2.png',
'https://example.com/img3.gif'
]
show(images)
# Collect images from directory and view
images = collect_all_images(['/path/to/images'], max_depth=2)
show(images)
Command Line Options
usage: qviewer [-h] [-d N] [paths ...]
positional arguments:
paths Image file(s), URL(s), or directory path(s)
Use "c" to load from clipboard
optional arguments:
-h, --help show help message and exit
-d N, --depth N Maximum directory recursion depth
(default: infinite, 0: current dir only)
Requirements
- Python >= 3.7
- PyQt5 >= 5.15.0
- requests >= 2.25.0
- clipboard >= 0.0.4
Examples
Browse vacation photos
qviewer ~/Pictures/Vacation2024/
Compare multiple screenshots
qviewer screenshot1.png screenshot2.png screenshot3.png
Review images from multiple directories
qviewer ~/Downloads/ ~/Pictures/Recent/ -d 1
Quick view from clipboard
# Copy image URL or path, then:
qviewer c
👤 Author
Metadata
Release files for qviewer 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| qviewer-1.0.1.tar.gz | 109.9 kB | Without provenance | Details for qviewer-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| qviewer-1.0.1-cp311-cp311-win_amd64.whl | CPython 3.11 | CPython 3.11 | Windows x86-64 | Details for qviewer-1.0.1-cp311-cp311-win_amd64.whl |
Total release size: 272.6 kB
Release files / qviewer-1.0.1.tar.gz
| Download URL | qviewer-1.0.1.tar.gz |
|---|---|
| Size | 109.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9dcf5c8cd74fd527fd2ca8c49be20bb3557e1f896de11262c7cb8abef8083189
|
|
BLAKE2b-256 checksum How to use checksums |
7f87cfd0209af1c921ea2da39215ab787f92a2e1c28a45062e72d0203627cea5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.4
|
Release files / qviewer-1.0.1-cp311-cp311-win_amd64.whl
| Download URL | qviewer-1.0.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 162.7 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
9a9f3f213ba19b0494246d666bd878384ed4453c8ad88399f7e1f3659c55a2ab
|
|
BLAKE2b-256 checksum How to use checksums |
e2a8d0f1b7346698cadfaf23a4746ef2564f76228ad1c8bce3ce206f64c494d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.4
|
Security for qviewer 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.