How saamy4r/freqtrade_app works
Freqtrade Visualizer is a local-first Rust app for monitoring multiple Freqtrade bots. The user adds or selects a bot, then views open and closed trades, dashboard metrics, price charts, and logs; the UI requests prepared screen payloads from an in-app server, which fetches bot data and serves cached results from SQLite when appropriate. The README documents the major product capabilities and overall HTTP topology; source excerpts clarify key server, client, and storage responsibilities, but not every screen or route implementation.
Main entry points: store.rs SQLite store · screens.rs Screen endpoints · screens Monitoring screens · fetch.rs Cache and fetch
Components 22
Visualizer UI
- App shell
crates/freqtrade/src/app.rs - Monitoring screens
crates/freqtrade/src/screens - Bot management
crates/freqtrade/src/screens/bots.rs - UI API access
crates/freqtrade/src/api.rs - UI state
crates/freqtrade/src/state.rs - Chart rendering
crates/freqtrade/src/components/price_chart.rs - Display formatting
crates/freqtrade/src/format.rs
Local API
- Screen endpoints
crates/ft-server/src/routes/screens.rs - Bot endpoints
crates/ft-server/src/routes/bots.rs - Cache and fetch
crates/ft-server/src/fetch.rs - Metrics computation
crates/ft-server/src/compute.rs - Server state
crates/ft-server/src/state.rs - Background sync
crates/ft-server/src/sync.rs - Live events
crates/ft-server/src/events.rs
Bot integration
- Freqtrade REST client
crates/ft-client/src/client.rs - Token refresh
crates/ft-client/src/auth.rs
Local data
- SQLite store
crates/ft-store/src/store.rs - Credential encryption
crates/ft-store/src/crypto.rs - API data types
crates/ft-types/src/freqtrade.rs - Tolerant parsing
crates/ft-types/src/flex.rs
Other components
- User
- Freqtrade bot
Connections 27
- User → App shell: uses
- App shell → Monitoring screens: routes to
crates/freqtrade/src/app.rs - App shell → Bot management: shows
crates/freqtrade/src/app.rs - Monitoring screens → UI API access: requests data
crates/freqtrade/src/screens/bots.rs - Bot management → UI API access: manages bots
crates/freqtrade/src/screens/bots.rs - Monitoring screens → UI state: reads state
crates/freqtrade/src/screens/open_trades.rs - Monitoring screens → Chart rendering: renders charts
- Chart rendering → Display formatting: formats values
crates/freqtrade/src/components/price_chart.rs - UI API access → Screen endpoints: HTTP requests
- Screen endpoints → Cache and fetch: loads data
crates/ft-server/src/routes/screens.rs - Screen endpoints → Metrics computation: computes metrics
crates/ft-server/src/routes/screens.rs - Screen endpoints → SQLite store: reads and writes
crates/ft-server/src/routes/screens.rs - Bot endpoints → SQLite store: updates bot records
crates/ft-server/src/routes/bots.rs - Cache and fetch → SQLite store: checks cache
crates/ft-server/src/fetch.rs - Cache and fetch → Freqtrade REST client: fetches live data
- Screen endpoints → Server state: uses state
crates/ft-server/src/routes/screens.rs - Server state → SQLite store: loads credentials
crates/ft-server/src/state.rs - Server state → Freqtrade REST client: creates client
crates/ft-server/src/state.rs - Background sync → Cache and fetch: refreshes data
crates/ft-server/src/sync.rs - Background sync → Server state: checks watchers
crates/ft-server/src/sync.rs - Background sync → Live events: publishes changes
crates/ft-server/src/sync.rs - Freqtrade REST client → Token refresh: refreshes tokens
crates/ft-client/src/client.rs - Freqtrade REST client → Freqtrade bot: calls REST API
- SQLite store → Credential encryption: encrypts passwords
crates/ft-store/src/store.rs - SQLite store → API data types: stores payloads
- API data types → Tolerant parsing: uses parsers
crates/ft-types/src/freqtrade.rs - SQLite store → User: keeps data offline