HandyView, image viewer
Project description
🔻Executable files | 🔧Installation | 📕使用说明
HandyView is a handy image viewer for convenient viewing and comparing. It is developed with PyQt5.
Handy
Series:
HandyView HandyFigure HandyCrawler
HandyWriting
🔧 Installation
- Download the pre-compiled executable zip file from the release page.
- Unzip the file
- Set HandyView as the default image viewer, so that you can double-click the image to open HandyView.
- Download the handyviewer.dmg from the release page and install.
- 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.
- Set HandyView as the default image viewer (use
cmd+i
), so that you can double-click the image to open HandyView.
I used the early version of HandyView on Ubuntu. The current version is not tested on Ubuntu and may be out-of-date.
- Clone this repo
git clone https://github.com/xinntao/HandyView.git
- How to double click to open an image
- Modify the HandyView.desktop file - Exec & Icon
- Copy the .desktop file to
/usr/share/applications
- How to change the default image viewer
- Right click an image
- Go to
Properties
->Open With
- Choose HandyView
For python user, you can also launch HandyView from the command line:
-
Clone repo and install dependent packages
git clone https://github.com/xinntao/HandyView.git cd HandyView pip install -r requirements.txt
-
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 | History | Refresh | |||
Index | Include | Exclude | |||
Compare | Clear comparison | Help | |||
Main canvas | Compare canvas | Preview canvas | |||
Fingerprint | Auto Zoom | ||||
Image | Crop | 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56f700dc639cb7258f56a911168114db3bdeeef39390fd996d51701a0f7fdb2c |
|
MD5 | eaf702641d8d77548b2edc24b607fe92 |
|
BLAKE2b-256 | a9a677c87d184861b94f2dd838ef7ae4cf4b67b55bdb7830ab90e28b8c2308d3 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6b4d40f5fed894a2c4fb5038e8d9b52c11c9910dcaca6b9964c57adb5e96dcdf |
|
MD5 | 7576f85587073e70acef698e715bdc56 |
|
BLAKE2b-256 | 48d107245d6256395ea5b8760a119d299f0b5cc273c043cff30fccbdd0e38ad9 |