br0kenpixel's Music Player

A terminal based music player with time-synced lyrics support.

This is a remade version of the original, which was written in C.
⚠️ Playlist features (Next, Previous) are not implemented yet.

• src/main.rs - Contains the main entry point. You should start exploring from here.
• src/audioinfo.rs - Provides implementations for reading metadata from audio files.
• src/lyrics.rs - The lyrics "engine."
• src/lyrics_parse.rs - The lyrics parser.
• src/player.rs - Provides implementations for controlling the audio player.
• src/display.rs - Provides a high-level abstraction layer for creating and managing the UI.
• src/timer.rs - Provides a simple timer/countdown object.
• src/scrolledbuf.rs - Provides an object for scrolling text.

First make sure you have the Rust toolchain installed.
If not, use the following command on *nix based systems:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

To run the player follow these steps:

1. Clone this repo
   • git clone https://github.com/br0kenpixel/rustyplay
2. Build the binary
   • cargo build --release

   • ⚠️ It's highly recommended to build in release mode for better performance!

3. Run the binary like this:
   • musicplayer [FILE]
     • Example:
     • musicplayer call_me.wav
4. You can also build the documentation:
   • cargo doc --open

• WAV
• OGG
• FLAC

  • ⚠️ FLAC support is temporarily disabled due to issues with playback.

  • ✅ FLAC playback has been fixed thanks to this!

  • ✅ FLAC playback has been fixed by using optimizations instead of the fix mentioned above

As of now, it was only tested on macOS Monterey 12.6.1 (Intel). But theoretically it should work on any other OS, as all dependencies have cross-platform support.

• rodio
  • An audio playback library
• sndfile
  • Used to read metadata from audio files
• ncurses
  • A popular terminal UI library
• pausable_clock
  • Provides a pausable/resumable clock type
• serde
  • A data serialization/deserialization framework
• serde_json
  • Allows serialization/deserialization to/from JSON using serde.

The time-synced lyrics are provided by Spotify/Musixmatch. In order to be able to use this feature, you must obtain a JSON file containing the time-synced lyrics data. Such data can be obtained by using either akashrchandran/spotify-lyrics-api or br0kenpixel/spotify-lyrics-api-rust. "End times" are also supported under certain conditions.

First, you need to use one of the tools listed above to obtain the lyrics data from Spotify. You'll need to save this data into a .json file. This file must be located in the same directory as the audio file it "belongs" to!
For example, if you run musicplayer Documents/Music/hello.wav then Documents/Music/hello.json must be a valid path and this file must contain the lyrics data obtained from Spotify. If this .json file does not exist, lyrics functionality will be disabled, however playback will work. If the .json file contains invalid data, the program will panic!().

So far I haven't noticed any lyrics data with endTimeMs set, however if the lyrics contain a line with a singe ♪ character (or is empty), the lyrics parser will automatically "adjust" the lyrics data. This line will be ignored and it's startTimeMs is changed to the previous line's endTimeMs.

You can use cargo doc to generate the documentation.
The "homepage" of the documentation is target/doc/musicplayer/index.html.