📸 PyShot Utility

A lightweight, high-performance background screenshot tool for Windows

Designed for speed, privacy, and seamless workflow integration

---

🌐 English | Español

---

✨ Key Features

Feature	Description
🥷 Stealth Operation	Runs as a background process (.pyw) to avoid terminal interference
⌨️ Global Hotkey	Instantly trigger captures from any app using Ctrl + Shift + S
🔔 Desktop Notifications	Real-time visual feedback using native Windows toast notifications
📁 Smart File Management	Auto-saves with human-readable timestamps (YYYY-MM-DD_HH-MM-SS)
🚀 Zero-Config & Portable	Uses relative paths — works from any directory

---

�️ Project Structure

PyShot-Utility/
│
├── 📂 assets/            # Project icons and images
├── 📂 screenshots/       # Captured images (auto-generated)
├── 📂 src/
│   └── 🐍 main.pyw       # Main application logic
│
├── 📄 .gitignore         # Prevents personal captures from being uploaded
├── 📄 LICENSE            # MIT License
├── 📄 README.md          # Documentation
└── 📄 requirements.txt   # Dependencies

---

🚀 Getting Started

Prerequisites

Requirements:

• 🐍 Python 3.x
• 🪟 Windows OS (for native notifications and hotkeys)

Installation

1️⃣ Clone the repository:

git clone https://github.com/p0sadas/PyShot-Utility.git
cd PyShot-Utility

2️⃣ Install dependencies:

pip install -r requirements.txt

3️⃣ Run the utility:

python src/main.pyw

---

⌨️ Usage

Ctrl + Shift + S

Press the hotkey at any time to capture your primary monitor. A notification will appear in the Windows Action Center confirming the save! ✅

---

🔄 Run at Startup (Optional)

Want PyShot ready every time you boot Windows? Follow these steps:

1. Press Win + R, type shell:startup, and press Enter
2. Create a shortcut of src/main.pyw
3. Move the shortcut into the Startup folder

🎉 That's it! PyShot will now launch automatically on boot.

---

📄 License

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

---

💻 Developed with ❤️ by Angel Posadas Ruano

If you find this useful, consider giving it a ⭐!