Paperless - Emacs assisted PDF document filing
You've just scanned a stack of papers that have been cluttering up your desk. Now what? Paperless mode is an Emacs major mode designed to assist with the filing of scanned documents into a hierarchy of folders.
Paperless mode provides PDF document previews, ido-based target directory completion, and simple batch filing commands designed to simplify and speed the filing of all of your scanned documents.
Here's how it works...
Scan your documents and dump them into a holding directory. Set the
paperless-capture-directory to reference this directory.
M-x customize-variable to set this string.
Tell paperless-mode where to file the documents by setting
M-x customize-variable, or you can
set both variables in your
~/.emacs/init.el like so:
(custom-set-variables '(paperless-capture-directory "/home/green/CAPTURE") '(paperless-root-directory "/home/green/Documents"))
paperless-root-directory, create a hierarchy of directories that
makes sense for you. For example, you might create directories to
sort documents like so:
[paperless-root-directory]/Finance /Taxes /2015 /2016 /Insurance /Car /Home /Work /Expenses /2016-FOSDEM /20170102-NYC /20170202-SFO /Medical /Receipts /2016 /2017 /Utilities /Mobile /Electricity
At the time of this writing, the author's directory tree contains over 620 folders.
Once loaded, start paperless with
M-x paperless and you'll be
presented with the list of PDF files in
[SPC] key to open PDF preview buffers. The
0 keys will adjust the scale of the preview, just as they do in
DocView or PDFView mode. Use the
r key to rename the file. If you
omit a filename extention, paperless will append ".pdf" to your new
filename. Use the
f key to select the destination directory. Files
aren't renamed or moved until you select the
Paperless requires Emacs 24.4, and is available in the MELPA package repository.
To install from source, simply download this package to your local filesystem, and add something like the following to your ~/.emacs/init.el:
(autoload 'paperless "paperless" "A major mode for filing PDFs" t) (add-to-list 'load-path (expand-file-name "/home/green/git/paperless/"))
Don't forget to set
paperless-root-directory as per above.
Copyright (C) 2016 by Anthony Green
Paperless is provided under the terms of the 3-clause BSD license. See paperless.el for details.