Skip to main content

HandyView, image viewer

Project description

download visitors PyPI license python lint Publish-pip Release

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


Handy Series:    HandyView Icon HandyViewHandyFigure Icon HandyFigureHandyCrawler Icon HandyCrawlerHandyWriting Icon HandyWriting

🔧 Installation

Windows

  1. Download the pre-compiled executable zip file from the release page.
  2. Unzip the file
  3. Set HandyView as the default image viewer, so that you can double-click the image to open HandyView.

MacOS

  1. Download the handyviewer.dmg from the release page and install.
  2. If you fail to install the app, you may first need to disable gatekeeper first. You should be aware of the risk of disabling gatekeeper.
  3. Set HandyView as the default image viewer (use cmd+i), so that you can double-click the image to open HandyView.

Ubuntu

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 https://github.com/xinntao/HandyView.git
  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

Ubuntu

For python user, you can also launch HandyView from the command line:

  1. Clone repo and install dependent packages

    git clone https://github.com/xinntao/HandyView.git
    cd HandyView
    pip install -r requirements.txt
    
  2. Run

    python -m handyview.handyviewer [image_path]
    

: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

Compile to executable program

For Windows and MacOS users, you can find the instructions of compiling the executable program from how-to-build.

: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

  • preview mode
  • show zoom info for each folder (store in database)
  • drag together in the multi-view comparison mode

Editing operation

  • Simple image edit: crop, resize, color conversion, etc
  • Draw rectangular and enlarged the area
  • Make GIF easily

:books: References

:scroll: License and Acknowledgement

This project is released under the MIT license.

Icons

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 auto zoom Auto Zoom
auto image Image crop Crop video Video

(pip install pyqt5 -i http://mirrors.xxx.com/pypi/simple/ --trusted-host mirrors.xxx.com)

:e-mail: Contact

If you have any question, please open an issue or email xintao.wang@outlook.com.

Project details


Download files

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

Source Distribution

handyview-1.0.2.tar.gz (6.8 kB view details)

Uploaded Source

Built Distribution

handyview-1.0.2-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file handyview-1.0.2.tar.gz.

File metadata

  • Download URL: handyview-1.0.2.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for handyview-1.0.2.tar.gz
Algorithm Hash digest
SHA256 56f700dc639cb7258f56a911168114db3bdeeef39390fd996d51701a0f7fdb2c
MD5 eaf702641d8d77548b2edc24b607fe92
BLAKE2b-256 a9a677c87d184861b94f2dd838ef7ae4cf4b67b55bdb7830ab90e28b8c2308d3

See more details on using hashes here.

File details

Details for the file handyview-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: handyview-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 5.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for handyview-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6b4d40f5fed894a2c4fb5038e8d9b52c11c9910dcaca6b9964c57adb5e96dcdf
MD5 7576f85587073e70acef698e715bdc56
BLAKE2b-256 48d107245d6256395ea5b8760a119d299f0b5cc273c043cff30fccbdd0e38ad9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page