Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Dudemanguy/vmn
Simplistic cli music player built on mpv and curses
https://github.com/Dudemanguy/vmn
Last synced: 3 months ago
JSON representation
Simplistic cli music player built on mpv and curses
- Host: GitHub
- URL: https://github.com/Dudemanguy/vmn
- Owner: Dudemanguy
- License: gpl-3.0
- Created: 2018-08-23T02:29:10.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-09T02:32:29.000Z (over 1 year ago)
- Last Synced: 2024-06-30T14:48:17.192Z (5 months ago)
- Language: C
- Size: 216 KB
- Stars: 36
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mpv - vmn - Cross-platform CLI music player, based on C/TUI. (Other)
README
# vmn
**v**im **m**usic **n**avigator is a simple, barebones commandline music player. vmn aims to provide a highly customizable, configurable interface to handle massive music libraries with ease. One feature of vmn is that it makes use of mpv's client API for playback which gives you all of the power of mpv's options integrated into a nice interface for browsing and listening to your music.
## Installation
There is an [AUR](https://aur.archlinux.org/packages/vmn-git/) package available for arch users.
#### Building from source
Make sure you have the following dependencies installed.
* ffmpeg
* meson (0.54 or higher)
* mpv
* ncurses
* [scdoc](https://git.sr.ht/~sircmpwn/scdoc) (optional: for man pages)
After checking out the source, navigate to the directory, and then simply run.
```
meson build
meson compile -C build
sudo meson install -C build
```
## Configuration
See the [options](https://github.com/Dudemanguy/vmn/blob/master/docs/options.md) page for details.
## Usage
The default keybindings are the following.
* beginning: `g`
* command: `:`
* end: `G`
* escape: `Ctrl+[`
* move backward: `h`
* move down: `j`
* move forward: `l`
* move up: `k`
* mpv kill: `Q`
* mute: `m`
* page down: `Ctrl+f`
* page up: `Ctrl+b`
* playnext: `>`
* playpause: `Space`
* playprev: `<`
* queue: `i`
* queue all: `y`
* queue clear: `u`
* search: `/`
* search next: `n`
* search prev: `N`
* start: `Enter`
* visual mode: `v`
* vmn quit: `q`
* vmn refresh: `a`
* voldown: `9`
* volup: `0`
To change keybindings, see the [options](https://github.com/Dudemanguy/vmn/blob/master/docs/options.md) page.
For more information on command mode, see the [command](https://github.com/Dudemanguy/vmn/blob/master/docs/command.md) page.
All items that are queued will be played by mpv upon hitting enter. If no items are selected, then the currently highlighted items will be played upon hitting enter. Items can be a directory, a metadata tag, or individual audio files. Playing back a directory or metadata tag will add all valid audio files to mpv for playback.
## License
GPLv3