Picpocket is an image viewer which requires GNU Emacs 27.1 or later or 25.1-26.3 compiled with ImageMagick. It have commands for:
- File operations on the picture files (delete, move, copy, hardlink).
- Scale and rotate the picture.
- Associate pictures with tags which are saved to disk.
- Filter pictures according to tags.
- Customizing keystrokes for quick tagging and file operations.
- Undo and visual history of undoable commands.
Command: picpocket View the pictures in the current directory.
Command: picpocket-directory View the pictures in specified directory.
Space - Next picture
BackSpace - Previous picture
r - Rename picture file
c - Copy picture file
k - Delete picture file
t - Edit tags
s - Slide-show mode
[ - Rotate counter-clockwise
] - Rotate clockwise
+ - Scale in
- - Scale out
u - Undo
M-u - View history of undoable actions
e - Customize keystrokes (see below)
TAB f - Toggle full-screen
TAB r - Toggle recursive inclusion of pictures in sub-directories
l l - List current pictures
l n - List current pictures with thumbnails
l T - Browse tag database
With prefix argument many of the commands will operatate on all the pictures in the current list instead of just the current picture.
Picpocket will secretly do stuff in the background with idle
timers. This includes to load upcoming pictures into the image
cache. The intention is that they should block Emacs for so short
periods that it is not noticable. But if you want to get rid of
them set picpocket-inhibit-timers or kill the picpocket buffer.
Keystokes can be bound to commands that move/copy pictures into directories and/or tag them. The following creates commands on keys 1 though 5 to tag according to liking. Also creates some commands to move picture files to directories according to genre. Finally creates also one command to copy pictures to a backup directory in the user's home directory.
(defvar my-picpocket-alist
'((?1 tag "bad")
(?2 tag "sigh")
(?3 tag "good")
(?4 tag "great")
(?5 tag "awesome")
(?F move "fantasy")
(?S move "scifi")
(?P move "steampunk")
(?H move "horror")
(?U move "urban-fantasy")
(?B copy "~/backup")))
(setq picpocket-keystroke-alist 'my-picpocket-alist)
Digits and capital letters with no modifiers is reserved for these kind of user keybindings.
It is recommended to set picpocket-keystroke-alist to a symbol as
above. That makes the command picpocket-edit-keystrokes (bound
to e in picpocket buffer) jump to your definition for quick
changes. Edit the list and type M-C-x to save it.
See the doc of picpocket-keystroke-alist for about the same thing
but with a few more details.
Tags associated with pictures are saved to disk. By default to ~/.emacs.d/picpocket/. This database maps the sha1 checksum of picture files to list of tags. This implies that you can rename or move around the file anywhere and the tags will still be remembered when you view it with picpocket again.
If you change the picture file content the sha1 checksum will
change. For example this would happen if you rotate or crop the
picture with an external program. That will break the association
between sha1 checksum and tags. However picpocket also stores the
file name for each entry of tags. The command
picpocket-db-update will go through the database and offer to
recover such lost associations.
If you change the file-name and the file content at the same time there is no way to recover automatically.