gitwtfhub

wtf is hbot?

abhishekdhital/hbot — explained in plain English

Analysis updated 2026-05-18

5PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

Hbot is a free, offline Windows app that scans documents with a webcam or images, cleans them up with filters and cropping, and manages them as PDFs.

Mindmap

mindmap
  root((hbot))
    What it does
      Offline document scanning
      Webcam auto capture
      PDF management
    Tech stack
      Python
      PySide6
      Tesseract OCR
    Use cases
      Scan and clean pages
      Redact sensitive info
      Merge and protect PDFs
    Audience
      Windows users
      Privacy focused users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Scan a paper document with a webcam and automatically flatten and crop it into a clean digital page.

REASON 2

Blur out sensitive information like ID numbers or account numbers before sharing a scanned document.

REASON 3

Merge, split, or password protect a PDF made from scanned pages.

REASON 4

Search for a specific word across scanned pages using offline text recognition.

What's in the stack?

PythonPySide6Tesseract OCR

How it stacks up

abhishekdhital/hbot1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencegeneralops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires Python 3.10 or newer on Windows, Tesseract OCR is an optional extra install needed only for the Find in Page search feature.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

Wtf does this do

Hbot is a free, offline desktop app for Windows that turns a webcam or imported images into scanned, cleaned up documents, similar in spirit to phone scanning apps like CamScanner but without sending anything over the internet. It runs entirely on the user's own computer as a Python and PySide6 application. The app can detect the edges of a document held up to a webcam and automatically flatten out the perspective distortion, and it can auto capture a page once it is held steady, then re-arm itself when the page is turned. A book mode splits a two page spread into separate single pages at the center gutter. Once a page is captured, Hbot offers filters such as color correction, shadow removal, black and white, grayscale, and noise reduction, along with manual brightness and contrast controls and rotation. Corners of a detected page can be dragged and adjusted by hand before cropping. Beyond basic scanning, Hbot includes tools for marking up a page: drawing with a pen, marker, or highlighter, blurring out sensitive regions like ID numbers, adding a tiled watermark, and placing a signature either drawn by hand or stamped from a saved image file. It can also search for a word across a page using offline text recognition through Tesseract, with matches highlighted directly on the page. For managing documents, Hbot converts images to PDF and back, converts PDF files to Word documents, and can merge, split, rearrange, or delete pages within a document. It supports AES-256 password protection on PDFs with separate control over print and copy permissions. Setting it up requires Python 3.10 or newer, with Tesseract OCR as an optional extra install for the search feature. The project also includes a one click build script that packages the app into a standalone Windows installer, and it can be built into a ready-made executable through GitHub Actions without needing a Windows machine at all. Hbot is released under the MIT license, and it supports free code signing through the SignPath Foundation's open source program to avoid Windows SmartScreen warnings on first run.

Yoink these prompts

Prompt 1
Explain how Hbot's Smart Crop and Adjust Corners features work together when scanning a document.
Prompt 2
Walk me through setting up Hbot on Windows, including the optional Tesseract OCR install.
Prompt 3
How do I blur sensitive information on a scanned page and add a signature to it in Hbot?
Prompt 4
What steps do I follow to build a signed Windows installer for Hbot using GitHub Actions?

Frequently asked questions

wtf is hbot?

Hbot is a free, offline Windows app that scans documents with a webcam or images, cleans them up with filters and cropping, and manages them as PDFs.

What language is hbot written in?

Mainly Python. The stack also includes Python, PySide6, Tesseract OCR.

What license does hbot use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is hbot to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is hbot for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.