Skip to content

QAInsights/achu

Repository files navigation

Achu Logo

Achu

A lightweight, gorgeous desktop utility for Windows, macOS, and Linux that turns raw screenshots into polished visual assets.

Achu (அச்சு) means `print` in Tamil. 🖨️

Electron React TypeScript Platform Support License Vitest Tests
Ollama OpenAI Gemini Claude


📸 Screenshots & Showcase

🎨 Canvas Beautification & Presets 🛡️ Privacy Guard & Redaction
Presets Privacy
🤖 AI Issue Agent Integration 🔍 OCR Text Extraction
AI Issue Agent OCR

✨ Features

🎨 Canvas & Framing Aesthetics

  • Beautification Layouts: Frame screenshots with custom padding, background blur, rounded corners, adjustable shadows, scale, and custom aspect ratios.
  • Fluid Mesh Gradients: Generate premium multi-point mesh gradients for background wrappers, along with linear/radial gradients and solid colors.
  • Browser Chrome Overlays: Instantly add polished browser mockups (macOS-style or Windows-style window controls) around your screenshots.
  • Aspect Ratio Presets: Quickly format your graphics for popular social platforms like Twitter/X, LinkedIn, and Product Hunt.

🛡️ Smart Privacy Guard

  • Auto-Scanning: Scans screenshots locally using Tesseract WASM to automatically detect credentials, API keys, passwords, credit card numbers, email addresses, IP addresses, phone numbers, and physical locations.
  • Pixel-Perfect Redaction: Toggle visibility for individual detected items or redact all with one click.
  • Gaussian Blur & Solid Masks: Choose between soft Gaussian Blur or clean 100% Solid Color masks.
  • PNG Integrity: Suggests exporting to PNG format for redacted captures to ensure deleted/masked pixel values are completely scrubbed and unrecoverable.

🤖 AI-Powered Issue Agent

  • Automated Bug Reporting: Uses vision models to analyze your screenshot and generate full GitHub issue templates (titles, tags, reproduction steps, and system context).
  • Multi-Provider AI support:
    • Ollama (Fully Offline): Run models locally (e.g., llava-phi3) with no external data leaks.
    • Google Gemini: gemini-2.5-flash
    • OpenAI: gpt-4o-mini
    • Anthropic Claude: claude-3-5-sonnet-latest
  • Direct GitHub Integration: Connect your repository and push the generated issue reports directly to GitHub.

🔍 OCR Canvas Text Grabber

  • Right-Click OCR: Right-click anywhere on the canvas screenshot to extract text content instantly.
  • Grab Text Modal: Edit, trim, format, and copy the extracted text to your clipboard.
  • 100% Private: Runs Tesseract OCR in-browser via WebAssembly, performing text extraction locally on your machine.

🖊️ Rich Vector Annotations

  • Drawing Tools: Annotate screenshots using rectangles (filled/outline), ovals (filled/outline), straight lines, arrows, freehand pen, custom text fields, and emojis.
  • Full Object Control: Move, resize, delete, and re-order drawn annotation layers.
  • Deep Edit History: Full support for multi-step Undo (Ctrl+Z) and Redo (Ctrl+Y) operations.

⌨️ Keyboard Shortcuts

Shortcut Description
Ctrl + V / Ctrl + Alt + V Paste image from Clipboard
Ctrl + Z Undo last action
Ctrl + Y Redo last action
Ctrl + Shift + S Copy beautified snap to clipboard
Delete / Backspace Delete selected annotation object
V or 1 Select / Move Tool
R / Shift + R / 2 / 3 Rectangle Tool (Outline / Filled)
C / O / Shift + C / 4 / 5 Circle / Oval Tool (Outline / Filled)
L / A / 6 / 7 Line / Arrow Tool
T / P / 8 / 9 Text / Freehand Pen Tool
E / 0 Add Emoji Tool

🚀 Getting Started

Prerequisites

  • Node.js 18 or higher
  • npm

Installation

  1. Clone the repository:

    git clone https://github.com/QAInsights/achu.git
    cd achu
  2. Install dependencies:

    npm install
  3. Launch development mode with Hot Reload:

    npm run dev

🛠️ Build & Package

Achu uses electron-builder to package lightweight native binaries for Windows, macOS, and Linux.

Script Action Output / Description
npm run build Compile code Generates optimized production bundles in app-bundle/
npm run test Run tests Runs unit and rendering tests using Vitest
npm run test:coverage Coverage Generates a coverage report via v8
npm run package Pack App Builds production bundles and packages portable packages in release/
  • Windows Target: Standalone portable .exe executable (x64 / arm64).
  • Linux Target: Standalone AppImage and .deb packages.
  • macOS Target: Standalone .dmg disk image and .zip archives.

🔒 Security & Privacy

  • Local OCR & Secrets Scanning: Tesseract WASM scans and extracts your screenshot text strictly locally inside the Electron sandbox. No images or text are sent to third parties during OCR or Privacy Guard runs.
  • Secure Token Storage: All external AI keys and GitHub API tokens are stored using Electron's native safeStorage API, which encrypts credentials on disk using operating-system-level cryptography (Keychain on macOS, DPAPI on Windows, and Secret Service/KWallet on Linux).

☕ Support & Community

If you find Achu useful, consider supporting development or checking out QAInsights resources:

About

A lightweight desktop app for beautifying screenshots and more.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages