How anderwins/codebase works
Project type and purpose
• This is a standalone desktop music-player application built with JavaFX and packaged via Maven.
• It follows a classic layered MVC pattern, with user interface (FXML & ViewControllers), Controllers, Models/Services, Data Access Objects (DAOs), and an embedded database (SQLite or similar).
• It reads/writes music files, stores metadata in a local DB, supports playlists, lyrics, karaoke, and radio streams.
File structure
• Top-level build files: pom.xml, .gitlab-ci.yml.
• Source packages under src/main/java/ulb:
• Config & Main launchers (Config.java, GuiMain.java, Main.java).
• controller package: JavaFX Controllers and FrontController (MainController, PageController, PlayListFrontController, PlayerObserver, error handlers).
• view package: FXML view controllers matching each UI screen (e.g., HomeViewController, PlayerViewController).
• model package: domain objects (Track, Playlist, Queue, Radio), management classes (PlaylistManager, MetadataManager, LrcLibService), observers, and error types.
• dao package: database initialization and CRUD (DbInitializer, DbManager, SQLLoader).
• services & utils: cross-cutting services (AppServices) and helpers (ColorExtractor, AlertManager).
• Test source tree mirrors main packages for unit tests.
README
• Confirms JavaFX stack, Maven build, fat-jar output, user directory for .deezify_g8 data (music files + deezify.db).
• Lists high-level features: playlist management, advanced search, metadata display.