Ncmpcpp: Difference between revisions
From wikinotes
No edit summary |
|||
(17 intermediate revisions by the same user not shown) | |||
Line 5: | Line 5: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| <code> | | github || https://github.com/ncmpcpp/ncmpcpp | ||
|- | |||
| <code>man ncmpcpp</code> || https://man.archlinux.org/man/extra/ncmpcpp/ncmpcpp.1.en | |||
|- | |- | ||
|} | |} | ||
</blockquote><!-- Documentation --> | </blockquote><!-- Documentation --> | ||
= Tutorials = | |||
<blockquote> | |||
{| class="wikitable" | |||
|- | |||
| cheat sheet || https://pkgbuild.com/~jelle/ncmpcpp/ | |||
|- | |||
|} | |||
</blockquote><!-- Tutorials --> | |||
= Locations = | |||
<blockquote> | |||
{| class="wikitable" | |||
|- | |||
| <code>~/.ncmpcpp/config</code> || user config | |||
|- | |||
| <code>~/.ncmpcpp/bindings</code> || user keybindings | |||
|- | |||
| <code>/usr/share/doc/ncmpcpp/bindings</code> || global keybindings | |||
|} | |||
</blockquote><!-- Locations --> | |||
= Install = | = Install = | ||
Line 20: | Line 42: | ||
= Usage = | = Usage = | ||
<blockquote> | <blockquote> | ||
== Cli == | |||
<blockquote> | |||
<syntaxhighlight lang="bash"> | |||
ncmpcpp -s browser # open to browser screen | |||
</syntaxhighlight> | |||
</blockquote><!-- Cli --> | |||
== Menus == | == Menus == | ||
<blockquote> | <blockquote> | ||
Line 35: | Line 64: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
</blockquote><!-- Menus --> | </blockquote><!-- Menus --> | ||
== 1. Playlist == | |||
<blockquote> | |||
<syntaxhighlight lang="yaml"> | |||
c # clear playlist | |||
~ # find song in library | |||
` # choose random item (ex. ` b 10 adds 10x random albums) | |||
</syntaxhighlight> | |||
</blockquote><!-- Playlist --> | |||
== 4. Library == | |||
<blockquote> | |||
<syntaxhighlight lang="yaml"> | |||
4 # cycle views ($1,album,track), (album-by-$1,track), (album,track) | |||
e # edit tags (or if unavail, at least prints filepath) | |||
` # (on leftmost column) set $1 column tag-type | |||
` # (on mid/right column) add N random items to the playlist | |||
</syntaxhighlight> | |||
</blockquote><!-- Library --> | |||
== 6. Tag Editor == | |||
<blockquote> | |||
{{ NOTE | | |||
to use the tag editor, you must set <code>mpd_music_dir</code> in your ncmpcpp config | |||
}} | |||
<syntaxhighlight lang="yaml"> | |||
* navigate to an album/song | |||
# 'E' on a song locates in tag editor | |||
* switch to middle column, select a field to change, change | |||
* navigate to save | |||
</syntaxhighlight> | |||
</blockquote><!-- 6. Tag Editor --> | |||
</blockquote><!-- Usage --> | </blockquote><!-- Usage --> | ||
= Configuration = | = Configuration = | ||
<blockquote> | |||
== Colours/Formatting == | |||
<blockquote> | <blockquote> | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
Line 63: | Line 127: | ||
# Numeric Colours (1-8) can be assigned | # Numeric Colours (1-8) can be assigned | ||
$2this is red text | $2this is red text | ||
</syntaxhighlight> | |||
</blockquote><!-- Colours/Formatting --> | |||
== Visualizations == | |||
<blockquote> | |||
Toggle the visualization with the <code>space</code> key while looking at visualizations. | |||
<syntaxhighlight lang="dosini"> | |||
# ~/.mpdconf | |||
# create audio output for visualization | |||
audio_output { | |||
type "fifo" | |||
name "visualization" | |||
path "/tmp/mpd.fifo" | |||
format "44100:16:2" | |||
} | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash"> | |||
# ~/.config/ncmpcpp/config | |||
visualizer_data_source = "/tmp/mpd.fifo" | |||
visualizer_output_name = "visualization" | |||
visualizer_in_stereo = "yes" | |||
visualizer_type = "spectrum" | |||
visualizer_look = "+|" | |||
</syntaxhighlight> | </syntaxhighlight> | ||
</blockquote><!-- Visualizations --> | |||
</blockquote><!-- Configuration --> | </blockquote><!-- Configuration --> |
Latest revision as of 00:32, 16 February 2024
A TUI mpd client.
Documentation
github https://github.com/ncmpcpp/ncmpcpp man ncmpcpp
https://man.archlinux.org/man/extra/ncmpcpp/ncmpcpp.1.en
Tutorials
cheat sheet https://pkgbuild.com/~jelle/ncmpcpp/
Locations
~/.ncmpcpp/config
user config ~/.ncmpcpp/bindings
user keybindings /usr/share/doc/ncmpcpp/bindings
global keybindings
Install
sudo pacman -S ncmpcpp mpd
Usage
Cli
ncmpcpp -s browser # open to browser screenMenus
1 - Current playlist 2 - Filesystem browser 3 - DB search 4 - Library 5 - Playlist editor 6 - Tag editor (very powerful!) 7 - Output selector 8 - Music visualizer = - Clock F1 - Help1. Playlist
c # clear playlist ~ # find song in library ` # choose random item (ex. ` b 10 adds 10x random albums)4. Library
4 # cycle views ($1,album,track), (album-by-$1,track), (album,track) e # edit tags (or if unavail, at least prints filepath) ` # (on leftmost column) set $1 column tag-type ` # (on mid/right column) add N random items to the playlist6. Tag Editor
NOTE:
to use the tag editor, you must set
mpd_music_dir
in your ncmpcpp config* navigate to an album/song # 'E' on a song locates in tag editor * switch to middle column, select a field to change, change * navigate to save
Configuration
Colours/Formatting
# %l - length # %f - filename # %D - directory # %a - artist # %A - album artist # %t - title # %b - album # %y - date # %n - track number (01/12 -> 01) # %N - full track info (01/12 -> 01/12) # %g - genre # %c - composer # %p - performer # %d - disc # %C - comment # %P - priority # $R - begin right alignment {%a} # Display Artist only if available {%a}|{%A} # Display Artist if available, else display AlbumArtist {%30a} # Display Artist, maximum char width of 30 # Numeric Colours (1-8) can be assigned $2this is red textVisualizations
Toggle the visualization with the
space
key while looking at visualizations.# ~/.mpdconf # create audio output for visualization audio_output { type "fifo" name "visualization" path "/tmp/mpd.fifo" format "44100:16:2" }# ~/.config/ncmpcpp/config visualizer_data_source = "/tmp/mpd.fifo" visualizer_output_name = "visualization" visualizer_in_stereo = "yes" visualizer_type = "spectrum" visualizer_look = "+|"