Skip to content

alfazet/amusing

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Amusing

A Musing client.

Features

  • A TUI interface for interacting with your Musing instance.
  • Fuzzy searching of the queue and your music library.
  • Configurable colors and keybindings.

Installation

Install Amusing from cargo (cargo install amusing) or download the source code and build it on your own.
For users of Arch-based distros, Amusing is available on the AUR (amusing).
For Windows users there's a prebuilt binary available in Releases.

Usage

Amusing isn't a music player by itself, it's only a client, so before running it you will need an active instance of Musing to connect to.
Amusing's interface is split into three screens: the cover art screen, the queue screen and the library screen.
They are accessible (by default) with keys 1, 2 and 3 respectively.

Cover art screen

The "starting screen" of Amusing, where you can admire the current tracks's cover art.1

musing cover art screen

Queue screen

Here queued up songs are displayed.
You can play a selected song "out of order" (default: Enter), delete a song from the queue (default: D) or clear the entire queue (default: Delete).

musing queue screen

Library screen

This screen allows you to browse through your music library.
The library is divided into two sections: on the left you select a group of songs (by default songs are grouped by their album artist and then the album, but you can configure it to your liking) and on the right you can see all the titles of all the individual songs that belong to the selected group.

musing library screen

Configuration

See the comments in the example config file.

TODO

  • Add a "playlists" screen.
  • Add a visualizer.

Footnotes

  1. Image rendering is provided by the ratatui-image crate.

About

A Musing client

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages