How antonioalvromero/ocarina-atlas works
Ocarina Atlas combines a browser-based Hyrule atlas and dungeon tracker with Windows/Linux desktop launchers. Players browse places, inspect map items, record progress, and optionally synchronize collectible telemetry from supported games or across LAN devices. The launcher starts the local map service; the browser routes into atlas views backed by game data and persistent state. The README documents several telemetry integrations and launcher behaviors beyond the sampled implementation, so those connections are shown as documented or unverified where appropriate.
Main entry points: PlaceView.tsx Place view · data.ts Game dataset · MainForm.cs Windows launcher · $zone.tsx Atlas routes
Components 26
Desktop launchers
- Windows launcher
launcher/win/MainForm.cs - Windows entry
launcher/OcarinaAtlas.cs - Linux launcher
launcher/linux-appimage/main.cjs
Atlas experience
- Map server
src/lib/lichii-server.ts - Atlas routes
src/routes/$zone.tsx - Place view
src/components/PlaceView.tsx - World map
src/components/WorldMap.tsx - Map viewport
src/components/MapViewport.tsx - Atlas panels
src/components/Panels.tsx - Quick search
src/components/QuickSearchModal.tsx - Tracker panel
src/components/LichiiStatusPanel.tsx
Game data and progress
- Game dataset
src/lib/data.ts - Game adapter
src/lib/game-adapter.ts - Atlas search
src/lib/search.ts - Prerequisites
src/lib/prerequisites.ts - Localization
src/lib/i18n.ts - Locale bundles
src/lib/i18n/types.ts
Live telemetry
- Telemetry tracker
src/lib/useLichiiTracker.ts - Telemetry server
src/lib/lichii-server.ts - RPC client
src/lib/lichii/rpc-client.ts - Save parser
src/lib/lichii/save-parser.ts
Persistence and sync
- Progress storage
src/lib/storage.ts - LAN sync server
src/lib/sync-server.ts
Other components
- Player
- Game or emulator
- Second-screen device
Connections 28
- Player → Windows launcher: starts map
- Windows launcher → Windows entry: runs
launcher/OcarinaAtlas.cs - Windows launcher → Map server: starts server
- Player → Linux launcher: starts map
- Linux launcher → Map server: starts server
- Player → Atlas routes: opens place
- Atlas routes → Place view: renders
src/routes/$zone.tsx - Atlas routes → Game dataset: finds place
src/routes/$zone.tsx - Player → World map: browses atlas
- Place view → Map viewport: renders
src/components/PlaceView.tsx - Place view → Atlas panels: renders
src/components/PlaceView.tsx - Place view → Tracker panel: renders
src/components/PlaceView.tsx - Place view → Game dataset: reads places
src/components/PlaceView.tsx - Place view → Progress storage: reads and writes
src/components/PlaceView.tsx - Player → Quick search: searches atlas
- Quick search → Atlas search: queries
src/components/QuickSearchModal.tsx - Atlas search → Game dataset: searches data
src/lib/search.ts - Game dataset → Game adapter: uses
src/lib/data.ts - Atlas panels → Prerequisites: checks prerequisites
src/components/Panels.tsx - Place view → Localization: translates view
src/components/PlaceView.tsx - Localization → Locale bundles: loads locale types
src/lib/i18n.ts - Game or emulator → RPC client: serves telemetry
- Telemetry server → RPC client: requests telemetry
- Telemetry server → Save parser: parses saves
- Telemetry tracker → Progress storage: records progress
src/lib/useLichiiTracker.ts - Tracker panel → Telemetry tracker: shows status
src/components/LichiiStatusPanel.tsx - Progress storage → LAN sync server: syncs state
- Second-screen device → Map server: opens LAN map