Installing catlog

Five minutes, one file, no account linking.

1. Sign in and claim a handle

Sign in with Discord, Google or GitHub, then claim a handle on your dashboard. The handle is the name that appears on the leaderboards. It is permanent, and it is never recycled to anybody else.

2. Download your credential

Claiming a handle generates an ECDSA P-256 key pair in your browser and downloads catlog-credential.json. It looks like this: 

{
  "format": 1,
  "handle": "whiskers_prime",
  "license": "eyJhbGciOiJFUzI1NiIs…",
  "private_key_pem": "-----BEGIN PRIVATE KEY-----\n…\n-----END PRIVATE KEY-----\n"
}

The private key never leaves your browser — catlog only ever receives the public half, so it cannot send you a second copy of this file. Keep it; if you lose it, reissue the credential from the dashboard, which mints a new key and revokes the old one.

3. Drop it next to the mod

Install the mod, then put the file at:

<KSA user dir>/mods/catlog/credential.json

The mod reads the handle and expiry out of the license and refuses to ship anything if the file's key does not match the license it came with.

4. Fly

That is it. The mod batches events locally and ships them to https://catlog.science.fail/v1/ingest. If the server is unreachable it keeps them in a local outbox and catches up later; nothing is lost because you played offline.

What gets sent

Flight events — launches, situation changes, orbits, sphere-of-influence crossings, dockings, stagings, impacts, rapid unscheduled disassemblies, kitten EVAs and tumbles — plus 30-second windowed telemetry summaries (minimum, maximum, mean, last) rather than a raw sample firehose.

Not sent: your save files, your craft files, your screenshots, your IP-derived location, and your email address, which catlog never receives at all. See privacy.

Flagged flights

The mod reports when a flight used a teleport, a refuel, a resource edit, the console, or a live tuning edit. Those flights are stored, and they score on no leaderboard, never appear in the live feed and are absent from every event log — including your own. catlog would rather record the truth than pretend it did not happen; it just does not publish a list of who tripped which flag. See privacy.