Package: salt-viewer
SaltViewerVery simple image viewer on tkinter.WhyI need mcomix alternative. Thus this program is developed.Support these.Many image typepillowsvgAnimationGIF, PNGduration auto adjustmentTrash commandDouble page modeFull screen modeVim like keymap (Vim like keyboard shortcut)You can custamize by yourselfRepetition keyFor example100hmeans go to next 100 pageOpen archive filesZip, Rar, 7z, Pdf, tar, tar.gzTrash image or archiveMove file wiht keySupport nested archiveHow to installpip install salt-vieweroryay -S salt-viewerI usepython3.9.3. However it will work on old version greater thanpython3.5.This scripts use these pip modules.cairosvgnatsortpdf2pythonpillowpy7zrpypdf3rarfilesend2trashAnd use these packages.unrar(preferred), unar or bsdtarFor rarfilepopplerFor pdf2pythonHow to UseNow you can usesalt-viewercommand.salt-viewer <image file | archive file>If you use linux, you should use alias for time saving.alias sv=salt-viewerDocument$ salt-viewer --help
usage: salt_viewer.py [-h] [--config CONFIG] [--icon] [--default_config] [--debug] [--fullscreen] [--prev_cache PREV_CACHE] [--next_cache NEXT_CACHE] [--fit_mode FIT_MODE] [--page_order PAGE_ORDER]
                      [--double] [--upscale UPSCALE] [--downscale DOWNSCALE]
                      path

SaltViewer. Simple (archived) image viewer (https://github.com/GuiltyCat/SaltViewer)

positional arguments:
  path                  image file or archive file

optional arguments:
  -h, --help            show this help message and exit
  --config CONFIG       configuration file path. default is /home/miyamoto/.svrc
  --icon                write icon to path
  --default_config      write default configuration to path. salt-viewer --default_config >~/.svrc
  --debug               run as debug mode. All log is printed.
  --fullscreen          run as fullscreen mode
  --prev_cache PREV_CACHE
                        number of previous page cache. Default is 4
  --next_cache NEXT_CACHE
                        number of previous page cache. Default is 10
  --fit_mode FIT_MODE   fit_mode. Both, Raw, Width, Height. Default is Both
  --page_order PAGE_ORDER
                        page order in double page mode. right2left or left2right. Default is right2left
  --double              Double page mode. Default is None.
  --upscale UPSCALE     Upscale algorithm. Nearest, Box, Bilinear, Hamming, Bicubic, Lanczos. Default is Lanczos
  --downscale DOWNSCALE
                        Downscale algorithm. Nearest, Box, Bilinear, Hamming, Bicubic, Lanczos. Default is LanczosHow to useThe only way to control SaltViewer is key press.
You can custamize keymaps by argments or config file.How to Use SaltViewer in default keymap. But you can custamize via
Basic keymaps.Page movementsNextPage: h. Support repetition.PrevPage: l. Support repetition.Archive movementsNextArchive: j. Not support repetition.PrevArchive: k. Not support repetition.If you open image file in directory, NextArchive and PrevArchive command is works as NextPage and PrevPage.
This command is assumed to use when opening a archive file like zip.If you open archive and press PrevArchive, the first page of previous archive is opened not the end page.In nested archive, like zip in zip or rar in rar, SaltViewer automatically open recursively till reaching image file.
In other words, SaltViewer automatically open recursively and flatten nested archive in NextArchive.
However, in the case of PrevArchive, a first page of first archive in archives is opened.To move archive in archive, you can use NextArchive and PrevArchive.
For example, assume that you open a sample1.zip below.sample1.zipnested_sample1.rar1.jpg2.jpg3.jpgnested_sample2.zip1.png2.png3.pngsample2.7z1.svgSaltViewer displays 1.jpg in nested_sample1.
Then if you type NextPage, 2.jpg in nested_sample1 is opened.
If you type NextArchive, SaltViewer open 1.png in nested_sample2.zip
Thsn if you type PrevArchive, SaltViewer open 1.jpg in nested_sample2.You can walk around archive like you are in directory.If you reach the end of file and type, in this case 3.png in nested_sample2.zip, 1.svg in sample2.7z is opened.Config fileSupport config file.
Default reading place is~/.svrc.You can write default default config file by running this command option.salt-viewer --default_config ~/.svrcBe careful, this command do NOT overwrite a existing file.KeymapYou can change these keymaps via configuration file.[Keymap]

DoublePage  = d


# 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 <[>
NextPage    = h
PrevPage    = l

NextArchive = j
PrevArchive = k

Head        = g
Tail        = G


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

PageOrder   = o


TrashFile   = Delete
MoveFile    = m

Quit        = q
FullScreen  = f
Reload      = r


[MoveToList]

# When you press MoveFile key, then press key registered.
# File will be moved to registered place.

# a = /home/GuiltyCat/images/fantastic
# b = /home/GuiltyCat/images/bravo
# c = /home/GuiltyCat/images/wonderful
#SettingYou can change these settings via configuration file.[Setting]

# None, Width, Height or Both
DefaultFitMode = Both
DefaultFullScreen = True


# If you make this value too much, it will occupy too much memory.
DefaultPrevCache = 4
DefaultNextCache = 10

# true or false.
DoublePage = False

# right2left or left2right
PageOrder  = right2left

# Resize algorithms
# | Filter   | Downscaling quality | Upscaling quality | Performance |
# | Nearest  | -                   | -                 | *****       |
# | Box      | *                   | -                 | ****        |
# | Bilinear | *                   | *                 | ***         |
# | Hamming  | **                  | -                 | ***         |
# | Bicubic  | ***                 | ***               | **          |
# | Lanczos  | ****                | ****              | *           |

UpScale     = Lanczos
DownScale   = LanczosMoveListYou can set move list.If you type MoveFile key, a place list is appear.
These list contains key and place pair.
Then you type a key, opening file will be moved to a place.[MoveToList]

# When you press MoveFile key, then press key registered.
# File will be moved to registered place.

# a = /home/GuiltyCat/images/fantastic
# b = /home/GuiltyCat/images/bravo
# b = /home/GuiltyCat/images/wonderful
#Page CacheSaltViewer's page cache do something strange.SaltViewer read previous and next pages around a current page.
For speed, this preload is running on an other thread.Preload thread read by one page, or half of self.next_cache pages not unpreloaded number of pages.
And automatically deleted out of range pages.Sometimesgetitemsmay takes too much time and preload cache use used ingetitems.
Thus preload should be as many as possible.If you make next_cache and prev_cache too much, it will occupy memory and make your PC freeze.
This problem happens when you tried to open high quality files.IconYou can create SaltViewer Icon by running.salt-viewer --icon icon.svgIcon format is svg only. Suffix is ignored.Yet ImplementedPre resize and convertBig images takes time to resize and convert to tkImageAnd do resize in preloadZoom in and Zoom out imageMove around imagesTODOHistoryMerge move_file and trash because both have very similar code.