How bun2it/romcloud works
RomCloud is a native handheld app for managing a cloud-backed ROM library. The main flow is user interaction through the SDL UI, Google account linking, Drive library discovery and metadata indexing, then queued downloads into local storage with integrity checks. The README also documents OTA updates and launcher integration; sampled source and the SOURCE INDEX reveal additional app areas such as IPTV, LocalSend, calendar, and device services. Some subsystem links are documented or indexed rather than visible in full source excerpts, so uncertain wiring is omitted.
Main entry points: UIManager.cpp SDL interface · DatabaseManager.cpp ROM metadata · DownloadManager.cpp ROM downloads · HttpClient.cpp HTTP transport
Components 23
App and UI
- Application lifecycle
src/app/Application.cpp - SDL interface
src/ui/UIManager.cpp
ROM Library
- Google sign-in
src/auth/AuthManager.cpp - Drive sync
src/sync/DriveSyncEngine.cpp - ROM metadata
src/database/DatabaseManager.cpp - ROM downloads
src/download/DownloadManager.cpp - Local storage
src/filesystem/FileSystemManager.cpp - ROM indexing
src/database/RomIndexer.cpp
Device Services
- OTA updates
src/ota/UpdateManager.cpp - IPTV player
src/iptv/IPTVManager.cpp - Media playback
src/media/MpvPlayer.cpp - LocalSend transfer
src/localsend/LocalSendManager.cpp - Calendar and clock
src/calendar/CalManager.cpp - Weather
src/weather/WeatherManager.cpp
Platform Foundation
- HTTP transport
src/network/HttpClient.cpp - App configuration
src/config/AppConfig.cpp - Device input
src/input/InputManager.cpp - Platform detection
src/platform/PlatformInfo.cpp - Logging
src/logging/Logger.cpp
Other components
- Handheld user
- Google Drive
- GitHub releases
- TrimUI device
Connections 31
- Handheld user → SDL interface: uses
- SDL interface → Google sign-in: starts linking
- Google sign-in → HTTP transport: sends requests
src/auth/AuthManager.cpp - Google sign-in → ROM metadata: loads credentials
src/auth/AuthManager.cpp - Google sign-in → Google Drive: authorizes access
- SDL interface → Drive sync: starts sync
- Drive sync → HTTP transport: fetches Drive data
src/sync/DriveSyncEngine.cpp - Drive sync → Google Drive: discovers ROMs
- Drive sync → ROM metadata: updates metadata
- SDL interface → ROM metadata: reads library
- SDL interface → ROM downloads: queues ROM
src/ui/UIManager.cpp - ROM downloads → HTTP transport: downloads blocks
src/download/DownloadManager.cpp - ROM downloads → Local storage: writes ROM
src/download/DownloadManager.cpp - ROM downloads → ROM metadata: updates state
- ROM downloads → Google Drive: retrieves ROM
- ROM indexing → ROM metadata: indexes records
- SDL interface → OTA updates: offers updates
- OTA updates → HTTP transport: fetches release
src/ota/UpdateManager.cpp - OTA updates → GitHub releases: checks releases
- SDL interface → IPTV player: controls IPTV
src/ui/UIManager.cpp - IPTV player → Media playback: starts playback
src/iptv/IPTVManager.cpp - IPTV player → HTTP transport: fetches streams
src/iptv/IPTVManager.cpp - SDL interface → LocalSend transfer: controls transfers
src/ui/UIManager.cpp - SDL interface → Calendar and clock: shows calendar
- SDL interface → Weather: shows weather
- Application lifecycle → SDL interface: runs interface
- Application lifecycle → ROM metadata: initializes store
- App configuration → Local storage: configures paths
- Device input → TrimUI device: reads controls
- Platform detection → TrimUI device: detects hardware
- Logging → Local storage: writes logs