Website · Download · Documentation · Quick start · Releases · Nightly
fooyin is a customisable desktop music player. It combines flexible playback, library management, playlists, and scripting tools in an interface that can be rearranged from a blank canvas or adapted from preset layouts.
It's built around extensibility and supports plugins for widgets, decoders, tag readers, DSPs, and integrations, and includes FooScript for advanced display formatting, queries, autoplaylists, and widget behaviour.
- Support for major audio formats and containers, including FLAC, MP3, MP4, Vorbis, Opus, WavPack, WAV, AIFF, MKA, Musepack, and Monkey's Audio
- Native support for VGM and tracker/module formats through optional plugins
- Playback of files directly from archives
- CUE sheet support, including embedded CUE sheets
- Audio CD playback and ripping (Linux-only)
- File integrity checks and AccurateRip verification for complete discs
- Internet radio discovery and remote audio stream playback
- Gapless and bit-perfect playback
- Playlist-led and queue-led playback modes
- Configurable fade and crossfade behaviour for pause, stop, seek, manual track changes, and automatic transitions
- Waveform seekbar, spectrum, spectrogram, oscilloscope, VU and peak meters, and projectM visualisations
- Audio output and device configuration
- Command-line playback controls and support for opening files, directories, and remote URLs
- ReplayGain playback support and scanning
- DSP chains with an equaliser, resampling, tempo, pitch, rate, and plugin-provided DSPs
- Built-in tag editor and metadata management tools
- Quick Tagger for configurable metadata actions
- MusicBrainz metadata lookup
- Artwork embedding, downloading, viewing, exporting, and extracting
- File renaming, copying, moving, and deletion
- Audio conversion to WAV, FLAC, ALAC, WavPack, MP3, AAC, Vorbis, and Opus with reusable presets
- Advanced filtering and search on library and playlist data
- Ratings, play counts, and loved status
- Standard playlists plus autoplaylists
- Playback queue
- M3U/M3U8 import and export
- Library tree and directory browser views
- Fully customisable interface from a blank canvas or preset layouts
- Lyrics search, editing, syncing, and display
- FooScript for advanced formatting, display logic, queries, and autoplaylists
- Rich text and script formatting support across most widgets and views
- Configurable application and global keyboard shortcuts
- MPRIS support for desktop and media key integration
- Desktop track notifications with playback controls
- Sleep and display inhibition during playback
- Scrobbling support for Last.fm, Libre.fm, ListenBrainz, and custom services
- Discord Rich Presence with artwork support
- Run Services for launching external applications
The download page lists the Flathub package and packages available through Linux distribution repositories. Release notes and downloadable artifacts are published on GitHub Releases. The latest nightly build is also available for testing upcoming changes.
See BUILD.md for dependencies, build options, and installation instructions.
fooyin is developed and supported on Linux and Windows. Build configurations and CI workflows are also maintained for macOS.
Official macOS support is coming soon.
- Read the documentation or follow the quick-start guide.
- Visit the support page for help and frequently asked questions.
- Report bugs and request features through the GitHub issue tracker.
- See ROADMAP.md for upcoming releases and long-term plans, or CHANGELOG.md for previous changes.
Contributions through code, bug reports, documentation, testing, translation, or user support are welcome. Before contributing, please read CONTRIBUTING.md and the Code of Conduct.
Translations are managed on Hosted Weblate. To test a translation locally, follow the instructions in issue #679.
fooyin is free software released under the GNU General Public License, version 3 or later.
If you would like to support fooyin development, see the donate page.