amusing

Crates.ioamusing
lib.rsamusing
version1.1.0
created_at2025-09-15 09:01:47.272186+00
updated_at2025-09-23 07:55:13.027767+00
descriptionA Musing client
homepage
repositoryhttps://github.com/alfazet/amusing
max_upload_size
id1839654
size1,124,683
Antoni Zasada (alfazet)

documentation

README

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.

Commit count: 39

cargo fmt