How poli0981/frameledger works
FrameLedger is a local-first Windows game-performance ledger. The user adds or imports games, launches or plays them, and the background Agent records eligible sessions; the desktop app then presents session history and comparisons as charts and supports export. Distinct product stages include library management and detection, safety/consent gating, capture and telemetry, local persistence, and analysis. The README documents the main workflow and measured capabilities; sampled source confirms selected Agent, persistence, and export details, so unsampled feature links are limited to documented relationships.
Main entry points: SqliteSessionRepository.cs Session records · Program.cs Background Agent · Capture Session capture · GameRow.cs Game records
Components 23
Library and launch
- Desktop app
src/FrameLedger.App/App.xaml.cs - Game library
src/FrameLedger.App/Pages/GamesPage.xaml.cs - Store import
src/FrameLedger.App/Services/ImportLibraryFlow.cs - Game detection
src/FrameLedger.Agent/Hosting/DetectionHostedService.cs
Safe capture
- Background Agent
src/FrameLedger.Agent/Program.cs - Safety and consent
src/FrameLedger.Application/AntiCheat - Session capture
src/FrameLedger.Application/Capture - Performance telemetry
src/FrameLedger.CaptureHost/Telemetry/AdvancedProbe.cs
Local ledger
- Consent records
src/FrameLedger.Infrastructure/Persistence/SqliteGameConsentStore.cs - Game records
src/FrameLedger.Application/Persistence/GameRow.cs - Session records
src/FrameLedger.Infrastructure/Persistence/SqliteSessionRepository.cs - SQLite ledger
src/FrameLedger.Infrastructure/Persistence/LedgerDatabase.cs
Review and analysis
- Advanced metrics
src/FrameLedger.Application/Advanced - Dashboard
src/FrameLedger.App/Pages/DashboardPage.xaml.cs - Session charts
src/FrameLedger.App/Charts/SessionSeriesLoader.cs - Session comparison
src/FrameLedger.App/Pages/ComparePage.xaml.cs - Advanced review
src/FrameLedger.App/Pages/AdvancedPage.xaml.cs - Session export
src/FrameLedger.App/Services/SessionExportService.cs
App services
- Settings and safety UI
src/FrameLedger.App/Pages/SettingsPage.xaml.cs - App updates
src/FrameLedger.App/Update/UpdateService.cs
Other components
- Player
- Tracked game
- Game stores
Connections 22
- Player → Desktop app: uses
README.md - Player → Game library: manages games
README.md - Game stores → Store import: provides library
README.md - Store import → Game records: imports games
README.md - Game library → Tracked game: selects game
README.md - Game detection → Game records: updates metadata
src/FrameLedger.Agent/Hosting/DetectionHostedService.cs - Background Agent → Game records: watches library
src/FrameLedger.Agent/Program.cs - Background Agent → Safety and consent: checks capture safety
README.md - Background Agent → Session capture: records session
src/FrameLedger.Agent/Program.cs - Session capture → Performance telemetry: collects metrics
README.md - Session capture → Session records: writes session
README.md - Safety and consent → Consent records: checks consent
README.md - Session records → SQLite ledger: persists through
src/FrameLedger.Infrastructure/Persistence/SqliteSessionRepository.cs - Player → Dashboard: reviews history
README.md - Dashboard → Session records: reads history
README.md - Session records → Session charts: supplies session data
- Session charts → Session comparison: supports comparison
README.md - Session records → Advanced metrics: stores telemetry
README.md - Advanced metrics → Advanced review: feeds review
README.md - Session records → Session export: provides export data
src/FrameLedger.App/Services/SessionExportService.cs - Player → Settings and safety UI: configures safety
README.md - Desktop app → App updates: checks updates