mirror of
https://github.com/markuryy/shark.git
synced 2025-12-12 11:41:02 +00:00
Markury
0bc0e70274
Add logic to find and use album cover art as a fallback when playlist cover art is missing, both for local and online playlists. Update database schema and upsert logic to store album picture URLs for online tracks. Improve UI to display fallback cover art when needed.
Shark!
Desktop music management application written in Typescript.
Inspiration
Inspired by this post on X, and the functionality of Deemix, written from the ground up for Tauri's webwiew without the Node.js dependency. Instead it has much more specific dependencies :)
Tech Stack
- Tauri 2 (desktop runtime)
- SvelteKit 2 with Svelte 5 (frontend)
- TypeScript
- Bun (package manager)
- Not-very-faithful Windows 98-style UI theme (98-dark.css)
Setup
Prerequisites
- Bun installed
- Rust toolchain (for Tauri)
Installation
bun install
Configuration
- Run the app:
bun run tauri dev - Go to Settings and configure:
- Music folder (where downloads will be saved)
- Playlists folder (for .m3u8 files)
- Download settings (format, concurrency, overwrite behavior)
Development
# Run dev server (hot reload)
bun run tauri dev
# Build for production
bun run tauri build
# Type checking
bun run check
Architecture
src/
├── routes/ # SvelteKit pages
│ ├── library/ # Local library view
│ ├── services/ # Downloads and metadata services UI
│ ├── downloads/ # Download queue UI
│ └── settings/ # App settings
├── lib/
│ ├── services/ # Downloads and metadata services
│ ├── library/ # Library scanner, album/playlist loaders
│ ├── stores/ # Svelte stores (settings, auth, queue)
│ └── types/ # TypeScript type definitions
src-tauri/
├── capabilities/ # Tauri security permissions
└── tauri.conf.json # Tauri configuration
License
This repo has been made source available. It is not licensed under a single open source license. Check upstream libraries for license details.