https://github.com/bschelst/steamstatus-decky
Steam Status Decky Plugin
https://github.com/bschelst/steamstatus-decky
decky-loader decky-plugin protondb steam steam-api steamdeck
Last synced: 5 months ago
JSON representation
Steam Status Decky Plugin
- Host: GitHub
- URL: https://github.com/bschelst/steamstatus-decky
- Owner: bschelst
- License: gpl-3.0
- Created: 2026-01-02T14:36:04.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-10T13:28:18.000Z (5 months ago)
- Last Synced: 2026-01-11T03:57:55.999Z (5 months ago)
- Topics: decky-loader, decky-plugin, protondb, steam, steam-api, steamdeck
- Language: TypeScript
- Homepage:
- Size: 1.03 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 🎮 Steam Status
[](https://github.com/bschelst/steamstatus-decky/releases)
[](LICENSE)
[](https://github.com/SteamDeckHomebrew/decky-loader)
Display **real-time Steam status**, player counts, and Steam service health directly on your lovely Steam Deck. 🚀
The plugin aggregates information from official Steam APIs and ProtonDB through a dedicated gateway server, providing reliable status data without requiring a Steam API key. ⚡
---
## ✨ What it does
Steam Status Decky is a Decky plugin which displays real-time information about Steam services, helping you know when Steam is experiencing issues. The plugin shows:
- 👥 **Current player count** - Total users currently logged into Steam
- 🟢 **Service status** - Health of Steam Store, Community, and WebAPI
- 📊 **24-hour player history** - Sparkline graph showing player count trends
- 🌍 **Regional server status** - Status of Steam servers by region
- 🔥 **Trending games** - Top 5 Deck-verified games with biggest player gains
- 🚨 **Outage detection** - Automatic detection and notifications for service outages
---
## 🌐 Gateway & Status Page
This plugin uses a **gateway server** to fetch Steam status data. The gateway aggregates information from official Steam APIs and caches it efficiently, so the plugin doesn't directly hit Steam's servers with every request.
**Why a gateway?**
- Reduces load on Steam's API infrastructure
- Provides consistent, reliable data access
- No Steam API key required for end users
- Enables advanced features like outage tracking and historical data
The gateway is developed, hosted, and maintained by me.
**Live Status Dashboard:** You can view the current Steam status and outage history on the public status page:
🔗 **https://steamstatus.schelstraete.org/status**
---
## 💡 Why did I create this
In December 2025, we experienced several Steam service outages. During my active gaming session, issues were occuring in-game, without any clear indication that Steam itself was experiencing problems.
At the time, we didn't know whether these disruptions were caused by local issues or by a broader Steam service outage. (You know how it goes..."would a reboot resolve our issues").
This led me to realize that it would be (for me) highly beneficial to receive clear notifications when Steam services are experiencing problems, or to be able to view the current status of Steam directly, without having to interrupt gameplay or open a web browser to investigate the issue.
---
## ⚙️ Features & Options
- 📈 **History sparkline**: Visual graph of player counts over the last 24 hours
- 🗺️ **Regional status**: Expandable view of Steam servers by region (US East, US West, EU West, EU East, Asia)
- 🔥 **Trending games**: Top 5 Deck-verified games currently gaining players
- 🔔 **Outage notifications**: Get notified when Steam services go down or recover
- 🛡️ **Anti-flood protection**: Prevents notification spam during gateway or API issues
- 🔍 **Network diagnostics**: Test Steam connection latency and internet speed
- ⏱️ **Configurable refresh interval**: Set automatic refresh from 3-10 minutes, or manual only
- 🔗 **Status page**: View detailed status and outage history at https://steamstatus.schelstraete.org/status
- 📴 **Offline mode**: Displays cached data when the network is unavailable
---
## 📸 Screenshots
---
## 🌐 Translations
The plugin supports localization and will automatically use Steam's language setting.
I used Google translate (is that AI or isn't it..) for the translations, so the translation could be compleeeeetely wrong ;)
Pull requests for new translations are welcome. 🙏
---
## ✅ Compatibility & Testing
Tested on:
- **SteamOS 3.9** - Steam Deck LCD - Decky Loader v3.2.1
Steam Deck OLED has not been tested yet.
---
## 💖 Sponsoring
If you find this plugin useful and want to support its continued development, you can sponsor me. ☕
The gateway server infrastructure has ongoing hosting costs, and your support helps keep it running and available for everyone.
Your support helps with:
- 🖥️ Gateway server hosting and maintenance
- 🔧 Bug fixes and plugin improvements
- ✨ New features and enhancements
- 🚀 Ability to develop new plugins
### Support the project
- 💜 **GitHub Sponsors**
https://github.com/sponsors/bschelst
- ☕ **Ko-fi**
https://ko-fi.com/bschelst
- ☕ **Buy Me a Coffee**
https://www.buymeacoffee.com/bschelst
---
## 📋 Requirements
- Steam Deck or Linux PC/Bazzite using Steam Big Picture
- Decky Loader installed
Decky Loader:
https://github.com/SteamDeckHomebrew/decky-loader
---
## 📥 Installation (Decky Loader)
> ⚠️ The plugin is not available in the Decky Store **yet** and must be installed manually.
1. 📦 Download the **latest `.zip` release**:
https://github.com/bschelst/steamstatus-decky/releases
2. 🎮 Open **Game Mode** and launch **Decky Loader**.
3. 🔓 Enable developer mode in Decky Loader if not enabled yet.
4. ⚙️ Go to **Decky Settings > Plugins > Install from ZIP**.
5. ✅ Select the downloaded `steamstatus-decky-.zip`.
6. 🔄 Restart Steam client.
The Steam status panel will appear in the Decky quick access menu. 🎉
### 🔄 Updating
To update, install the latest ZIP via Decky Loader.
Existing settings are preserved. ✨
---
## ⚠️ Disclaimer
This plugin is an independent, community-developed project and is **not affiliated with, endorsed by, or sponsored by Valve Corporation** or Steam.
Steam and the Steam logo are trademarks and/or registered trademarks of Valve Corporation in the U.S. and/or other countries.
All Steam status data is provided for informational purposes only.
---