Skip to content

OCR Screenshot Linux v1.0.0 - ARM64 Release

Latest

Choose a tag to compare

@deadlyunicorn deadlyunicorn released this 04 Oct 18:11

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-screenshot

Other 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-eng

Fedora:

sudo dnf install gtk4 tesseract tesseract-langpack-eng

Arch Linux:

sudo pacman -S gtk4 tesseract tesseract-data-eng

Build 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

  1. Launch the application
  2. Copy an image (screenshot, file, or browser)
  3. Press Ctrl+V in the app window
  4. Copy the text from the results area

Keyboard Shortcuts

  • Ctrl+V: Paste image from clipboard
  • Ctrl+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-screenshot

Build 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

๐Ÿ“Š 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 = 1

Architecture Details

  • Platform: Linux (ARM64/aarch64)
  • Format: ELF 64-bit LSB pie executable
  • Linking: Dynamically linked
  • Stripped: No (debug symbols included)

๐Ÿ’ฌ Support


Built with assistance from Claude (Sonnet 3.5) ๐Ÿค–โœจ

Release Date: October 4, 2025