An api which can use different sites to scrape images and serve them through API
This API can be used for setting daily wallpapers on a mobile device by combining it with an app such as IFTTT
This is an ASGI server built using FastAPI. Here are some PaaS which is supported and you can deploy directly by clicking on the link below.
Or you can install it on your private server, the steps are given below.
This project is written on python. Hence, install python-3.8.6 or later, see runtime.txt
for exact version.
On Ubuntu-18.04 or later
apt-get install -y python3 python3-pip
Install the required packages using pip
pip install -r requirements.txt
Wallpaper website
By default, it's scrapes wallpapers from https://wallpapercave.com. You can configure your desired wallpapers site's url and scraping regex in config.json
Collections
This app uses collections name from collections.txt
to fetch wallpapers from website and this list can be updated (as new collections arriving daily) by running the collection scraper
. It have two modes, add collection from search or automaticaly fetch all collections.
Note: Random wallpaper feature didn't work if collections file is empty so we added some nice collections already. You can remove file and add your own desired collections
python3 scrape_collections.py
This will fetch and update the collection file automatically.
Start the ASGI server using uvicorn
uvicorn main:app
If using a VPS then set the host and port accordingly
uvicorn main:app --host 0.0.0.0 --port 80
Procfile
already exists if you want to deploy it on railway or heroku etc.
Copyright (©) 2022 by Adnan Ahmad. Licensed under the terms of the GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007