#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

#189 in Audio

GPL-3.0 license

75KB
1.5K SLoC

listTUI

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

Installation

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

WIP

Usage

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:

listui

Configuration

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:

YT_API_KEY=some_key
DOWNLOAD_DIR=/home/user/Music/my_downloaded_songs

Changelog

Check CHANGELOG.md in the GitHub repository.

Dependencies

~41–56MB
~1M SLoC