https://github.com/fliegendewurst/mpv-ratings-based-shuffle

mpv script to customize random playlist song selection
https://github.com/fliegendewurst/mpv-ratings-based-shuffle

mpv-script

Last synced: 3 days ago
JSON representation

mpv script to customize random playlist song selection

• Host: GitHub
• URL: https://github.com/fliegendewurst/mpv-ratings-based-shuffle
• Owner: FliegendeWurst
• License: mit
• Created: 2020-07-26T08:42:21.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-12-20T18:11:06.000Z (19 days ago)
• Last Synced: 2024-12-20T19:25:09.870Z (18 days ago)
• Topics: mpv-script
• Language: Lua
• Homepage:
• Size: 7.81 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
ratings-based-shuffle

=====================

Simple mpv script to easily customize random playlist song selection.

Usage

-----

Every file initially has a 'rating' of `1`. Using the upvote/downvote keybindings, the rating of the currently playing file can be multiplied by 1.1 or 0.9. In RBS mode (activated by another keybinding), a new file is randomly chosen (chance [rating]/[files in playlist]) after playback of any file is completed.

Installation and configuration

------------------------------

Place `ratings-based-shuffle.lua` in your `~/.config/mpv/scripts`.

Copy `ratings-based-shuffle.conf` into `~/.config/mpv/script-opts` and adjust the option values: set `directory` to the location of the files you want to play. Ratings will be saved in the file specified by `ratings_file`. Example:

```

directory=/home/username/Music/BigPlaylist

ratings_file=/home/username/.config/mpv/rbs-ratings.txt

```

Set up the keybindings in your `input.conf` (usually located in `~/.config/mpv`):

```

Alt+r script-message RBS-init

Alt+UP script-message RBS-upvote

Alt+DOWN script-message RBS-downvote

```

Technical details

-----------------

In the `ratings_file`, files and associated ratings are stored:

```json

{

	"/home/username/Music/BigPlaylist/Topic/Directory/Song Name.mp3":1.100000,

	"/home/username/Music/BigPlaylist/Another topic/LoremIpsum.mp3":0.810000

}

```

TODO

----

Add a mode where songs only repeat after playing ~75% of all available files (has to be persisted across mpv runs).