mirror of
https://github.com/markuryy/shark.git
synced 2025-12-12 11:41:02 +00:00
Markury
d774aba0d4
Add ability to fully clear cached online library by deleting and recreating the database file. Integrate new Clear Cache option in settings UI, which restarts the app after clearing. Remove unused artist/album fields from cache and UI. Add process plugin for relaunch.
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.