Festival is a music player designed specifically for local album collections, offering a clean and intuitive interface for managing and playing your music files. Developed in Rust, Festival emphasizes performance and reliability, making it a solid choice for audiophiles and casual listeners alike.
For detailed information, visit the Festival documentation.
To see how Festival stacks up against other music players, check out the comparison page.
You need cargo and at least rustc 1.70. Clone the repository with the submodules included:
git clone --recursive https://github.com/hinto-janai/festivalThe built binary will be found in target/release/festival[.exe] by default.
The pre-compiled Linux binaries are built on Ubuntu 20.04. You'll need these packages to build:
sudo apt install build-essential pkg-config libdbus-1-dev libpulse-dev libgtk-3-devTo build the latest stable release:
git checkout gui-v1.4.0
cargo build --releaseTo build the latest stable release:
git checkout gui-v1.4.0
cargo build --releaseTo build the latest stable release:
git checkout gui-v1.4.0
cargo build --releaseThere is a build.rs file in gui/ solely for Windows-specific things:
VCRUNTIME140.dll (the binary will not be portable without this)Festival is licensed under the MIT License. Note that its dependency tree includes many other licenses.
Festival does not directly support compilations (a single album with various artists) at the moment. The album will be loaded but spread out for each different artist.
Your audio files must have proper metadata for Festival to detect them. The required tags are Artist and Album. If the song title tag does not exist, the filename will be used instead. For more details on metadata-related errors, start Festival in a console:
./festivalLook for yellow W (Warn) log messages during a Collection reset.
If your audio file has embedded album art, Festival will use it. If no embedded album art metadata is found, Festival will search for an image file in the same directory as the file, then in the file's parent directory. If an image file is not found, a default '?' album art will be used. The supported image file formats are JPG/JPEG, PNG, BMP, ICO, TIFF, and WebP.
Festival will look for a date metadata tag resembling the YYYY-MM-DD format. Examples of acceptable formats include:
As long as the year exists, the date will be parsed correctly. Formats like MM-DD or DD-MM without a year will not be parsed correctly and will appear as ????-??-?? in Festival.
Festival is a music player, not a metadata editor. Some recommended metadata editors include Kid3, mp3tag, puddletag, and MusicBrainz Picard.
The supported audio codecs are:
Festival supports various metadata formats with the following statuses: