Skip to main content

snipp-gg/ShadowPlay

snipp-shadowplay

​
Installation

pip install snipp-shadowplay
Requires Python 3.9 or later. Dependencies: watchdog, requests, pyperclip, colorama.

​
Configuration

  1. Get your API Key: Visit the Snipp Console and generate a key.
  2. Set your API Key as an environment variable: 
setx SNIPP_API_KEY YOUR_API_KEY

​
Getting started

Once installed and configured, run: 
snipp
The watcher monitors your ~/Videos folder for new .mp4 files. When a clip is saved by ShadowPlay, it is automatically uploaded to Snipp and the shareable URL is copied to your clipboard.

​
How it works

  1. File detection — Watches the ~/Videos directory (recursively) using watchdog for new .mp4 files.
  2. Completion wait — Waits for the file to finish being written to disk before uploading.
  3. Upload — Sends the clip to the Snipp API as a multipart upload with unlisted privacy.
  4. Clipboard — Copies the returned URL to your clipboard via pyperclip.

​
Limits

  • Maximum file size: 1 GB
  • Supported format: .mp4
  • Privacy: uploads default to unlisted

​
Error handling

Errors are printed to the console with colour-coded messages:
ColourMeaning
BlueInformational (startup, file detected)
YellowWarnings (file still processing)
GreenSuccess (uploaded with URL)
RedErrors (upload failed, file too large)