gitwtfhub

wtf is screenshot-search-engine?

itssaisathan/screenshot-search-engine — explained in plain English

Analysis updated 2026-05-18

52PythonAudience · generalComplexity · 2/5Setup · moderate

TL;DR

An offline Python desktop app that uses OCR to make your screenshots searchable by the text they contain.

Mindmap

mindmap
  root((Screenshot Search))
    What it does
      Indexes screenshots automatically
      Extracts text with OCR
      Searches by keyword or fuzzy match
    Tech stack
      Python
      CustomTkinter
      SQLite
      PyTesseract
    Use cases
      Find old screenshots by text
      Research and note taking archive
      Local private image search
    Audience
      Vibe coders
      Researchers
      Note takers

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

Search through a folder of screenshots by the text visible inside them.

REASON 2

Automatically index new screenshots as you take them without manual sorting.

REASON 3

Build a private, offline archive of reference screenshots for research or notes.

What's in the stack?

PythonCustomTkinterSQLitePyTesseractOpenCV

How it stacks up

itssaisathan/screenshot-search-engineamaravijayalakshmi216-collab/crop-recommendation-systembiansy000/mda
Stars525252
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity2/52/55/5
Audiencegeneralresearcherresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires installing Tesseract-OCR separately before the app can extract text from images.

No license information is stated in the source, so usage terms are unknown.

Wtf does this do

Screenshot Search Engine is a fully offline desktop application that indexes your screenshots so you can search through them by their content. It solves a familiar problem: knowing you captured something useful in a screenshot at some point, but having no way to find it again without scrolling through hundreds of images. The app watches a folder you choose and automatically indexes any new screenshots added to it, running the indexing in the background so the interface does not freeze. Each image is read with OCR (Optical Character Recognition, software that pulls text out of a picture) using PyTesseract, with OpenCV used beforehand to clean up the image and improve accuracy on things like app screenshots and UI text. The extracted text, file paths, and a perceptual hash of each image are stored in a local SQLite database, and that hash is used to detect and skip duplicate screenshots. Searching combines exact keyword matches on filenames and extracted text with fuzzy matching, so small typos in a search still find the right result. The interface is a modern, dark mode friendly desktop window built with CustomTkinter, and everything runs locally: no API keys, no cloud services, and no accounts. Because the OCR engine depends on Tesseract-OCR, that has to be installed separately before the app works, and the README's setup instructions are written specifically for Windows. The project can also be packaged into a standalone Windows executable with PyInstaller, though Tesseract itself still needs to be present on the machine running it. This is aimed at someone who takes a lot of screenshots for reference, research, or note-taking and wants to retrieve them by what they actually contain rather than by filename or date. Planned future additions mentioned in the README include semantic search and finding visually similar screenshots, neither of which is built yet.

Yoink these prompts

Prompt 1
Help me install Tesseract-OCR and set up this Screenshot Search Engine project on my machine.
Prompt 2
Walk me through how the OCR and duplicate detection pipeline works in this app.
Prompt 3
Help me package this project into a standalone Windows executable with PyInstaller.
Prompt 4
Show me how I could add semantic search to this app using local sentence-transformers.

Frequently asked questions

wtf is screenshot-search-engine?

An offline Python desktop app that uses OCR to make your screenshots searchable by the text they contain.

What language is screenshot-search-engine written in?

Mainly Python. The stack also includes Python, CustomTkinter, SQLite.

What license does screenshot-search-engine use?

No license information is stated in the source, so usage terms are unknown.

How hard is screenshot-search-engine to set up?

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

Who is screenshot-search-engine for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

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