Soniclair.Cli

English 简体中文

Important

For best visual quality, you need a terminal which don't print control characters. On Windows, conhost.exe is not supported, while newest Windows Terminal has the issue. It works quite well with the default terminal on macOS.

For more information, see microsoft/terminal/issues/17016, gui-cs/Terminal.Gui/issues/2928

Kindly install windows-terminal@1.19.10302.0 if you are on Windows (which I tested)

This is NOT a Soniclair.Cli issue.

An album-centered subsonic client for the Terminal

SonicLair.Cli is a terminal music client for subsonic compatible music servers built using .NET Core 6, designed to be cross-platform (Windows, Linux and macOS). It's derived from SonicLair.Net.

Features

• Connect to any subsonic-compatible music server. Tested on Navidrome.
• Album-centered music playing: if you start playing a song, the album becomes your playlist.
• Search throughout your entire music library.

Screenshots

Installation and Usage

• There exists a dev branch. Check regularly for quick bug fixes!

The release is is an (almost) self contained executable. You can grab the version for your operating system from the releases page. Within the compressed file there is the excutable and (if applicable) the libvlc libraries needed for the audio backend to work. Please keep the directory structure as is.

If you are on a Windows and scoop-ready, you can also use scoop to install:

scoop bucket add nemo https://github.com/xiongnemo/windows-binaries-scoop-bucket && scoop install SonicLair.Cli

Use a proper monospace font (with CJK if you want) to correctly show the paddings.

If you are on Windows, SystemMediaTransportControls is integrated. You can use Windows media control:

Linux caveats

For linux, the app will search for the relevant libvlc files from your installation.

For Ubuntu and Debian

sudo apt update && sudo apt upgrade # if you haven't done it in a while
sudo apt install libvlc-dev libx11-dev

And then you can try the app. If it complains that it can't instantiate libvlc try

sudo apt install vlc

More info about this here

Projects leveraged here

Terminal

• Terminal.GUI

Audio Backend

• VLC

Deverlop & Contribute

Visual Studio (Code) is supported. Grab your SDK and you are ready to go.

Feel free to file issues and submit PRs.

But if you want to make functional changes, make sure to discuss it in a separate issue (so we can track it!).

License

MIT, see LICENSE for more info.

But basically, you can do whatever you want with this code.