Skip to main content

Simple image viewer

Project description

SaltViewer

Very simple image viewer on tkinter.

Why

I use mcomix on Linux for a long time. However, default mcomix do not support

  • GIF animation
  • Trash command

Thus I need mcomix alternative. I want to treat

  • Many image type
  • Archive files, like zip, rar, 7z
  • Animation image like GIF
  • Trash image or archive

Feature

  • Single script
  • Support archive
    • Zip, Rar, 7z, Pdf
  • Support many image types
    • pillow
    • svg
  • Support dual page mode
  • Support animation
    • duration auto adjustment
    • GIF, PNG
  • Repetition key
    • For example 100h means go to next 100 page.
  • Delete image
  • Configure file

How to install

pip install salt-viewer

I use python3.9.3. However it will work on old version greater than python3.5.

This scripts use these pip modules.

  • cairosvg
  • natsort
  • pdf2python
  • pillow
  • py7zr
  • rarfile
  • send2trash

And use these packages.

  • unrar(preferred), unar or bsdtar
    • For rarfile
  • poppler
    • For pdf2python

How to Use

Now you can use salt-viewer command.

salt-viewer <image file | archive file>

If you use linux, you should use alias for time saving.

alias sv=salt-viewer

Keymap

Cutout from default configuration file.

[Keymap]

DoublePage  = d
TrashFile   = Delete

NextPage    = h
PrevPage    = l

# You can use repetition for NextPage and PrevPage.
# For example, 2h means goto next 2 page, type 100h go to next 100 page.
# If you want to reset number, type <Esc>, <Ctrl+[> or simply <[>

NextArchive = j
PrevArchive = k

FitNone     = N
FitWidth    = W
FitHeight   = H
FitBoth     = B

PageOrder   = o

Quit        = q
Head        = g
Tail        = G

TODO

  • Cache image for speed

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

salt-viewer-0.1.1.tar.gz (23.2 kB view hashes)

Uploaded Source

Built Distribution

salt_viewer-0.1.1-py3-none-any.whl (23.3 kB view hashes)

Uploaded Python 3

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