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 0449244925 Update homepage 2022-05-11 23:48:08 +05:30
.gitignore Add gitignore 2020-01-12 23:44:19 +05:30
CHANGELOG.md Use unique buffer name for process output 2021-05-14 14:48:58 +05:30
Cask Use unique buffer name for process output 2021-05-14 14:48:58 +05:30
README.md doc(README): add Liberapay and MELPA badges 2021-07-13 23:45:21 +05:30
TODO.md Add new ideas 2022-05-11 21:48:05 +05:30
UNLICENSE Rename license files 2020-08-03 19:33:28 +05:30
WTFPL Rename license files 2020-08-03 19:33:28 +05:30
sxiv.el Update homepage 2022-05-11 23:48:08 +05:30

README.md

Donate using Liberapay

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

The main command is M-x sxiv.

Run it in a Dired buffer containing images. Files marked in sxiv (mark/unmark with m) 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.

Limitations

  • 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 an external program
  • ✔️ has better key customizability (to change the keys for sxiv itself, you need to modify its C source)
  • ✔️ supports tagging images
  • ✖️ has no way to mark files for batch operations
  • ✖️ does not seem to center images in fullscreen mode

Contributions and contact

Feedback and MRs very welcome. 🙂

You may be interested in the TODO.md

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

I dream of a world where all software is liberated - transparent, trustable, and accessible for anyone to use or improve. But I don't want to make demands or threats (e.g. via legal conditions) to get there.

I'd rather make a request - please do everything you can to help that dream come true. Please Unlicense as much software as you can.

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

(See files UNLICENSE and WTFPL).

Thanks

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