This repository has been archived on 2022-05-13. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
contrapunctus 4f9a47d190 Add gitignore 2020-01-12 23:44:19 +05:30
.gitignore Add gitignore 2020-01-12 23:44:19 +05:30
CHANGELOG.md Add licenses, changelog 2020-01-12 23:07:26 +05:30
LICENSE Add licenses, changelog 2020-01-12 23:07:26 +05:30
LICENSE.1 Add licenses, changelog 2020-01-12 23:07:26 +05:30
README.md README - add comparison with picpocket 2020-01-12 23:39:31 +05:30
sxiv.el Fixes from byte compilation, package-lint 2020-01-12 23:43:08 +05:30

README.md

sxiv.el

Launch sxiv (Simple X Image Viewer) from Emacs, with Dired integration.

Installation

You can get sxiv.el from

sxiv.el requires dash.el and an installed sxiv in your $PATH

Usage

M-x sxiv - entry point. Run it in a Dired buffer containing images. Files marked in sxiv will be marked in Dired.

If the Dired buffer has marked files, open only those files.

With prefix argument, or when only provided directories, run recursively.

Run it from a text file containing one file name per line to open the listed files.

TODO

  • Create user-customizable variable to hold default arguments
  • Mark files in subdirectories if run recursively (by inserting the subdirectory into the current buffer)
  • Let user edit options (ideally with transient.el) when called with null argument/two prefix arguments
  • When running with a lot of files, sxiv may take some time to start. Signal to the user that it is starting, and let them kill it if they want.
  • What should be the behavior when we open Dired-marked files, then mark files within sxiv?

Limitations

  • Currently falls flat if run in directories with a huge number of images.
  • sxiv-dired-marked-files-p doesn't work as intended with non '*' markers (e.g. C or D)

Comparison with picpocket

At a cursory glance, picpocket (v20180914)

  • 👍 does not depend on any external programs
  • 👎 does not open directories recursively
  • 👎 cannot be used to visually mark files in Dired

Contributions and contact

Feedback and MRs very welcome. 🙂

Contact the creator and other Emacs users in the Emacs room on the Jabber network - xmpp:emacs@salas.suchat.org?join (web chat)

(For help in getting started with Jabber, click here)

License

sxiv.el is released under your choice of Unlicense and the WTFPL.

(See files LICENSE and LICENSE.1).

Thanks

wasamasa, bpalmer and #emacs for all their help and support