Automatic image uploader for Litterbox — watches a folder, uploads instantly, copies the link.
Built by Killoxs as an open-source desktop utility for anyone who screenshots, saves, or exports images and wants a shareable link without lifting a finger.
Drop an image into your watched folder — LitterWatch detects it, uploads it to Litterbox in the background, and copies the URL straight to your clipboard. No browser, no drag-and-drop, no manual steps.
- Monitors any local folder for new image files
- Uploads silently using Python's built-in networking (no
curl, no terminal popups) - Copies the Litterbox link to clipboard the moment it's ready
- Lets you choose how long the file lives: 1h / 12h / 24h / 72h
- Shows a live log with colour-coded status per upload
- Retries automatically on failure with WAF-aware backoff
- Windows 10 / 11
- Python 3.10 or later — python.org
Don't want to deal with Python or building anything? Grab the latest pre-built release:
⬇ Download KilloxsLitterbox.exe — Latest Release
Just download, double-click, and run. No Python, no install, no setup.
The exe is built from the source in this repo using PyInstaller. You can verify this yourself by running
build.bat.
git clone https://github.com/killoxs/litterwatch.git
cd litterwatch
py -m pip install watchdog pyperclip
py killoxs_litterbox.pyIf you want a single executable with no Python dependency:
- Put
killoxs_litterbox.pyandbuild.batin the same folder - Double-click
build.bat - Your exe will appear at
dist\KilloxsLitterbox.exe
The build script handles installing PyInstaller and bundling everything automatically.
- Launch the app
- Click BROWSE and pick the folder you want to monitor
- Select an expiry duration (default: 72h)
- Click ▶ START
From this point, any image saved into that folder is uploaded automatically. The link is copied to your clipboard and logged in the event panel.
To stop, click ■ STOP or close the window.
.png .jpg .jpeg .gif .bmp .webp
LitterWatch uses Python's built-in urllib to POST directly to the Litterbox API — no curl, no subprocess, no command window ever appears. Uploads include browser-like headers to pass Litterbox's WAF layer (BunkerWeb). On failure it retries up to 5 times with increasing delays.
litterwatch/
├── killoxs_litterbox.py # main application
├── build.bat # one-click Windows exe builder
└── README.md
| Package | Purpose |
|---|---|
| watchdog | Folder monitoring |
| pyperclip | Clipboard access |
Both are pip-installable. The rest of the app uses Python's standard library only.
MIT License — free to use, modify, and distribute.
Made by Killoxs · hello@killoxs.com · 2026