Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.snipp.gg/llms.txt

Use this file to discover all available pages before exploring further.

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. Generate a key from your account settings.
  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 color-coded messages:
ColorMeaning
BlueInformational (startup, file detected)
YellowWarnings (file still processing)
GreenSuccess (uploaded with URL)
RedErrors (upload failed, file too large)