Refurbished Steam Deck Notifier

This script checks the availability of refurbished Steam Decks on Steam and sends notifications to a specified Discord webhook. It queries Steam's API and compares the current stock status with previously stored values.

🚀 Features

• Checks the availability of refurbished Steam Decks for a configurable country
• Sends notifications via a Discord webhook when stock availability changes
• Supports different Steam Deck models (LCD & OLED versions)
• Prevents duplicate notifications by storing the last known stock status
• Optional CSV logging for availability statistics
• Configurable Discord role pings via JSON file
• Command-line arguments for easy configuration
• Prebuilt executables for users who don’t want to install Python

📋 Requirements (for Python script users)

Install Dependencies

Ensure you have Python 3.x installed. Then, install the required dependencies using:

pip install requests discord-webhook

🛠 Setup & Usage

Option 1: Use the Prebuilt Executable (No Python Needed)

Download the prebuilt executable for your platform (Windows, Linux, etc.). The file is typically named:

steam_deck_notifier.exe (Windows)
steam_deck_notifier (Linux/macOS)

How to Run

Run it via terminal/command prompt:

./steam_deck_notifier --webhook-url "https://discord.com/api/webhooks/YOUR_WEBHOOK"

You can pass the same arguments as you would for the Python version.

Option 2: Run the Python Script

python steam_deck_checker.py --webhook-url "https://discord.com/api/webhooks/YOUR_WEBHOOK"

Command Line Arguments

• -h: Provides list of possible Arguments
• --webhook-url: Discord webhook URL for notifications (required)
• --country-code: Country code for Steam API (default: DE, important)
• --role-mapping: JSON file containing Discord role mappings (optional)
• --csv-dir: Directory path for daily CSV log files (optional)

Full Example

python steam_deck_checker.py \
  --country-code US \
  --webhook-url "https://discord.com/api/webhooks/YOUR_WEBHOOK" \
  --role-mapping roles.json \
  --csv-dir csv-logs

Discord Role Mapping (Optional)

Create a roles.json file like this to ping specific Discord roles when stock is available:

{
  "903905": "1343233406791716875",
  "903906": "1343233552896229508",
  "903907": "1343233731795881994",
  "1202542": "1343233909655343234",
  "1202547": "1343234052957802670"
}

Format: "package_id": "discord_role_id"

Country Codes

Find valid country codes here

💪 Steam Deck Models Monitored

The script checks availability for these models:

• 64GB LCD (Package ID: 903905)
• 256GB LCD (Package ID: 903906)
• 512GB LCD (Package ID: 903907)
• 512GB OLED (Package ID: 1202542)
• 1TB OLED (Package ID: 1202547)

🔧 How It Works

1. Requests stock status for Steam Deck models via Steam’s API
2. Compares new status with the last known state stored in text files
3. Sends a Discord notification if availability changes
4. Optionally pings configured roles via roles.json
5. Optionally logs the check results to a CSV file

📊 CSV Logging

When using --csv-dir, the script writes one CSV file for each day to the specified directory, with these fields:

• unix_timestamp: Time of check
• storage_gb: 64, 256, 512, or 1024
• display_type: LCD or OLED
• package_id: Steam product identifier
• available: True or False

⏲️ Running Periodically

This script/executable does not run continuously. Use cron (Linux/macOS) or Task Scheduler (Windows) to automate execution.

Example (Linux/macOS)

Edit your crontab with:

crontab -e

Add this line to check every 3 minutes:

*/3 * * * * /path/to/steam_deck_notifier --webhook-url "YOUR_WEBHOOK" >> /path/to/logfile.log 2>&1

📦 Dependencies & Attribution

This project uses the excellent python-discord-webhook library by lovvskillz Licensed under the MIT License.

It also makes use of Valve’s public Steam Store API — specifically the
CheckInventoryAvailableByPackage endpoint (documentation). Data and trademarks belong to Valve Corporation, owners of Steam and Steam Deck.

Big thanks to all contributors and maintainers of the open-source packages used in this project.

❤️ Support

If this project helps you, consider supporting via Ko-fi

🥇 Special Thanks

Huge thanks to leo-petrucci for helping improve the codebase and guiding proper Steam API usage!