kryszak/penny

TUI mp3 player

Penny

Linux Tui MP3 player

This project was created as a personal goal to improve my Rust skills.

Why Penny?

Inspiration for the name comes from the character which battle theme is good and feels misplaced in the same time.

Dev dependencies

For development on Linux OS, alsa development libraries needs to be installed.

Fedora

dnf install alsa-lib-devel

Arch Linux

pacman -S alsa-lib

Ubuntu

apt install libasound2

penny's Issues

Native notification when playback starts

Penny should allow for enabling sending native notification when song is starting to play with summary of played track.

Queue functionality

As all music players, Penny should allow user to compose and use playlist playback queue. At bare minimum it should be possible to play songs from playlist queue and allow to remove and add songs to playlist queue.

Different styles of audio spectrum visualization

Penny should allow for selecting (or turning off) audio visualizer style.

D-Bus integration (MPRIS)

As Penny is aimed mainly for Linux OS it could support MPRIS to allow for control though utilities like playerctl

Theme support

Penny should allow user to change between built in themes.

Refactor code

Current code is not the best it can be, there are some duplicates and multilevel nested code blocks.
Duplications should be removed if possible.
Nested code structures should be flattened.

Add play next/previous song from queue controls

Multiple files can be played in the same time

Sometimes when selecting new song to play while playback is active new song plays together with currently playing one.

Most likely function set_song_file in Mp3Player needs to be improved to better lock player and let it finish up cleanup of currently playing song thread.

Add search possibility for file explorer

Migrate to ratatui

Tui-rs crate is no longer mantained. Fork of it called ratatui was created and is actively maintaned.

Penny should switch to this crate.

Fetching more song metadata from external API

If possible, Penny could pull more info about played track using some external API like audiodb

Allow for saving and loading playing queue (playlists)

At any point of time it should be possible to save current queue to file and allow to load queue from file for simple playlists support.