Screenshot Uploader

Simple and fast screenshot utility for Linux with automatic upload capability.

Features

• 📷 Take screenshots quickly
• 🚀 Automatic or manual upload
• 💾 Local saving option
• 📋 Clipboard support
• 🌍 Multi-language support (en, ru, uk, kk, zh, ja)
• 🖼️ File upload support
• 🎯 Minimal and clean GTK4 interface

Installation

Dependencies

sudo pacman -S python python-pip gtk4 python-gobject cairo python-cairo

Setup

1. Clone the repository:

git clone https://github.com/NeXySssss/screenshot-uploader.git
cd screenshot-uploader

2. Create and activate virtual environment:

python -m venv venv
source venv/bin/activate

3. Install requirements:

pip install -r requirements.txt

4. Make the wrapper script executable:

chmod +x upload.sh

Usage

Command Line Options

Usage: screenshot-uploader.py [ -u | -su | -q | -z | -uf ]

Operation modes:
  -u            Upload automatically without asking
  -su           Save to $XDG_PICTURES_DIR/Screenshots, skip upload and questions
  -q            Take screenshot and ask before upload (default)
  -z            Take screenshot, do not save or upload
  -uf           Select and upload a file

Hyprland Integration

Add these bindings to your ~/.config/hypr/hyprland.conf:

bind = SUPER, S, exec, /path/to/screenshot-uploader/upload.sh -q

bind = SUPER SHIFT, S, exec, /path/to/screenshot-uploader/upload.sh -u

bind = SUPER ALT, S, exec, /path/to/screenshot-uploader/upload.sh -su

bind = SUPER CTRL, S, exec, /path/to/screenshot-uploader/upload.sh -uf

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

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

Author

NeXySssss - GitHub Profile

Last updated: 2025-05-06