Screen Inu 🐕

Snap. Recognize. Copy.
A modern, cross-platform screenshot OCR tool powered by Rust & Tauri.

English • 繁體中文 • 简体中文 • 日本語 • 한국어

Features • Workflow • Architecture • Getting Started

✨ Features

• Global Shortcut (Ctrl/⌘ + Shift + X): Snap from anywhere, anytime.
• Multi-Engine OCR:
  • Auto-Smart Selection: Automatically picks the best engine for the language (Windows OCR for CJK, Tesseract for others).
  • Windows Native OCR: Integrated Windows Media OCR for superior accuracy in Chinese/Japanese/Korean.
  • Tesseract 5 (Bundled): No installation required! Optimized tessdata_best models included.
• Multi-language Support: Fully localized interface in English and Traditional Chinese (繁體中文).
• History Vault: Automatically saves your recent snips and OCR results locally.
• Auto-Copy: Optionally text to clipboard automatically after recognition.
• Dark/Light Theme: Beautiful glassmorphism UI that adapts to your preference (Auto-saved).
• System Tray Integration: Stays quietly in your menu bar, ready when you are.
• Modern UI: Brutalist "Inu" themed design with smooth Framer Motion animations.
• Cross-Platform: Built on Tauri, compatible with macOS, Windows, and Linux.

---

🚀 Workflow

1. Capture: Trigger the global shortcut to freeze your screen.
2. Select: Drag to select the area containing text.
3. Recognize: The app automatically extracts text using the integrated OCR engine.
4. Copy: Click to copy the result to your clipboard instantly.

---

🏗️ Architecture

Screen Inu leverages the power of Tauri 2.0 for a lightweight, secure, and performant desktop experience.

• Frontend: React + TypeScript + TailwindCSS for a responsive and beautiful interface.
• Bridge: Tauri's IPC allows seamless communication between the UI and system-level operations.
• Backend: Rust handles heavy lifting—screen capturing (xcap), image processing, and OCR (rusty-tesseract).

---

🛠️ Getting Started

Prerequisites

• Node.js (v22+)
• Rust (latest stable)
• (Optional) Tesseract OCR: Only needed if you want to use system-installed Tesseract on Linux/macOS.
  • Windows: Bundled automatically! No install needed.
  • macOS/Linux: The app tries to use bundled binary, but having system Tesseract is a good fallback.

Manual Tesseract Installation (Optional)

• macOS: brew install tesseract tesseract-lang
• Linux: sudo apt install tesseract-ocr tesseract-ocr-chi-tra tesseract-ocr-jpn
• Windows: Not required (Bundled).

Note (Linux): The build.rs script automatically copies your system's tesseract binary to the required location during compilation.

Linux Build Dependencies (Ubuntu/Debian)

sudo apt update && sudo apt install -y \
    build-essential libwebkit2gtk-4.1-dev libayatana-appindicator3-dev \
    librsvg2-dev libxdo-dev libssl-dev libpipewire-0.3-dev libgbm-dev \
    clang curl wget file tesseract-ocr tesseract-ocr-chi-tra tesseract-ocr-jpn

---

Installation

1. Clone the repository

   git clone https://github.com/ImL1s/screen_inu.git
   cd screen_inu

2. Install dependencies

   cd app
   npm install

3. Run in Development Mode

   npm run tauri dev

4. Build for Production

   npm run tauri build

   • macOS: .app and .dmg in src-tauri/target/release/bundle/
   • Windows: .msi or .exe (NSIS) in src-tauri/target/release/bundle/
   • Linux: .AppImage or .deb in src-tauri/target/release/bundle/

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

_{Built with ❤️ by ImL1s}