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

1. Run the app: bun run tauri dev
2. 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.