Sentinel

An achievement watcher for Steam emulator games on Linux

Sentinel monitors your Steam emulator save files and sends real-time desktop notifications when achievements are unlocked or progress is updated. It also serves as a library viewer with completion stats, global achievement percentages, and more.

---

Features

• Real-time desktop notifications
• Progress tracking for multi-step achievements
• Game library with completion stats and sorting
• Global achievement percentages from Steam API
• Custom notification sounds (10 platform-themed options)
• System tray support (runs in background)
• Choice of Steam Web API key or free external data source (SteamHunters)

Screenshots

In Game

WB Games - Middle Earth: Shadow of Mordor

Dashboard

Achievement Details

Settings

Installation

System Requirements

• GTK 4 (libgtk-4-1)
• WebKitGTK 6.0 (libwebkitgtk-6.0-4)
• libnotify (libnotify-bin)

Linux Packages

Download the latest release from GitHub Releases.

Debian/Ubuntu (.deb):

sudo dpkg -i sentinel.deb

Fedora/RHEL (.rpm):

sudo dnf install sentinel.rpm

Arch Linux:

sudo pacman -U sentinel.pkg.tar.zst

Quick Start

1. Configure Prefix Paths — Add your Wine/Proton prefix directories where emulated games are installed
2. Configure Emulator Paths — Add paths to emulator save directories (default: AppData/Roaming/GSE Saves)
3. Choose Data Source — Use a Steam API key for faster data, or the free external source

Sentinel will automatically scan for games and watch for achievement changes as long as it is running in the system tray.

Configuration

Config file location: ~/.cache/sentinel/config.json

Logs are written to ~/.cache/sentinel/logs/sentinel.log. Enable logging from the Settings menu.

FAQ

What emulators are supported?

Any emulator that writes achievements.json files in a GSE Saves directory structure. This includes Goldberg Steam Emulator

Do I need a Steam API key?

No, Sentinel defaults to using SteamHunters and Steam Community pages as a free data source. A Steam Web API key is advisable and provides faster, and more reliable data.

Why aren't notifications showing?

• Ensure you have lib-notify installed. Running notify-send shouldn't return command
• Check that your desktop environment supports D-Bus notifications
• Verify Notifications are enabled for your prefix paths in Settings

Can I use this on Windows or macOS?

Short answer - No. Sentinel is Linux-first. It is technically possible to have a Windows build, where is the fun in that

How do I add a new game after setup?

Sentinel automatically rescans prefix directories every few seconds. New games appear in the library automatically.

Is there a plan to support SteamDeck/Decky Loader Plugin.

Yes.

Acknowledgments

• Achievement Watcher - Inspiration
• Goldberg Emulator - Compatibility

License

MIT

Legal

⚠️ Software provided here is purely for informational purposes and does not provide nor encourage illegal access to copyrighted material.

This software is provided "as is" without warranty of any kind. The authors accept no liability for any damages or issues arising from its use.

This project is not affiliated with, endorsed by, or associated with Valve Corporation, Steam, or any other trademark owners. Achievement data is fetched from publicly available Steam APIs and third-party sources.

All trademarks mentioned are the property of their respective owners.