Skip to main content

Tool to scan and process documents to palerless

Project description

Scan and prepare your document for paperless

Usage

  1. Use the scan command, with auto-completion on your correspondents and your tags to import your document, to scan your documents.

  2. The document is transferred to your NAS (I use Syncthing).

  3. The documents will be processed on the NAS.

  4. Use scan-process-status to know the status of your documents.

  5. Validate your documents.

  6. If your happy with that remove the REMOVE_TO_CONTINUE file. (To restart the process remove one of the generated images, to cancel the job just remove the folder).

  7. The process will continue his job and import the document in paperless.

Nice feature

Double sized scanning

  1. Pour your sheets on the Automatic Document Feeder.

  2. Run scan with the option --double-sided.

  3. Press enter to start scanning the first side of all sheets.

  4. Put again all your sheets on the Automatic Document Feeder without turning them.

The scan utils will rotate and reorder all the sheets to get a good document.

Credit card scanning

The options --append-credit-card will append all the sheets vertically to have the booth face of the credit card on the same page.

Assisted split

  1. Do your scan as usual with the extra option --assisted-split.

  2. After the process do his first pass you will have images with lines and numbers. The lines represent the detected potential split of the image, the length indicate the strength of the detection. In your config you will have somthing like:

assisted_split:
- destinations:
  - 4  # Page number of the left part of the image
  - 1  # Same for the right page of the image
  image: image-1.png  # name of the image
  limits:
  - margin: 0  # Margin around the split
    name: 0  # Number visible on the generated image
    value: 375  # The position of the split (can be manually edited)
    vertical: true  # Will split the image vertically
  - ...
  source: /source/975468/7-assisted-split/image-1.png
- ...

Edit your config file, you should have one more destination then the limits. If you put destinatination like that: 2.1, it mean that it will be the first part of the page 2 and the 2.2 will be the secound part.

  1. Delete the file REMOVE_TO_CONTINUE.

  2. After the process do his first pass you will have the final generated images.

  3. If it's OK delete the file REMOVE_TO_CONTINUE.

Install

Install in a venv in the home directory:

$ cd
$ python3 -m venv venv
$ ~/venv/bin/pip install scan-to-paperless
$ sudo activate-global-python-argcomplete
$ echo PATH=$PATH:~/venv/bin >> ~/.bashrc

NAS

The Docker support is required, Personally I use a Synology DiskStation DS918+, and you can get the *.syno.json files to configure your Docker services.

Project details


Release history Release notifications | RSS feed

This version

0.8.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scan-to-paperless-0.8.0.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

scan_to_paperless-0.8.0-py2.py3-none-any.whl (6.7 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file scan-to-paperless-0.8.0.tar.gz.

File metadata

  • Download URL: scan-to-paperless-0.8.0.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.8.0 tqdm/4.41.1 CPython/3.6.10

File hashes

Hashes for scan-to-paperless-0.8.0.tar.gz
Algorithm Hash digest
SHA256 fedf584a04f0069a290a17807ef6c5c30897c274576fc89e7f4658c186a3c56c
MD5 b3265183eccd9616c497db49d52f353d
BLAKE2b-256 10b08b964c6916cede0159fcbfd09b1c34b51dd78c947b3c61268b99966aa770

See more details on using hashes here.

Provenance

File details

Details for the file scan_to_paperless-0.8.0-py2.py3-none-any.whl.

File metadata

  • Download URL: scan_to_paperless-0.8.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 6.7 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.8.0 tqdm/4.41.1 CPython/3.6.10

File hashes

Hashes for scan_to_paperless-0.8.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ef438615a944589df853a25c586892e5dd582b31434c88ae27e37d54674d025b
MD5 cc010dbf3e533c2155e84bc26d8999d3
BLAKE2b-256 9dab81d1d8beecbe28fe06903ce35e59cfe348d1474fd086970f806d0ee2e5d3

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page