Paperwork is a tool to make papers searchable.

Papers are organized into documents. Each document contains pages.

It uses mainly 3 other pieces of software:

• Sane: To scan the pages
• Cuneiform or Tesseract: To extract the words from the pages (OCR)
• GTK/Glade: For the user interface

Page orientation is automatically guessed using OCR.

Paperwork uses a custom indexation system to search documents and to provide keyword suggestions. Since OCR is not perfect, and since some documents don't contain useful keywords, Paperwork allows also to put labels on each document.

GPLv3. See COPYING.

• python v2.7
  Paperwork is written for Python 2.7. So depending of your Linux distribution, you may have to invoke "python2" instead of "python" (for instance with Arch Linux)
• pygtk v2 (required)
  • Debian/Ubuntu package: python-gtk2
• python-glade2 (required)
  • Debian/Ubuntu package: python-glade2
• pycountry (required)
  • Debian/Ubuntu package: python-pycountry
• python-imaging (required)
  • Debian/Ubuntu package: python-imaging
• pyinsane (required)
  • Debian/Ubuntu package: none at the moment
  • Manual installation:
    • git clone git://github.com/jflesch/pyinsane.git
    • cd pyinsane
    • sudo python ./setup.py install
• OCR (optional for document searching ; required for scanning)
  • Tesseract (>= v3) (recommended)
    • Debian package: none at the moment
    • Ubuntu package: tesseract-ocr tesseract-ocr-
  • Or Cuneiform (>= v1.1)
    • Debian/Ubuntu package: cuneiform
• pyocr (required)
  • Debian/Ubuntu package: none at the moment
  • Manual installation:
    • git clone git://github.com/jflesch/pyocr.git
    • cd pyocr
    • sudo python ./setup.py install

$ git clone git://github.com/jflesch/paperwork.git
$ cd paperwork
$ sudo python ./setup.py install
$ paperwork

Enjoy :-)

• Mailing-list: paperwork-gui@googlegroups.com
• Bug tracker: https://github.com/jflesch/paperwork/issues

Try to stick to PEP-8 as much as possible. Mainly:

1. Lines are at most 80 characters long
2. Indentation is done using 4 spaces

The code is divided following a 3-Tier architecture but uses the MVC vocabulary:

• View : The GUI itself (only .glade files for now)
• Controller :
  • Take the user action into account and change the model accordingly
  • Extract the informations from the model and inject them in the view
• Model : Backend code. Provides:
  • Document indexation
  • Keyword suggestions
  • Document modifications (labels, etc) and deletion

If you want to make changes, here are few things that can help you:

1. You don't need to install paperwork to run it. Just run 'src/paperwork.py'.
2. Paperwork looks for a 'paperwork.conf' in the current work directory before looking for a '.paperwork.conf' in your home directory. So if you want to use a different config and/or a different set of documents for development than for your real-life work, just copy your '/.paperwork.conf' to './paperwork.conf'. Note that the settings dialog will also take care of updating './paperwork.conf' instead of '/.paperwork.conf'.
3. "pep8" is your friend
4. "pylint" is your friend: $ cd src ; pylint --rcfile=../pylintrc *.py