#music-player #music #youtube #playlist #terminal

app listui

A simple music player for the terminal, written in Rust

8 releases

0.2.3 Nov 3, 2023
0.2.2 Oct 11, 2023
0.2.0 Apr 29, 2023
0.1.3 Apr 4, 2023
0.1.2 Mar 31, 2023

#212 in Audio

39 downloads per month

GPL-3.0 license

1.5K SLoC


A simple, easy to use music player for the terminal, written in rust. Currently it support playing local and youtube playlists.


Using cargo

You can compile and install lisTUI using the following command.

cargo install listui

The following dependencies are needed to compile the app:

If you want to be able to play youtube playlists, please make sure you have yt-dlp and ffmpeg installed as well.

Manual installation



Play a playlist stored in your computer:

listui ~/Music/playlist1

Or a YouTube playlist:

listui "https://www.youtube.com/playlist? list=PLauaob2FukqdpQf4g4ph7kY3IHOr-BwzJ"

Or just launch the app and see all your saved playlists:



Currently lisTUI only has only three configurable settings:

  • DATABASE_PATH: the path where the sqlite database will be stored.
  • DOWNLOAD_DIR: the directory where newly downloaded tracks will be stored.
  • YT_API_KEY: by default, lisTUI uses the API of various Invidious instances to fetch information about the requested playlists. If you want to use YouTube instead, you can get get you own API key and put it here.

lisTUI will look for the file ~/.config/listui.config and read the settings from there. Here's an example of listui.config file:



Check CHANGELOG.md in the GitHub repository.


~1M SLoC