Skip to main content

HandyView, image viewer

Project description

icon HandyView

English | 简体中文GitHub | Gitee码云

Handy Series:

HandyView Icon HandyViewHandyFigure Icon HandyFigureHandyCrawler Icon HandyCrawlerHandyWriting Icon HandyWriting

HandyView is a handy image viewer for convenient viewing and comparing. It is developed with PyQt5.

:sparkles: Features

  • Switch among images with fixed zoom ration, which is useful when comparing image details. (Unfortunately, I cannot find such a image viewer and this is the initial motivation to develop HandyView).
  • Various comparison modes.
  • Show basic image information, e.g., image path, shape, size, color type, zoom ration, etc.
  • Show the position and color in the current mouse cursor.
  • Draw rectangles on images and show the start and end position.

:eyes: Screenshot

  • Current screenshot

  • Switch among images with fixed zoom ratio

  • Compare images in two-column or three-column modes

  • Show the position and color of the current mouse cursor

  • Draw rectangles and show the start and end positions

:wrench: Usage

I have now tested it on Windows. It should also work on Ubuntu (but may with some modifications).


Option 1: Pre-compiled executable zip file

I have zipped an exe zip file with pyinstaller in the release page (Github | Gitee). You can first have a try on it.

  1. Unzip the file
  2. Set HandyView as the default image viewer, so that you can double-click the image to open HandyView.

Option 2: Python environment

  • Anaconda (Python >= 3.5)
  1. Clone repo

    git clone
  2. Install dependent packages

    cd HandyView
    pip install -r requirements.txt

In the command line, run:

python handyview/ [image_path]

Option 3: Python environment + Compile to executable program

Use pyinstaller to compile to executable program, so that you can double-click the image to open the HandyView.

  1. pyinstaller -D handyview/ -i icon.ico --windowed

  2. You will see a dist folder containing the outputs (dll, exe, etc)
  3. Copy necessary files to the dist folder

    cp -r icons dist/handyviewer/
    cp icon.png dist/handyviewer/
    cp icon.ico dist/handyviewer/

  4. Choose the dist/handyview/handyviewer.exe as the default image viewer.


I used the early version of HandyView on Ubuntu. The current version is not tested on Ubuntu and may be out-of-date.

  1. Clone this repo git clone
  2. How to double click to open an image
    1. Modify the HandyView.desktop file - Exec & Icon
    2. Copy the .desktop file to /usr/share/applications
  3. How to change the default image viewer
    1. Right click an image
    2. Go to Properties -> Open With
    3. Choose HandyView

:book: Document (On the way)

The basic operation (such as shortcut keys) could be found in the Help button in the toolbar.

:hourglass_flowing_sand: TODO list

  • <input type="checkbox" disabled="" /> preview mode
  • <input type="checkbox" disabled="" /> show zoom info for each folder (store in database)
  • <input type="checkbox" disabled="" /> drag together in the multi-view comparison mode

Editing operation

  • <input type="checkbox" disabled="" /> Simple image edit: crop, resize, color conversion, etc
  • <input type="checkbox" disabled="" /> Draw rectangular and enlarged the area
  • <input type="checkbox" disabled="" /> Make GIF easily

:books: References

:scroll: License and Acknowledgement

This project is released under the MIT license.


I have used the icons from flaticon. The following are the source links.

Icon Link Icon Link Icon Link
Open Open History History Refresh Refresh
Index Index Include Include Exclude Exclude
Compare Compare Clear comparison Clear comparison Help Help
Main canvas Main canvas Compare canvas Compare canvas Preview canvas Preview canvas
Fingerprint Fingerprint

:e-mail: Contact

If you have any question, please open an issue or email

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for handyview, version 0.4.2
Filename, size File type Python version Upload date Hashes
Filename, size handyview-0.4.2.tar.gz (6.3 kB) File type Source Python version None Upload date Hashes View
Filename, size handyview-0.4.2-py3-none-any.whl (4.6 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page