Posted at 2026-11-18.
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.
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.
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/
Change to the installation directory and activate the virtual environment:
cd ~/bit-field-docs
source ~/.venvs/bit-field-docs/bin/activate
./scan_organizer.py file rechnung.jpg --label Rechnung
./scan_organizer.py file rechnung.jpg --pdf_path "Rechnungen/2026"
./scan_organizer.py search Rechnung 2026
All search terms must occur in the document text or its labels.
./scan_organizer.py scan --help
This displays the available scanner options.
For a complete list of commands and options:
./scan_organizer.py --help
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.
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