From a4f5bdd7a8eef7a51d043ae395b4ac71c2646372 Mon Sep 17 00:00:00 2001 From: Markury Date: Sun, 5 Oct 2025 16:52:03 -0400 Subject: [PATCH] docs: changelog for first release --- CHANGELOG.md | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..f3a8364 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,82 @@ +# Changelog + +## [0.1.0] - 2025-10-05 + +### 🎉 First Alpha Release + +This is the very first usable build of Shark! - a retro Windows 98-styled music player and downloader. It's rough around the edges and likely contains uncaught bugs, but the core functionality is working. + +### Features + +**Local Library Management** +- SQLite-backed library cache with automatic scanning +- Album views with cover art +- Track listing and playback + +**Music Player** +- Now playing panel with playback controls +- Volume control with triangle slider +- Queue tracks from context menus +- Can show synced lyrics when the window is enlarged +- Can be hidden or shown + +**Deezer Integration** +- Browse and download user favorites (tracks, albums, playlists) +- Search for tracks, albums, and artists +- Playlist caching with SQLite +- Alternative format fallback for unavailable lossless content + +**Download Queue** +- Track and playlist downloads progress +- Automatic audio decryption +- Metadata tagging (ID3 for MP3, FLAC tags) +- Cover art embedding +- Existence checks to avoid re-downloading + +**Lyrics** +- Automatic lyrics fetching during downloads +- LRCLIB integration for manual lyric fetching +- Scan library for missing lyrics + +**UI/UX** +- Windows 98 (ish) dark theme throughout +- Custom window decorations for OS parity +- Bottom status bar for notifications +- Onboarding prompts for folder selection +- Double-click interactions + +### Known Limitations + +- This is an early version - expect bugs and rough edges +- Limited error handling in some edge cases +- UI polish needed in various areas +- Some features may not work as expected +- Breaking changes likely in future releases +- Lack of loading state means pages initially show no data +- No dynamic routes for artists (yet) + +### Known Bugs + +- Context menus show inappropriate options sometimes +- Now Playing section causes layout jitter on nav +- Now Playing section causes title bar vertical shift +- Batch lyrics downloading is less reliable than individual +- Track scrubbing causes lyrics desync +- Stopping (not pausing) a track and starting the same one resumes progress +- Album year is not populated in Library table +- Not all tables clip text overflow in certain columns +- Album fetching edge cases (`Doja Cat` and `K/DA`) +- Download interruptions don't always clean up temp files +- LRCLIB service page indexes temp folder + +### Technical Details + +- Built with Tauri 2 + SvelteKit 2 + Svelte 5 +- Rust backend for audio processing and decryption +- SQLite for caching and library management +- File-based storage (FLAC/MP3 + metadata) +- Playlists are stored as .m3u8 files with relative paths to tracks + +### Notes + +This release represents 5 days of development and ~80 commits. The app is functional enough for basic use but still has plenty of rough edges. Use at your own risk and expect possible breaking changes as development continues. \ No newline at end of file