Music Set Scripting language
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
NGnius (Graham) 17057accc2 Fix playlist filepath generation to ignore already-absolute paths 3 months ago
.github Create FUNDING.yml 9 months ago
bliss-rs@2dcdd5643b Add radio sorter with improved music analysis and misc cleanup 1 year ago
extras Update licensing info and some doc typos 2 years ago
interpreter Fix playlist filepath generation to ignore already-absolute paths 3 months ago
m3u8 Update repo url 8 months ago
mpris-player@2e843ec8d9 Create barebones music player for mps interpretor 2 years ago
player Add clear and pause-after REPL commands 4 months ago
src Add clear and pause-after REPL commands 4 months ago
tests Change file extensions to .muss 2 years ago
.gitignore Fix tests for rename 2 years ago
.gitmodules Migrate bliss-rs to git.ngni.us 6 months ago
Cargo.lock Improve song duration reporting, change to fork of playback library with duration fix 6 months ago
Cargo.toml Implement REPL command to add current item to a m3u8 playlist 6 months ago
LICENSE Create LICENSE 2 years ago
README.md Update READMEs with newer syntax 8 months ago
README.tpl Update licensing info and some doc typos 2 years ago
ngnius.muss.desktop Add ?skip and ?list REPL commands and fix some missed names 2 years ago

README.md

muss

repl_demo

Sort, filter and analyse your music to create great playlists. This project implements the interpreter (./interpreter), music player (./player), and CLI interface for Muss (./). The CLI interface includes a REPL for running scripts. The REPL interactive mode also provides more details about using Muss through the ?help command.

Usage

To access the REPL, simply run cargo run. You will need the Rust toolchain installed. For a bit of extra performance, run cargo run --release instead.

Examples

One-liners

All songs by artist <artist> (in your library), sorted by similarity to a random first song by the artist.

files().(.artist? like "<artist>")~(~radio);

All songs with a .flac file extension (anywhere in their path -- not necessarily at the end).

files().(.filename? like ".flac");

All songs by artist <artist1> or <artist2>, sorted by similarity to a random first song by either artist.

files().(.artist? like "<artist1>" || .artist? like "<artist2>")~(~radio);

Bigger examples

For now, check out ./src/tests, ./player/tests, and ./interpreter/tests for examples. One day I'll add pretty REPL example pictures and some script files... // TODO

FAQ

Can I use Muss right now?

Sure! It's never complete, but Muss is completely useable right now. Hopefully most of the bugs have been ironed out as well :)

Why write a new language?

I thought it would be fun. I also wanted to be able to play my music without having to be at the whim of someone else's algorithm (and music), and playing just by album or artist was getting boring. Designing a language specifically for iteration seemed like a cool & novel way of doing it, too (though every approach is a novel approach for me).

What is Muss?

Music Set Script (MuSS) is a language for describing a playlist of music. It can execute SQLite select clauses or directly query the filesystem. Queries can be modified by using filters, functions, and sorters built-in to Muss (see interpreter's README.md).

Is Muss a scripting language?

Yes. It evolved from a simple query language into something that can do arbitrary calculations. Whether it's Turing-complete is still unproven, but it's powerful enough for what I want it to do.

License

LGPL-2.1-only OR GPL-3.0-only

NOTE: Advanced features make use of a fork of bliss-rs a GPL-3.0 licensed music analysis library.

Contribution

This is a hobby project, so any contribution may take a while to be acknowledged and accepted.