How mahadsaqib24-png/dsa-project-echo-engine-terminal-based-media-engine-.mp3-player- works
Echo Engine is a C++98 terminal music player. A user starts the app, authenticates, then browses or searches the library, manages playlists and the Up Next queue, and opens the player; playback updates listening history. The README also documents automatic music import, uploads, rescan, themes, and animated queue/history views. The graph preserves those major capabilities, but several links are supported by README descriptions rather than sampled call sites; unsampled implementation details are not inferred.
Main entry points: MediaPlayerApp.cpp App Controller · PlayerEngine.cpp Live Player · PlaybackManager.h Playback Manager · LibraryIndex.h Music Library
Components 20
Application Flow
- App Controller
MediaPlayerApp.cpp - Dashboard UI
Dashboard.cpp
Music Catalog
- App Paths
AppPaths.h - Music Library
LibraryIndex.h - File And Text Helpers
FileUtils.h - Song Data
Structs.h - Music Files
Playback
- Up Next Queue
SongQueue.h - Listening History
HistoryStack.h - Playback Manager
PlaybackManager.h - Live Player
PlayerEngine.cpp - Audio Backend
AudioPlayer.h - External Audio Tools
Accounts And Playlists
- Playlist Collection
PlaylistCollection.h - Playlist Engine
PlaylistEngine.h - User Accounts
UserList.h - App Data Files
Terminal Experience
- Player And Data Animations
animations.cpp - Themes And Terminal
colours.cpp
Other components
- Listener
Connections 29
- Listener → App Controller: uses
README.md - App Controller → Dashboard UI: shows menus
README.md - App Controller → Music Library: searches and browses
README.md - App Controller → Playlist Collection: manages
README.md - App Controller → Playback Manager: manages queue and history
- App Controller → Live Player: opens session
README.md - App Controller → User Accounts: authenticates
README.md - App Controller → App Paths: uses paths
MediaPlayerApp.cpp - App Controller → Music Files: imports and rescans
README.md - App Controller → App Data Files: loads and saves
README.md - Music Library → File And Text Helpers: parses records
LibraryIndex.h - Music Library → Song Data: indexes songs
LibraryIndex.h - Playlist Collection → Playlist Engine: owns playlists
PlaylistCollection.h - Playlist Engine → File And Text Helpers: parses and serializes
PlaylistEngine.h - Playlist Engine → Song Data: stores tracks
PlaylistEngine.h - User Accounts → File And Text Helpers: reads account data
UserList.h - User Accounts → App Data Files: loads and appends
- Playback Manager → Up Next Queue: delegates queue
PlaybackManager.h - Playback Manager → Listening History: delegates history
PlaybackManager.h - Playback Manager → User Accounts: delegates accounts
PlaybackManager.h - Live Player → Playlist Collection: reads active playlist
- Live Player → Playback Manager: uses queue and history
- Live Player → Music Library: uses library
- Live Player → Audio Backend: controls playback
- Audio Backend → Music Files: locates tracks
AudioPlayer.h - Audio Backend → External Audio Tools: dispatches playback
- Dashboard UI → Player And Data Animations: renders animated views
- Player And Data Animations → Themes And Terminal: uses terminal styling
- Listener → Dashboard UI: views results
README.md