fooyin logo


Build status Code quality Translation status Packaging status


## A customisable music player fooyin is a music player built around customisation. It provides a variety of widgets to help you manage and play your local collection. It's highly extensible with a plugin system and includes _FooScript_, a scripting language for advanced configuration of widgets. A layout editing mode enables the entire user interface to be customised, starting from a blank slate or a preset layout. Only Linux is supported at present, though support for other platforms is coming soon. | ![Simple](https://github.com/user-attachments/assets/8e8732a7-a7e5-4542-87b4-7d0a7b5e8fa0) | ![Browser](https://github.com/user-attachments/assets/d9f4ed62-e50a-419c-aa26-8801a76a6597) | |----------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------| | ![Obsidian](https://github.com/user-attachments/assets/7dcc92be-04ea-402f-9cbb-a92ee855b893) | ![Wave](https://github.com/user-attachments/assets/de5b4b3a-cd9d-4520-a975-e268e472e0f9) | ## Features ### Playback - Playback of all major formats: FLAC, MP3, MP4, Vorbis, Opus, WavPack, WAV, AIFF, MKA, Musepack, Monkey’s Audio - Native support for VGM and tracker module formats - Gapless playback - Play files directly from archives - Full CUE sheet support (including embedded cues) - ReplayGain support (including calculation) - Waveform seekbar ### Library & Playlists - Powerful filtering on any field - Playlist creation and management - Dynamic autoplaylists based on scripts - Import/export playlists (M3U/M3U8) - Library tree with directory structure view - Integrated directory browser - Built-in tag editor - Automatic artwork finder - Synced lyrics with multi-source downloads ### Customisation - Fully customisable interface, starting from a blank canvas - Personalised keyboard shortcuts - Extend functionality with a plugin system ### Integration - Flexible audio output and device configuration - MPRIS support for system-wide control - Scrobbling (Last.fm, MusicBrainz, Libre.fm) ### Roadmap See [ROADMAP.md](ROADMAP.md) to learn about fooyin's planned features. ## Building from source See [BUILD.md](BUILD.md) for details. ## Translations You can contribute to translations on [Hosted Weblate](https://hosted.weblate.org/projects/fooyin/), an open source and web-based translation platform.