https://github.com/kkkrackpot/simple-loader

A simple OSD file browser and launcher plugin for mpv.
https://github.com/kkkrackpot/simple-loader

Last synced: 3 months ago
JSON representation

A simple OSD file browser and launcher plugin for mpv.

• Host: GitHub
• URL: https://github.com/kkkrackpot/simple-loader
• Owner: kkkrackpot
• License: unlicense
• Created: 2016-09-22T13:31:14.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2016-12-25T14:25:01.000Z (almost 8 years ago)
• Last Synced: 2024-05-19T18:15:29.408Z (6 months ago)
• Language: Lua
• Homepage:
• Size: 5.86 KB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mpv - simple-loader - (Linux) Browse dirs and files on OSD, and launch them with mpv. (File)

README

        
# simple-loader

A simple OSD file browser and launcher plugin for mpv.

Might be useful when mpv runs in idle fullscreen mode on a HTPC controlled with an IR remote.

# usage

`mpv --script=/path/to/simple-loader.lua [--script-opts=top-dir=/path/to/top-level-dir]`

`top-dir` -- set the top-level/root directory to browse (`/tmp` by default, don't put trailing slash).

Default key-bindings (change them inside the script, if necessary):

`Alt+UP` -- move to the previous item in directory list  

`Alt+DOWN` -- move to the next item in directory list  

`Alt+RIGHT` -- enter the directory  

`Alt+LEFT` -- exit from the current directory  

`Alt+ENTER` -- load the current item to mpv (i.e. start playback)  

`Alt+END` -- stop playback and return to directory list  

# known limitations

The script is Linux-only, because it relies on shell commands.

There's no scrolling. Depending on OSD font-size some items can go below the screen and will stay invisible (but selectable, though).

Some special files (sockets, etc.) may not be listed, since the script relies on output from `mp.utils.readdir` (such files are usually not playable anyway, though).

# disclamer

This software is provided as-is and is in public domain, see `LICENSE` file for details.