selene-core 0.5.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

An arch package is available on the AUR. To install, use your AUR helper of choice, such as paru:

paru -S selene-player-git # Install Selene
systemctl --user enable selene # Run the daemon

Uninstallation

If you are uninstalling selene, after uninstalling the selene package, the remaining files can be cleaned up here:

rm -rf ~/.config/selene
rm -rf ~/.local/share/selene
rm -rf ~/.local/state/selene

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.

  • [STABLE] Music playing
  • [STABLE] Metadata mangement
  • [WIP] Playlist management
  • [STABLE] Two-pass loudness normalization with Symphonia and ebur128
  • [STABLE] MPRIS support
  • [PLANNED] Locally keeping track of listens per track, album, and artist
  • [PLANNED] Exporting library with metadata built for various other local media applications (Like VLC)
  • [STABLE] 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
  • [STABLE] ogg
  • [NEEDS TESTING] oga
  • [STABLE] wav

Support will extend for any format and codec that Symphonia supports

Building from source

  • cargo
  • git
  • ffmpeg

It is recommended to install cargo via rustup.

1. Download the repository and navigate to its directory

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

2. Install the main binary

cargo install --path selene-cli

*All features are optional

3. Run the daemon

selene run-daemon

4. Start listening

I will make a wiki soon soon about more config options and initial setup, but for now, your best bet is to use selene -h to navigate the help menus