Watch 2 Star 7 Fork 2

Xintao / HandyViewC++MIT

Create your Gitee Account
Explore and code with more than 5 million developers,Free private repositories !:)
Sign up
Clone or download
Notice: Creating folder will generate an empty file .keep, because not support in Git

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).
  • Show basic image information, for example, image path, shape, size, color type, zoom ration, etc.
  • Show the position and color in the current mouse cursor.

:eyes: Screenshot

[To be updated]

:wrench: Usage

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



  • 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]

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 the handyview/icons folder and the handyview/icon.png image to the dist folder
  4. Choose the dist/handyview/handyview.exe as the default image viewer.


I used Ubuntu in the previous versions. Now I switch to Windows (with wsl) for development. So this 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

:hourglass_flowing_sand: TODO list

Compare operations

  • Given two directories, it can compare the corresponding images.

Editing operation

  • Simple image edit: crop, resize, color convertion, etc.
  • Draw rectangular and enlarged this area.
  • 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.

:e-mail: Contact

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

Comments ( 0 )

Sign in for post a comment


HandyView 是一款基于 PyQt5 开发的图像查看器. 它能够方便地用来查看和比较, 专门针对研究中的需求设计 :-) spread retract


No release

Gitee Metrics




load more
can not load any more