Scans to PDF
Creates small searchable PDFs from scanned documents with OCR.
Tested on Linux
Use it
Linux x86_64
These steps ran from a folder named work in the home folder, which already existed. Make it and run them from there:
mkdir -p "$HOME/work" && cd "$HOME/work"clone djpdf source for install
git clone https://github.com/Unrud/djpdf djpdf-srcpip install djpdf library
pip3 install --quiet ./djpdf-srcinstall meson and GUI deps
pip3 install --quiet meson ninja PySide6
Where the README and reality differ
- README: Manual deps: ImageMagick, QPDF, jbig2enc, Tesseract; pip3 install . + meson builddir && meson install
What worked: msgfmt/msginit/msgmerge/xgettext from gettext plus desktop-file-validate, and PySide6 + meson/ninja for GUI; Qt xcb plugin also needs system libxcb-cursor0 which is absent in box
Verified in pickfit: the commands exactly as its sandbox ran them
For the record only: they name the sandbox's home, /home/sbx.
git clone https://github.com/Unrud/djpdf djpdf-srcpip3 install --quiet ./djpdf-src 2>&1pip3 install --quiet meson ninja PySide6 2>&1PYTHONPATH=/home/sbx/work/djpdf-src:$PYTHONPATH python3 -c "from scans2pdf_gui.main import main; import sys; sys.exit(main())" --helpCheck that it works
PYTHONPATH="$HOME"/work/djpdf-src:$PYTHONPATH python3 -c "from scans2pdf_gui.main import main; import sys; sys.exit(main())" --helpThe output should contain “increase output verbosity”.
What it does
- Split scans into text and background layersNot tested
- Add a searchable OCR text layer to PDFsNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 0 of 2 features work
- Works offline
Good for
- create searchable PDFs from scanned documents
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Installs and starts
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 0.5.14
Differences the test machine hit
- README: flatpak run com.github.unrud.djpdf
In the test: flatpak app installs but flatpak run --help aborts with ImportError: libshiboken could not import PySide6.QtCore - README: GUI starts on Linux desktop
In the test: extract libxcb-cursor0 deb to ~/xcb-extract and LD_LIBRARY_PATH it so Qt xcb plugin can load; launch still showed no window in this run