#music-metadata #music #media #metadata

app selene-cli

Official CLI frontend for Selene

2 unstable releases

Uses new Rust 2024

0.3.0 Mar 13, 2026
0.2.0 Feb 25, 2026

#151 in Audio

MIT license

250KB
6K SLoC

THIS PROJECT IS A WORK IN PROGRESS. FEATURES MAY BE MISSING, NON-FUNCTIONAL, OR BROKEN

Selene

Selene is a local-first, feature packed library handler for all common music types. Designed to be easy and convenient for anyone looking to replace streaming services

Installation

Cargo (recommended)
cargo install selene-cli --locked

There are plans to package for:

  • Arch linux
  • Tarball (For linux)
  • Zip archive (For windows)

Also see how to Build from source

Features

Selene comes with a variety of features to make it convenient for anyone to use, be it an average listener, or a music enthusiast

Library Management

Selene treats your source files differently from your library. In making sure Selene never corrupts, degrades, or messes with your music permanently, Selene will copy all source files into your library. Songs in the library are where non-reversable operations will be applied to your music, like loudness normalization.

Local Features
  • [STABLE] Music playing, of course
  • [PLANNED] Locally keep track of listens per track, album, and artist
  • [PLANNED] Like and dislike tracks
  • [WIP] Playlist management
  • [STABLE] Loudness normalization (EBU R 128 Standard, Two-pass)
  • [PLANNED] Exporting library for various other local media applications (Like VLC)
  • [STABLE] Easy metadata mangement (Bulk management planned)
Non-Local Features
  • [PLANNED] Uploading/Downloading lyrics and synced lyrics from LRCLIB
  • [PLANNED] Downloading cover art, artist art, and album art from Last.fm or a search query from your desired search engine
  • [PLANNED] Scrobbling to Last.fm
  • [PLANNED] Importing listens from Last.fm
  • [PLANNED] Getting Artist, Album, and Track recommendations from Last.fm
Supported File Types
  • [STABLE] flac
  • [STABLE] mp3
  • [NEEDS TESTING] ogg
  • [NEEDS TESTING] opus
  • [NEEDS TESTING] oga
  • [STABLE] wav

Support for playing video files (Like music videos) may come eventually. Just remember this is a local music player, not a local media player

Building from source

Prerequisites
  • cargo
  • git
  • ffmpeg
  • ffprobe

It is recommended to install cargo via rustup. ffmpeg also usually comes with ffprobe

Run this to download the repository:

git clone https://codeberg.org/CrypticCreator/Selene.git
cd Selene

And then to install:

cargo install --path selene-cli --locked

Dependencies

~13–54MB
~833K SLoC