2 unstable releases
Uses new Rust 2024
| 0.3.0 | Mar 13, 2026 |
|---|---|
| 0.2.0 | Feb 25, 2026 |
#151 in Audio
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