mirror of
https://github.com/markuryy/shark.git
synced 2025-12-12 11:41:02 +00:00
Markury
e1e7817c71
Add ability to download entire playlists as M3U8 files, with UI integration and per-track download actions. Implement track existence checking to avoid duplicate downloads, respecting the overwrite setting. Improve queue manager to sync downloaded tracks to the library incrementally. Refactor playlist parsing and metadata reading to use the Rust backend for better performance and accuracy. Update UI to reflect track existence and download status in playlist views. BREAKING CHANGE: Deezer playlist and track download logic now relies on Rust backend for metadata and new existence checking; some APIs and internal behaviors have changed.
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.