A simple GUI audio player for GNU/Linux operation systems. Keyboard controls only.


  • customization (background, font, colors)
  • playlists


  • Ruby (Tested against Ruby 2.5.1)
  • SDL2
  • Ruby/SDL2

Installation and Setup

Just run gem install akane_sound then do execute akane_sound for a first startup that sets up the config file in /home/user/.local/share/ruby_app/akane_sound/. Open the config file and edit as you wish, it's recommended to specify the root directory according to your music directory.


enterplay a song, load a playlist, change directory
jmove cursor down
kmove cursor up
page upmove page up
page downmove page down
spacetoggle pause
>volume up
<volume down
aappend selected song to playlist, appends contents if directory is selected
Asame as above, but recursive
tabswitch between directory and playlist
Cclear playlist
wwrite playlist to root_dir/akane_playlists
sstops track if playing
rrefreshes the current directory and updates the cache
nskip to next song
pskip back to previous song
Rtoggle repeat
Stoggle shuffle
Ntoggle auto-next
ggo to beginning of list
Ggo to end of list

Source code available here