Repository navigation
OCR Screenshot Linux v1.0.0 ๐
First stable release! A fast, native Linux OCR application built with Rust and GTK4.
๐ What's New
This is the initial release of OCR Screenshot Linux, featuring:
- โจ Fast Native Application: Built with Rust for optimal performance
- ๐ Clipboard Integration: Paste images directly with Ctrl+V
- ๐ Advanced OCR: Tesseract integration with optimized preprocessing
- ๐จ Modern UI: GTK4 interface that matches your system theme
- โก Async Processing: Non-blocking OCR with channel-based communication
- ๐ ๏ธ Smart Preprocessing: CLAHE, Otsu thresholding, and intelligent upscaling
๐ฆ Downloads
ARM64 / aarch64 (Pre-built Binary)
File: ocr-screenshot-linux-v1.0.0-aarch64.tar.gz (339 KB compressed, 810 KB binary)
Architecture: ARM 64-bit (aarch64) - for Raspberry Pi 4/5, Apple Silicon under Linux, ARM servers, etc.
# Quick start
wget https://github.com/deadlyunicorn/ocr-screenshot-linux/releases/download/v1.0.0/ocr-screenshot-linux-v1.0.0-aarch64.tar.gz
tar -xzf ocr-screenshot-linux-v1.0.0-aarch64.tar.gz
cd release-package
./ocr-screenshotOther Architectures (Build from Source)
For x86_64 (Intel/AMD) or other architectures:
git clone https://github.com/deadlyunicorn/ocr-screenshot-linux.git
cd ocr-screenshot-linux/rust-implementation
cargo build --release๐ System Requirements
Runtime Dependencies
Ubuntu/Debian:
sudo apt-get install libgtk-4-1 tesseract-ocr tesseract-ocr-engFedora:
sudo dnf install gtk4 tesseract tesseract-langpack-engArch Linux:
sudo pacman -S gtk4 tesseract tesseract-data-engBuild Dependencies (for source builds)
See the README for complete build instructions.
๐ฏ Features
Core Functionality
- Clipboard Support: Press Ctrl+V to paste images from clipboard
- Auto OCR: Automatically processes images upon paste
- Text Selection: Extract and copy recognized text
- Image Preview: View pasted images before OCR
Technical Highlights
- Language: Rust ๐ฆ
- GUI Framework: GTK4
- OCR Engine: Tesseract 5.x
- Image Processing: Custom preprocessing pipeline
- Grayscale conversion
- CLAHE (Contrast Limited Adaptive Histogram Equalization)
- Otsu thresholding for optimal binarization
- Smart upscaling for small images (min 1500px)
- Lanczos3 filtering for quality resampling
Performance
- Binary Size: 810 KB (uncompressed)
- Memory Usage: ~10-20 MB RAM
- Startup Time: Sub-second
- OCR Speed: 1-3 seconds typical
๐ Usage
- Launch the application
- Copy an image (screenshot, file, or browser)
- Press Ctrl+V in the app window
- Copy the text from the results area
Keyboard Shortcuts
Ctrl+V: Paste image from clipboardCtrl+C: Copy extracted text
๐ง Installation
Quick Install (ARM64)
# Download and extract
tar -xzf ocr-screenshot-linux-v1.0.0-aarch64.tar.gz
cd release-package
# Install to user bin
mkdir -p ~/.local/bin
cp ocr-screenshot ~/.local/bin/
chmod +x ~/.local/bin/ocr-screenshot
# Add to PATH (add to ~/.bashrc)
export PATH="$HOME/.local/bin:$PATH"
# Run
ocr-screenshotBuild from Source
# Clone repository
git clone https://github.com/deadlyunicorn/ocr-screenshot-linux.git
cd ocr-screenshot-linux/rust-implementation
# Install Rust if needed
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
# Build
cargo build --release
# Binary location
./target/release/ocr-screenshot๐ Known Issues
- Currently supports English language only (easily extendable)
- Requires X11/Wayland display server
- Best results with clear, high-contrast text
๐ฎ Future Plans
- Multi-language support
- Drag-and-drop file support
- OCR history
- System tray integration
- Custom preprocessing profiles
- Batch processing
๐ค Contributing
Contributions are welcome! Please feel free to submit pull requests or open issues.
๐ License
MIT License - see LICENSE file for details
๐ Acknowledgments
- Tesseract OCR - Powerful OCR engine
- GTK - GUI toolkit
- Rust GTK4 bindings - Excellent Rust bindings
๐ Technical Details
Dependencies
gtk4 = "0.9"
gdk4 = "0.9"
glib = "0.20"
image = "0.25"
tesseract = "0.15"
imageproc = "0.25"Compilation Options
[profile.release]
opt-level = 3
lto = true
codegen-units = 1Architecture Details
- Platform: Linux (ARM64/aarch64)
- Format: ELF 64-bit LSB pie executable
- Linking: Dynamically linked
- Stripped: No (debug symbols included)
๐ฌ Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Built with assistance from Claude (Sonnet 3.5) ๐คโจ
Release Date: October 4, 2025