grabIT

A versatile screenshot, screen recording, and file uploader with OCR support for multiple services including Zipline, Nest, and others.

Features

• Screenshots with region selection on Wayland/X11
• Screen Recording with region selection (MP4 format)
• OCR Text Extraction using Tesseract
• Multiple Upload Services (Zipline, Nest, FakeCrime, EZ, Guns, PixelVault)
• GUI Configuration with dark theme support
• Clipboard Integration for images, videos, and text
• Cross-platform support (Wayland/X11, KDE/GNOME)

Requirements

Core Dependencies

• bash, curl, jq, xdg-utils, libnotify
• python3, tk (for GUI and preview features)

Display Server Specific

Wayland (KDE)

• spectacle (screenshots + recordings)
• wl-copy (clipboard)

Wayland (GNOME)

• gnome-screenshot (screenshots)
• Recording not supported (use Ctrl+Alt+Shift+R or install Kooha/OBS)
• wl-copy (clipboard)

Wayland (Other)

• grim, slurp (screenshots)
• wf-recorder (recordings)
• wl-copy (clipboard)

X11 (GNOME)

• gnome-screenshot (screenshots)
• ffmpeg, slop (recordings)
• xclip (clipboard)

X11 (Other)

• flameshot (screenshots)
• ffmpeg, slop (recordings)
• xclip (clipboard)

Optional Features

• tesseract + python-pyocr (OCR text extraction)
• python-pillow, python-screeninfo (image preview)

Installation

Nix (Flakes)

If you have Nix (with Flakes enabled), you can run grabit without manual installation of dependencies.

Run without installing

nix run git+https://heliopolis.live/creations/grabit.git -- --help

Development Shell

Includes all system dependencies and Python libraries:

nix develop
grabit --help

Install to user profile

nix profile install git+https://heliopolis.live/creations/grabit.git

Add to NixOS Configuration

# In your flake.nix or configuration.nix
{
  inputs.grabit.url = "git+https://heliopolis.live/creations/grabit.git";
  
  outputs = { self, nixpkgs, grabit, ... }: {
    nixosConfigurations.your-hostname = nixpkgs.lib.nixosSystem {
      modules = [
        ({ pkgs, ... }: {
          environment.systemPackages = [
            grabit.packages.${pkgs.system}.default
          ];
        })
      ];
    };
  };
}

Arch Linux (AUR)

paru -S grabit

Void Linux

echo "repository=https://github.com/Creationsss/void-repository/releases/latest/download" | sudo tee /etc/xbps.d/creations.conf
sudo xbps-install -S grabit

Manual Installation

git clone https://heliopolis.live/creations/grabit.git
cd grabit
chmod +x main.sh

Configuration

GUI Configuration

./main.sh --gui

Command Line Configuration

./main.sh --config

Set Specific Values

./main.sh set SERVICE zipline
./main.sh set DOMAIN "https://your-zipline.domain.com"

Usage

Screenshots

# Take screenshot and upload to configured service
./main.sh -u

# Copy screenshot to clipboard  
./main.sh -c

# Upload specific service
./main.sh --zipline

Screen Recording

# Record screen region and upload
./main.sh --record -u

# Record screen region and copy path to clipboard
./main.sh --record -c

# Record screen region to specific service
./main.sh --record --nest

OCR Text Extraction

# Take screenshot and extract text to clipboard
./main.sh --tesseract

File Upload

# Upload existing file
./main.sh -f /path/to/file.png -u

Debug Mode

# Enable debug output
./main.sh -d --record -u

Silent Mode

# Suppress notifications and previews
./main.sh --silent -c

Supported Services

• Zipline (self-hosted)
• Nest (nest.rip)
• FakeCrime (fakecrime.bio)
• EZ Host (e-z.host)
• Guns (guns.lol)
• PixelVault (pixelvault.co)

Notes

• Automatically detects Wayland/X11 and desktop environment
• Supports both temporary and persistent file saving
• GUI configuration with automatic dark theme detection
• Debug mode available with -d flag
• All features work across different desktop environments

License

BSD-3