pixiv-monitor is a Python script for monitoring Pixiv artist galleries, so you can stay up-to-date on your favorite anime pictures.
It even has RSS support. It's pretty basic, but works.
- Make sure you have Python 3 on your computer
- Clone the repository
- Install the dependencies:
pip install -r requirements.txt
- Done
Before running the script (main.py
), you'll need to configure it as described below.
Before using pixiv-monitor, you have to configure it.
First copy settings-example.json
as settings.json
. In the settings.json
file, you'll need to set a few options:
artist_ids
: A list of IDs of the artists whose galleries you want to monitor.check_interval
: How often to check, in seconds.notifications_off
: Enable this option to disable system notifications.num_threads
: Number of threads to use to check for artists. More threads speeds up the process, especially if you monitor many artists. Make sure you don't set it too high or the script (and possibly your system) might break.email
: Whether to enable email notifications.
Next you'll need to configure authentication as describe below.
Copy .env.example
as .env
and set the ACCESS_TOKEN
and REFRESH_TOKEN
. These are your Pixiv API tokens.
The .env
file should now look like this:
ACCESS_TOKEN=your-access-token
REFRESH_TOKEN=your-refresh-token
These are entirely optional if you don't want to use email notifications.
mail_host
: The SMTP host server.address
is the SMTP host address,port
is the port.from_address
: What address the emails will be sent from.to_address
: What address the emails will be sent to.credentials
: Your login and password for the email host server.
To get system notifications to work, you'll need to install some stuff depending on your OS.
You'll need to install the python dbus package. Commands for the most common distros:
sudo apt install -y python3-dbus # debian and ubuntu
sudo dnf install -y python3-dbus # fedora red hat
sudo pacman -S python-dbus # arch btw
sudo zypper install python3-dbus # opensuse (option 1)
sudo zypper install dbus-1-python # opensuse (option 2)
If nothing works, you can try using the pip package:
pip install dbus-python
Install win10toast-click
:
pip install win10toast-click
notifications will work now
and yeah it only works on windows 10+ but lowkey you shouldn't be using anything older if ur on windows
To add RSS, simply run rssmain.py
alongside main.py
. It will automatically create the RSS file (pixiv.atom
), which can then either be accessed locally or served using an HTTP server.