Skip to content

ProcStack/pxlViewer

Repository files navigation

pxlViewer v1.2


A PyQt and WebView based image viewer.

pxlViewer is a slim, in appearance, image viewer.
Supporting JPG, JPEG, PNG, BMP, GIF; more to come.

I was getting a little tired of the default options in linux; so I made this thing.
Foopy Scooples pxlVisualizer gif

For Windows users-
If you download the repo, copy dist/pxlViewer to an appropriate location.
Then delete the extract directory and assign file associations / test by 'Open With . . .'
pxlViewer is self contained within dist/pxlViewer


How To Use pxlViewer

Left click drag to move image around

Wheel up/down or right click drag to zoom

Hitting Spacebar or Return will reset the zoom; fitting the image to your window.

R to refresh the current image

H to home the image, sets 100% zoom.

Escape will close pxlViewer

Left Key loads Previous image in directory.

Right Key loads Next image in directory.

F toggles full screen.

Alt key toggles menuBar; displays 'File' 'Image Info' and 'Help.
File shows exit.
Image Info displays the file name, resolution, and file size of the image.
Help displays keyboard shortcuts.

Use the -debug or -d flag to enter debug mode. Allows for inspecting the WebView's page; the developer tools window.


Installation for Linux

Upgrading pip helped the other modules install correctly for me

python -m pip install --upgrade pip
pip install Pillow
sudo apt-get install python-qt4

I've linked it to an alias for ease of use; in .bash_aliases or .bashrc you can add-
alias v='python /your/path/to/pxlViewer.py '

It can be ran locally from any folder--
With no specified file to load, the first image found is displayed-
v

Or with a specific file given-
v imageFile.jpg

End of Linux Install

Installation for Windows

To use the premade executable; copy dist/pxlViewer to a desired location

Then delete the extract directory and assign file associations / test by 'Open With . . .'


If you want to rebuild the executable for windows, follow the directions below-

What worked for me on Windows 10 -
Open a Command Prompt, search for cmd in your windows menu
Find the pip.exe in your python folder, copy that path, add cd, then paste into cmd; it should look similar to this-
cd C:\Python27\Scripts
Running the command should move you to the folder-
C:\Python27\Scripts>

This helped me for installing some packs correctly in general, update the pip exes; run this-
python -m pip install --upgrade pip

Pillow Image Library (PIL) is required to run pxlViewer, install by running-

pip install Pillow

You'll need to download SIP and PyQt4;
But as of 4/1/2018, there was no exe built for the newest version of PyQt4.12
Sooo, either (1) try an older bundle version, 4.11.4 This worked fine for me -
https://sourceforge.net/projects/pyqt/files/PyQt4/PyQt-4.11.4/

Or (2) manually set up Sip and PyQt through their source-
https://riverbankcomputing.com/software/sip/download
https://riverbankcomputing.com/software/pyqt/download

To test that pxlViewer works, find directory with images by browse to and copy the path into the command prompt, or navigate there in prompt-
cd C:\path\to\image\directory

You can view the first image in the directory with-
python C:\your\path\to\pxlViewer.py
Or view a specific image with-
python C:\your\path\to\pxlViewer.py imageName.ext


Making pxlViewer easier to use on Windows: Build pxlViewer.exe on Windows

Make sure pxlViewer works with no errors from your Command Prompt first!

If pxlViewer works, to continue you'll need to have pyinstaller installed

To install pyinstaller, from your python/Scripts folder again-
cd C:\Python27\Scripts
Run -
pip install pyinstaller

Then browse to your pxlViewer download/extract folder and double click the buildExe.bat file.
This may take a couple minutes to build.

After this, you can right click an image, go to Open With..., and navegate to- C:\path\to\pxlViewer\dist\pxlViewer\pxlViewer.exe

If all is well, your image should open with pxlViewer!

End of Windows Install

Thanks for checking out pxlViewer!

About

PyQt / Javascript Imageviewer

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published