https://github.com/Dudemanguy/vmn

Simplistic cli music player built on mpv and curses
https://github.com/Dudemanguy/vmn

Last synced: 4 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 (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-07-09T02:32:29.000Z (12 months ago)
• Last Synced: 2024-01-15T22:01:56.871Z (5 months ago)
• Language: C
• Size: 216 KB
• Stars: 36
• Watchers: 3
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• 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