☰

deutsch

bit-field-docs

Category: Linux Software

Posted at 2026-11-18.


bit-field-docs – Document management for Linux

Organize documents instead of just collecting them

Invoices, contracts, letters, technical documents or scanned papers: Over time, important documents accumulate on every computer. Finding a particular document again can become surprisingly difficult.

bit-field-docs helps you organize your documents, make them searchable and keep track of their contents.

It is a Linux-based document management tool written in Python. It combines OCR, automatic keyword-based labeling and a searchable SQLite database.

What does bit-field-docs do?

Designed for local use

bit-field-docs runs on your Linux computer.

Documents, OCR processing and the SQLite database are managed locally. There is no mandatory cloud service or external AI API.

This makes it suitable for private document collections as well as small office environments where keeping control of the documents is important.

Installation

The installation script takes care of the required system packages and Python environment.

Open a terminal and execute:

chmod +x ~/Downloads/INSTALL.sh
~/Downloads/INSTALL.sh

The program is installed in:

~/bit-field-docs/

The Python virtual environment is located in:

~/.venvs/bit-field-docs/

Using the command line

Change to the installation directory and activate the virtual environment:

cd ~/bit-field-docs
source ~/.venvs/bit-field-docs/bin/activate

Process an existing document

./scan_organizer.py file rechnung.jpg --label Rechnung

Store the resulting PDF in a specific folder

./scan_organizer.py file rechnung.jpg --pdf_path "Rechnungen/2026"

Search for documents

./scan_organizer.py search Rechnung 2026

All search terms must occur in the document text or its labels.

Scan documents

./scan_organizer.py scan --help

This displays the available scanner options.

For a complete list of commands and options:

./scan_organizer.py --help

Data and folder structure

By default, user data is stored in the home directory:

~/scans/                 # Scanner input
~/dokumente/             # Processed documents
    ├── Rechnungen/
    ├── Verträge/
    └── documents.db     # SQLite database

The folder structure can be adapted to your own requirements.

Customization

The automatic labeling is based on configurable keyword lists.

You can extend the existing keywords and add your own categories to adapt the classification to your documents.


bit-field-docs is a lightweight document management tool for Linux users who want to organize their documents without depending on a cloud service.


Title image source: Yaru


... because software matters