ItchSaleSentry is a Python script that autonomously tracks and notifies users of items, including games and more, on the Itch.io platform when they become temporarily available for free due to limited-time sales or discounts, consistently reaching a 100% discount. Stay updated on the latest opportunities with automated Discord notifications, brought to you by ItchSaleSentry.
- Data Source
- Acknowledgment
- Table of Contents
- Installation
- Configuration
- Dependencies
- Usage
- Contributing
- License
The script tracks data from freetchio, a website dedicated to providing information about free items on Itch.io.
Special thanks to ShaigroRB for making the data source publicly accessible, enabling the project to track Itch.io items.
Ensure you have Python installed on your system. You can download and install Python from the official website. Make sure to check the box that says "Add Python to PATH" during installation.
- Clone the repository:
git clone https://github.com/xAbdoAT/Itch-Sale-Sentry.git
- Install the required dependencies:
pip install -r requirements.txt
To configure ItchSaleSentry, follow these steps:
-
Open the
config.json
file. -
Customize the configuration based on your preferences:
-
webhook_name
: The name to display for your Discord webhook. (Optional) -
webhook_image
: The image URL to display for your Discord webhook. (Optional) -
track_url
: The URL of the JSON file containing the items to track. (Recommended not to change unless you have a specific JSON file you want to use.) -
webhook_url
: Replace "YOUR_DISCORD_WEBHOOK_URL" with the actual Discord webhook URL you want to use for notifications.
-
This step ensures that the script is tailored to your preferences and connected to the correct Discord webhook for notifications. Adjust the values accordingly to match your desired setup.
ItchSaleSentry relies on the following external libraries. You can install them manually or use the pip install -r requirements.txt
command:
- discord-webhook:
pip install discord-webhook
- requests:
pip install requests
Make sure to install these dependencies to ensure the proper functioning of ItchSaleSentry. If you prefer, you can also use the pip install -r requirements.txt command to install all dependencies at once.
-
Run the script by executing the following command:
python main.py
The script will start tracking Itch.io for free items and send Discord notifications for new discoveries.
If you would like to contribute to this project, feel free to fork the repository and submit pull requests.
This project is licensed under the MIT License.