Skip to content

Ronin-CK/QuickSnip

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QuickSnip

A fast, native screen snipping, OCR, and routing tool built for Quickshell.

⚡ Features

  • Instant OCR: Fast text extraction via Tesseract.
  • Smart Actions: Auto-routes URLs/code/text. Double-click words to trigger.
  • Granular Selection: Drag regions, Ctrl+click to multi-select, Shift+click to extend.
  • Integrations: Native send-to Google Lens & Translate.
  • Format Toggles: d (Direct mode), r (Raw OCR layout), s (Single-line).

Installation (Arch)

AUR (maintained by @knownasnaffy):

yay -S quicksnip-git

Manual Installation

sudo pacman -S grim imagemagick tesseract tesseract-data-eng wl-clipboard curl libnotify xdg-utils wlrctl wtype
# Get quickshell from AUR
yay -S quickshell

Other Distros

Fedora:

# Enable COPR repository for quickshell
sudo dnf copr enable errornointernet/quickshell
sudo dnf install quickshell grim ImageMagick tesseract tesseract-langpack-eng wl-clipboard curl

For other distros, install the equivalent packages using your package manager (e.g., apt, zypper). For quickshell, follow the official build instructions if it's not in your repos.

Clone it into your config:

mkdir -p ~/.config/quickshell
git clone https://github.com/Ronin-CK/QuickSnip.git ~/.config/quickshell/QuickSnip

Configuration

Add a keybinding to your compositor config to launch the tool.

Hyprland (hyprland.conf)

bind = $mainMod SHIFT, T, exec, quickshell -c QuickSnip -n

Sway (config)

bindsym $mod+Shift+t exec quickshell -c QuickSnip -n

Niri (config.kdl)

binds {
    Mod+Shift+T { spawn "quickshell" "-c" "QuickSnip" "-n"; }
}

Note on Scaling: If the selection area looks shifted or wrong, it's probably Qt scaling fighting with the compositor. You can force it to 1 like this:

# Hyprland example
bind = $mainMod SHIFT, T, exec, env QT_SCALE_FACTOR=1 QT_AUTO_SCREEN_SCALE_FACTOR=0 quickshell -c QuickSnip -n

QuickSnip Sidebar Extension

QuickSnip includes a companion browser extension to handle instant routing into your browser's sidebar.

Install the extension:

How to use:

  1. In settings.json, ensure "Browser": { "class": "zen" } is set.
  2. Set "open_in": "sidebar" for your desired actions.
  3. Results will now seamlessly dispatch into your dedicated browser sidebar.