@ff-tracker/watcher
v0.1.8
Published
Local save file watcher for FF Tracker — monitors Final Fantasy Pixel Remaster saves and pushes state to the web dashboard
Maintainers
Readme
@ff-tracker/watcher
Local save file watcher for FF Tracker. Monitors Final Fantasy Pixel Remaster save files on Steam and pushes game state to the web dashboard in real time.
Installation
npm install -g @ff-tracker/watcherOr run without installing:
npx @ff-tracker/watcher <game-id>Usage
ff-tracker-watcher ff6Supported game IDs: ff6 (more coming soon)
On startup, the watcher prints a session ID and dashboard URL. Open the URL in your browser to see your game progress update live as you play.
Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| FF_TRACKER_API | https://ff-tracker-eta.vercel.app | Dashboard API endpoint |
Requirements
- Node.js 18+
- A supported Final Fantasy Pixel Remaster game installed on Steam
- Game must have been saved at least once
How It Works
- Auto-detects the save directory from Steam's
libraryfolders.vdf - Watches for save file changes using filesystem polling (2s interval)
- Decrypts and parses save files (Rijndael-256 CBC + DEFLATE)
- Diffs the new state against the previous state
- POSTs changes to the FF Tracker dashboard API
Dashboard
View your progress at ff-tracker-eta.vercel.app
