Python-based IWantClips scraper for Stash
This is a Python scraper, and as such, Python (Python3) needs to be installed.
- The official Stash docker container already contains python and all needed modules.
- For Windows systems, install python from python.org (instructions), NOT from the Windows store.
- For Linux systems please consult the relevant distro instructions.
- For Μac systems either use homebrew eg
brew install python3
or use the python.org installer (instructions)
- bs4
- lxml
- requests
- Working search functionality utilising IWC's Algolia search API.
- Dynamic selection of best-available thumbnail image, favouring still images over animated GIFs (still needs some tweaking).
- No dependency on a Chrome CDP.
- Tested with a few dozen clips and haven't encountered any major bugs, but caveat emptor.
I'd like to thank the writers of the following scrapers on the CommunityScrapers git repository - their code has proven very useful in helping this come together:
- bnkai, who wrote the ManyVids Python scraper: https://github.com/stashapp/CommunityScrapers/commits/master/scrapers/ManyVids
- estellaarrieta, who wrote the WowNetworkVenus Python scraper, from which I managed to work out a lot about the structure of Python scrapers, etc.
Also, mention has to go to ChatGPT, without which I wouldn't have been able to fumble blindly through this project.