Skip to content

snvshal/sur

Repository files navigation

Sur - Retro Audio Player

A retro-style audio player built with Tauri.

Designed by Adi

Preview

Features

  • Play audio files (MP3, WAV, OGG, FLAC, M4A, AAC)
  • Retro iPod-style design with transparent window
  • Open audio files directly from file explorer ("Open with Sur")
  • Draggable window (click anywhere to move)
  • Real-time clock display
  • Seek controls (rewind/forward 5 seconds)
  • Progress bar with time display

Installation

Download the latest release from the GitHub Releases page:

  • Windows: .exe or .msi installer
  • macOS: .dmg installer
  • Linux: .deb or .AppImage

Portable

Run sur.exe directly from the release artifacts.

Usage

Import Audio

Click the "IMPORT AUDIO" button to open the file dialog and select an audio file.

Open With

Right-click any audio file in file explorer -> "Open with" -> "Sur" to open directly in the app.

Controls

  • Play/Pause: Click the center button
  • Rewind 5s: Click the left button
  • Forward 5s: Click the right button
  • Seek: Click on the progress bar
  • Close: Right-click on the device and select "Exit"

Development

Prerequisites

  • Node.js 20+
  • Bun
  • Rust

Commands

# Install dependencies
bun install

# Run in development mode
bun run tauri dev

# Build for production
bun run tauri build

Tech Stack

  • Frontend: Vanilla TypeScript, HTML, CSS
  • Backend: Tauri 2 (Rust)
  • Plugins: tauri-plugin-dialog, tauri-plugin-fs, tauri-plugin-deep-link

License

MIT

About

A retro-style audio player built with Tauri.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors