Skip to content

Latest commit

 

History

History
69 lines (43 loc) · 1.76 KB

README.md

File metadata and controls

69 lines (43 loc) · 1.76 KB

Auto Screenshot Taker — README.md

IMPORTANT: This tool is for ethical, consent-based, and legal uses only (usability testing, personal time-lapse, debugging on machines you own or have explicit permission to test). Do not use for stealthy surveillance or on other people's devices without written consent.

Project overview

A simple, configurable Python utility that captures desktop screenshots at regular intervals and saves them locally. This README documents safe usage, installation steps, system requirements, command-line options, and examples.

Features

  • Periodic screenshot capture to a local folder
  • Configurable interval and total duration
  • Option to limit total number of screenshots
  • Visible mode that prints status to console (no stealth)
  • Graceful stop on user interrupt (Ctrl+C)

Requirements

  • Python 3.8+
  • pip package manager

Python packages (install with pip):

  • pyautogui (captures screenshots)
  • pillow (PIL imaging library used by pyautogui)

Optional (for Windows users):

  • pygetwindow or pywinauto if you later add window-specific captures or GUI features.

Installation (recommended)

  1. Clone the repository (or place safescreenshot.py in a folder):
git clone https://github.com/DotX-47/Auto-screeshot.git
cd auto-screenshot
  1. Create and activate a virtual environment:
python3 -m venv venv
# macOS / Linux
source venv/bin/activate
# Windows (PowerShell)
venv\Scripts\Activate.ps1
  1. Install dependencies:
pip install --upgrade pip
pip install pyautogui pillow

On Linux, pyautogui may require additional system packages (for example, python3-xlib, scrot or imagemagick) depending on your distribution.

Tell me which of these you'd like next.