Skip to content

flameshot fork with integrated OCR: copy text from screenshots to clipboard using Tesseract

License

Notifications You must be signed in to change notification settings

sid-sg/flameshot-ocr

Repository files navigation

Flameshot OCR

A fork of Flameshot with built-in OCR: Instantly extract and copy text from screenshots to your clipboard using Tesseract OCR.


Features

  • Take screenshots and extract text from any region using Tesseract OCR
  • Copy recognized text directly to your clipboard
  • Works fully offline, all OCR is performed locally
  • Supports multiple languages (if Tesseract language packs are installed)
  • All core Flameshot screenshot and annotation features are preserved

Usage

  1. Run Flameshot OCR:
./build/src/flameshot
  1. Take a screenshot as usual (tray icon or hotkey).
  2. Select the OCR tool from the toolbar.
  3. Draw/select a region containing text.
  4. Text is automatically copied to your clipboard.

Keyboard Shortcut (Linux)

To bind OCR capture to Print Screen:

  • Go to Settings → Keyboard → Shortcuts → Custom Shortcuts
  • Add a new shortcut with command:
flameshot gui
  • Assign it to Print Screen

For best results, add flameshot to your startup applications so the daemon is running.


Compilation

Dependencies

  • Qt >= 5.9
  • GCC >= 7.4
  • CMake >= 3.12
  • Tesseract OCR (and language packs as needed)

Ubuntu/Debian example:

sudo apt update
sudo apt install g++ cmake build-essential qtbase5-dev qttools5-dev-tools libqt5svg5-dev \
libtesseract-dev libleptonica-dev tesseract-ocr

Optional: Install extra language packs

sudo apt-get install \
tesseract-ocr-deu \
tesseract-ocr-fra \
tesseract-ocr-spa \
tesseract-ocr-chi-sim \
tesseract-ocr-jpn \
tesseract-ocr-ara \
tesseract-ocr-hin \
tesseract-ocr-rus

Build

git clone https://github.com/sid-sg/flameshot-ocr.git
cd flameshot-ocr
mkdir build
cmake -S . -B build && cmake --build build --parallel

Notes

  • OCR language selection defaults to English. To use other languages, install the relevant Tesseract language packs.
  • For best clipboard compatibility, run flameshot as a daemon and use the tray icon or hotkey.

License

This project is licensed under GPLv3, same as the original Flameshot.


Refer to the original Flameshot documentation for more details about flameshot.

About

flameshot fork with integrated OCR: copy text from screenshots to clipboard using Tesseract

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 277