Skip to content

๐ŸŽฎ Discord bot that alerts you when Steam games on your watchlist go on sale. Get instant notifications about price drops.

License

Notifications You must be signed in to change notification settings

AliAlboushama/Steam-Game-Price-Alert

Folders and files

NameName
Last commit message
Last commit date

Latest commit

e2787c6 ยท Mar 4, 2025

History

54 Commits
Mar 3, 2025
Mar 3, 2025
Feb 24, 2025
Mar 4, 2025

Repository files navigation

Steam Game Sale Alert Bot

๐ŸŽฎ Never miss a Steam sale again! This bot monitors your wishlist games and instantly notifies you through Discord when prices drop. Perfect for gamers who want to grab their favorite titles at the best prices.

Features

  • Sale Monitoring: Automatically checks game prices via Steam API hourly
  • Discord Notifications: Sends alerts to your Discord channel when sales are detected
  • User Preferences: Stores country code, language, and Discord webhook settings
  • Game Database: Maintains game information in SQLite
  • Sale Tracking: Prevents duplicate notifications by tracking active sales
  • Scan Multiple Games: Track multiple game sales at once instead of just one per session.
  • Price Target Alerts: Customize notifications for specific price thresholds or any discount
  • Clear Screen System: Automatically refreshes display after each question for better readability

How It Works

  1. Fetches game details from Steam API using the game's app_id
  2. Compares current price with previous price to detect sales
  3. Checks against user-defined price targets when configured
  4. Sends Discord notification with game name, price, discount, and image
  5. Manages notification frequency to prevent Discord webhook rate limiting
  6. Saves sale details to prevent duplicate notifications
  7. Removes games from tracking when sales end
  8. Refreshes interface after each user interaction for better readability

Discord Notification Preview

Here's how the sale notifications appear in your Discord channel:

Discord Notification Preview

The notification includes the game's thumbnail, pricing details, and a direct link to the Steam store page.

Requirements

This project requires Python 3.x and the following packages:

  • requests
  • logging

Installation

  1. Clone the repository:
git clone https://github.com/AliAlboushama/Steam-Game-Price-Alert.git
cd Steam-Game-Price-Alert
  1. Install required package:
pip install requests
pip install logging
  1. Set up Discord webhook:

    • Open Discord server settings
    • Create webhook in desired channel
    • Copy webhook URL
  2. Run the script:

python3 main.py

Usage

First Run Setup

The script will prompt you to enter:

  • Country code (e.g., US, UK)
  • Language code (e.g., en for English)
  • Discord webhook URL
  • Bot name and avatar URL

These settings are saved in user_info.json for future use.

Adding Games

You can add games by providing:

Operation

The script automatically checks for sales hourly and sends Discord notifications when sales are detected.

Configuration

Discord Webhook Setup

  1. Go to Discord server settings
  2. Navigate to Integrations > Webhooks
  3. Create new webhook
  4. Copy URL for script configuration

Bot Customization

You can customize:

  • Bot name
  • Avatar image (via URL)

FAQ

Q: How do I add multiple games?
A: Run the script and select the option to add more games when prompted.

Q: Can I change how often prices are checked?
A: Yes, modify the time.sleep(3600) value in the script to adjust the frequency (in seconds).

Q: Not receiving Discord notifications?
A: Verify your webhook URL is correct and the webhook is enabled in your Discord server.

Contributing

Contributions are welcome! To contribute:

  1. Fork the repository
  2. Create feature branch
  3. Submit pull request with detailed description

License

This project is licensed under the MIT License. See LICENSE file for details.

Support

For issues or questions:

  • Open an issue on GitHub