Skip to main content

SteamLogger

Every Steam session — with friends, lobby, server and map — logged to JSON

A single-binary Rust daemon that polls the Steam Web API, detects when a game starts and stops, and records each session — plus who you played with and where — into one atomically written JSON file.

Read the docsQuickstartCode reference
steamlog.json
{
  "games": [
    {
      "name": "Team Fortress 2",
      "start": "2026-08-10T14:32:15-03:00",
      "end": "2026-08-10T16:47:03-03:00",
      "map": "cp_dustbowl",
      "server": "Team Fortress 2 #42",
      "friends_playing": ["medicmain99"],
      "friends_in_lobby": ["medicmain99"]
    }
  ]
}

Session tracking that survives restarts

A small state machine turns a stream of polls into start/switch/end events. Restart mid-game and the open session (end: null) is picked up where it left off instead of being duplicated.

Friends, lobby, server and map

Optional enrichment answers who else was online in the same game, who shared your exact lobby, and which server and map you were on — via the Steam Web API plus a direct A2S_INFO query.

Degrades instead of failing

Every enrichment source is best effort. If Steam is down or the server never answers, the base name/start/end log is still written — atomically, on every poll.

Documented down to the last public item

The code reference covers all nine modules: every public struct, enum, and function with its signature, behaviour, errors, and the tests that pin it down.

Plain JSON you already know how to query

One steamlog.json file, one documented schema, no database. Pipe it through jq for playtime totals or import it anywhere.

Tested without touching the network

Unit and integration tests cover config loading, API parsing, the A2S protocol (against a loopback UDP server), the state machine, and atomic persistence.

Up and running in three commands

Copy the example config, drop in your Steam Web API key and SteamID64, then let it poll. Everything else has a sensible default.

Installation guide
cp steamlogger.example.toml steamlogger.toml
$EDITOR steamlogger.toml      # api_key + steam_id
cargo run --release           # Ctrl+C to stop