SOSU is a modern, user-friendly desktop music player designed specifically for osu! beatmap songs. Built with Electron and React, SOSU provides a beautiful, Spotify-inspired interface that makes it easy to browse, play, and manage your osu! music collection.

Whether you're practicing, listening to your favorite beatmaps, or organizing your music library, SOSU offers everything you need. Enjoy real-time playback controls, custom playlists, Discord Rich Presence integration, direct beatmap links, and a highly responsive design with smooth animations.

Take your osu! music experience to the next level with SOSU.

SOSU comes packed with 50+ features organized into 7 main categories:

• Music Player - Play songs from your osu! Songs folder with seamless playback
• Spotify-inspired UI - Modern, beautiful interface designed for comfort
• Playlist Support - Create, manage, and organize custom playlists
• Multiple Views - Library, Favorites, Recently Played, Most Played
• Auto-save - Automatic saving of settings and playback state
• Close Confirmation - Confirm before closing and choose minimize to tray or quit

• Real-time Search - Instant search with smart suggestions
• Duration Filter - Hide songs shorter than specified length
• Artist Hide List - Filter out songs from specific artists
• Advanced Title Filters - Contains, starts with, ends with filters
• Remove Duplicates - Automatically filter duplicate song titles
• Filter Statistics - View detailed filter results and stats

• Full Playback Control - Play, pause, next, previous, seek, volume
• Shuffle Mode - Randomize your playlist playback
• Repeat Modes - Repeat all, repeat one, or no repeat
• Autoplay - Automatically play next song
• Playback Speed - Adjust speed from 0.5x to 2.0x
• 10-band Equalizer - Professional audio tuning
• VU Visualizer - Real-time audio visualization

• Favorites - Mark and organize your favorite songs
• Play Count Tracking - See how many times you've played each song
• Recently Played - Quick access to your recent listening history
• Most Played - Discover your most-played tracks
• Song Details - View comprehensive metadata and info

• Discord Rich Presence - Show what you're listening to on Discord
• OBS Widget Server - Display now-playing on your stream
• WebSocket API - Control SOSU from external apps
• Beatmap Links - Quick links to osu.ppy.sh
• Now-Playing API - Public API for current song info

• Blurred Album Art - Dynamic background from album covers
• Custom Accent Colors - Personalize your interface colors
• Dark Theme - Eye-friendly dark mode by default
• Hardware Acceleration - Toggle GPU acceleration for compatibility and performance
• Widget Themes - Customize OBS widgets with themes
• Theme Download - Get themes directly from GitHub

• Profiles - Save and switch between multiple setup profiles
• Profile Import/Export - Backup or restore your profiles when needed
• Rescan Library - Refresh your music library
• Reset Widgets - Clear all custom widgets with one action
• Reset Cache - Clear cached data to resolve issues fast
• Settings Reset - Reset settings only without deleting library data
• Full Reset - Clear all local data and start fresh

Note: Profiles do not include tray behavior or hardware acceleration settings.

• osu! - osu! game installation with Songs folder
• osu! Songs Folder - Contains your beatmap audio files (.mp3, .ogg)
  • Default Windows location: C:\Users\YourName\AppData\Local\osu!\Songs
  • Default macOS location: ~/Library/Application Support/osu!/Songs
  • Default Linux location: ~/.local/share/osu!/Songs

Note: SOSU reads audio files directly from your osu! Songs folder. No additional setup required!

• Click here to download the recommended Windows installer
• Alternative downloads from the latest release:
  • Portable (.exe)
    • sosu-2.8.0-portable.exe (no installation required)
  • MSI Installer (.msi)
    • sosu-2.8.0.msi (alternative for enterprise environments)

  Note: The portable version doesn't save settings between sessions. The installer saves all configuration. Choose the format that best fits your needs.

Note: The macOS build is currently in beta test. There may be bugs or missing features. Please report any issues you encounter.

• Click here to download the recommended macOS installer
• Alternative downloads from the latest release:
  • PKG Installer (.pkg)
    • sosu-2.8.0.pkg (for Apple Silicon Macs)

  On first launch, you may need to right-click and choose "Open" to bypass security warnings if the app is not notarized.

Note: The Linux build is currently in beta test. There may be bugs or missing features. Please report any issues you encounter.

• Click here to download the recommended Linux AppImage
• Alternative downloads from the latest release:
  • Debian Package (.deb)
    • sosu_2.8.0.deb
  • RPM Package (.rpm)
    • sosu-2.8.0.rpm

  You may need to make the AppImage executable: chmod +x ./sosu-2.8.0.AppImage and then run it.

Note: .yml and .blockmap files are for auto-update and can be ignored by most users. Download the installer or portable/archive for your platform.

This project is licensed under the Apache-2.0 License - see the LICENSE file for details.

Made with ❤️ by Adivise for the osu! community