selene-core 0.2.0

selene-core is the backend for Selene, a local-first music player
Documentation

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 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

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.

  • [PLANNED] Music playing, of course
  • [PLANNED] Locally keep track of listens per track, album, and artist
  • [WIP] Like and dislike tracks
  • [WIP] Playlist management
  • [STABLE] Loudness normalization (EBU R 128 Standard, Two-pass)
  • [WIP] Exporting library for various other local media applications (Like VLC)
  • [STABLE] Easy metadata mangement (Bulk management planned)
  • [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
  • [STABLE] flac
  • [STABLE] mp3
  • [NEEDS TESTING] ogg
  • [NEEDS TESTING] opus
  • [NEEDS TESTING] oga
  • [STABLE] wav (Library file is converted to .flac)

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

  • 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