Skip to main content

Tool for indexing and sorting documents using QR codes

Project description

qrDocumentIndexer

A python library for tagging PDF documents with QR codes so that they can be rebuilt into the same document structure after being printed and scanned back.

Purpose

This library is intended to be used where documents may be printed and then subsequently scanned back to digital format. Normally this process would result in the loss of any format structure. The documents may even be scanned back in different orders. This can be particularly common in the cases where documents being printed are technical drawings and they may be re-ordered for review or other purposes before being scanned again.

This library is intended to store the following information about each page of a PDF in a QR code:

  • Filename
  • Page number
  • Bookmarks (including nesting)

This information can then be used to restructure the documents after scanning. This should even be possible if documents are scanned into multiple PDFs or image files.

Additional metadata that could be included in future could include:

  • Pagesizes
  • Paper orientation

Current State

The tool in it's current state should be fully functional. It can:

  • Insert QR codes into each page of provided PDFs to allow later sorting;
  • Scan PDFs or image files for QR codes to determine their appropriate order in a document;
  • Reconstitute PDF files based on the order dictated by detected QR codes, recreating the original filenames and orders of the documents.

What is missing:

  • There is currently no progress indication. It will finish when it finishes;
  • Currently the QR scanning process is single threaded so it may take some time to complete;
  • There is no preview for the documents so you will have to run the tool for everything to see what you get.

How to install

Install with the following command:

pip install qrDocumentIndexer

ZBar

This package relies on the ZBar library. Please see the below guides for ensuring this library is properly installed:

On Windows:

No installation is required as it is packaged with the python libraries, but it does have dependancies which if not present can cause errors:

If you see an ugly ImportError related with lizbar-64.dll, install the vcredist_x64.exe from the Visual C++ Redistributable Packages for Visual Studio 2013

On Linux:

sudo apt-get install libzbar0

On Mac OS X:

brew install zbar

Project details


Download files

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

Source Distribution

qrDocumentIndexer-0.1.0.tar.gz (49.4 kB view details)

Uploaded Source

Built Distribution

qrDocumentIndexer-0.1.0-py3-none-any.whl (38.3 kB view details)

Uploaded Python 3

File details

Details for the file qrDocumentIndexer-0.1.0.tar.gz.

File metadata

  • Download URL: qrDocumentIndexer-0.1.0.tar.gz
  • Upload date:
  • Size: 49.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for qrDocumentIndexer-0.1.0.tar.gz
Algorithm Hash digest
SHA256 53e83523be231c9c45799cfaca39b3f2ca3b4f8881ea33e9ffffb41211c97379
MD5 d663ac76e4b2abf1b006b3d73325e184
BLAKE2b-256 01cdc385933c0b0a1c85a90a4f37e54c96117dc8a178cc7007a34290798fed66

See more details on using hashes here.

File details

Details for the file qrDocumentIndexer-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for qrDocumentIndexer-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8b7b96a451ec25a4b8c938b6ed8c81ac816d0e210a624e06e1c3ec37509274ee
MD5 5d991971955585f2fecb447d3ae71e18
BLAKE2b-256 5bc266eb9510fa071ff1be930d8b6764cc0e1f08f220a8c922550c2481c99602

See more details on using hashes here.

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