keyboard shortcuts on wiki differ from users.md

[joaociocca]

I never tried editing another project's wiki, so I thought I'd ask first: is it okay to edit https://github.com/hrkfdn/ncspot/wiki/Ncspot-Guide to make it more complete along what's shown on https://github.com/hrkfdn/ncspot/blob/main/doc/users.md?

---

While users.md shows a very complete table

---

Key Bindings

The keybindings listed below are configured by default. Additionally, if you
built ncspot with MPRIS support, you may be able to use media keys to control
playback depending on your desktop environment settings. Have a look at the
configuration section if you want to set custom bindings.

Navigation

Key	Command
?	Show help screen.
F1	Queue (See specific commands).
F2	Search.
F3	Library (See specific commands).
F8	Album Art (if built with the cover feature).
/	Open a Vim-like search bar (See specific commands).
:	Open a Vim-like command prompt (See specific commands).
Escape	Close Vim-like search bar, command prompt, or Search screen.
Q	Quit ncspot.
g	Go to the top of the current view (Vim motion).
G	Go to the bottom of the current view (Vim motion).

Playback

Key	Command
Return	Play track or playlist.
Space	Queue track or playlist.
.	Play the selected item after the currently playing track.
P	Move to the currently playing track in the queue.
S	Save the currently playing item to your library.
D	Remove the currently playing item from your library.
Shift+P	Toggle playback (i.e. Play/Pause).
Shift+S	Stop playback.
Shift+U	Update the library cache (tracks, artists, albums, playlists).
<	Play the previous track.
>	Play the next track.
F	Seek forward by 1 second.
Shift+F	Seek forward by 10 seconds.
B	Seek backward by 1 second.
Shift+B	Seek backward by 10 seconds.
-	Decrease volume by 1%.
+	Increase volume by 1%.
[	Decrease volume by 5%.
]	Increase volume by 5%.
R	Toggle Repeat mode.
Z	Toggle Shuffle state.

Context Menus

Key	Command
O	Open a detail view or context for the selected item.
Shift+O	Open a context menu for the currently playing track.
A	Open the album view for the selected item.
Shift+A	Open the artist view for the selected item.
M	Open the recommendations view for the selected item.
Shift+M	Open the recommendations view for the currently playing track.
Ctrl+V	Open the context menu for a Spotify link in your clipboard (if built with the share_clipboard feature).
Backspace	Close the current view.

When pressing O:

• If the selected item is not a track, it opens a detail view.
• If the selected item is a track, it opens a context menu with:
  • "Artist(s)" (let's you show or (un)follow a track's artist(s))
  • "Show Album"
  • "Share" (if built with the share_clipboard feature)
  • "Add to playlist"
  • "Similar tracks"

Sharing

(if built with the share_clipboard feature)

Key	Command
X	Copy the URL to the currently selected item to the system clipboard.
Shift+X	Copy the URL to the currently playing track to the system clipboard.

Queue

Key	Command
C	Clear the entire queue.
D	Delete the currently selected track.
Ctrl+S	Save the current queue.

Library

Key	Command
D	Delete the currently selected playlist.

Vim-Like Search Bar

Key	Command
n	Previous search occurrence.
N	Next search occurrence.

Vim-Like Commands

You can open a Vim-style command prompt using :, and close it at any
time with Escape.

The following is an abridged list of the more useful commands. For the full list, see source code.

Note: <FOO> - mandatory arg; [BAR] - optional arg

Command	Action
help	Show current key bindings.
quit Aliases: q, x	Quit ncspot.
logout	Remove any cached credentials from disk and quit ncspot.
playpause Aliases: pause, toggleplay, toggleplayback	Toggle playback.
stop	Stop playback.
seek [+|-]<TIME>	Seek to the specified position, or seek relative to current position by prepending +/-. * TIME is anything accepted by parse_duration * Default unit is ms for backward compatibility.
move <DIRECTION> <STEP_SIZE>	Scroll the current view up/down/left/right with integer step sizes, or pageup/pagedown/pageleft/pageright with float step sizes.
repeat [REPEAT_MODE] Alias: loop	Set repeat mode. Omit argument to step through the available modes. * Valid values for REPEAT_MODE: list (aliases: playlist, queue), track (aliases: once, single), none (alias: off)
shuffle [on|off]	Enable or disable shuffle. Omit argument to toggle.
previous	Play the previous track.
next	Play the next track.
focus <SCREEN>	Switch to a different view. * Valid values for SCREEN: queue, search, library, cover (if built with the cover feature)
search <SEARCH>	Search for a song/artist/album/etc.
clear	Clear the queue.
share <ITEM>	Copy a shareable URL of the item to the system clipboard. Requires the share_clipboard feature. * Valid values for ITEM: selected, current
newplaylist <NAME>	Create a new playlist.
sort <SORT_KEY> [SORT_DIRECTION]	Sort a playlist. * Valid values for SORT_KEY: title, album, artist, duration, added * Valid values for SORT_DIRECTION: ascending (default; aliases: a, asc), descending (aliases: d, desc)
exec <CMD>	Execute a command in the system shell. * Command output is printed to the terminal, so redirection (2> /dev/null) may be necessary.
noop	Do nothing. Useful for disabling default keybindings. See custom keybindings.
reload	Reload the configuration from disk. See Configuration.
reconnect	Reconnect to Spotify (useful when session has expired or connection was lost)
add [current]	Add selected track to playlist, if current is passed the currently playing track will be added
save [current]	Save selected item, if current is passed the currently playing item will be saved

---

The wiki shows only a minimal information about this

---

Navigation

Key	Command
?	Show the help screen.
F1	ÇQeue.
F2	Search.
F3	Library.
F8	Album cover (if created with the “cover” function).
/	Open a search bar similar to [Vim].
:	Open a command prompt similar to [Vim].
Esc	Close the search bar similar to [Vim] or the command prompt.
Q	Exit ncspot.
+	volup 1
_	voldown 1
<	playnext; move down 1
>	previous
?	help
Backspace	back
Ctrl+a	move left 1
Ctrl+e	move right 1
Ctrl+l	redraw
Ctrl+n	move down 1
Ctrl+p	move up 1
Ctrl+s	save queue
Ctrl+v	insert
Down	move down 1
End	move bottom
Enter	play
F1	focus queue
F2	focus search
F3	focus library
Home	move top
Left	move left 1
PageDown	move down 5
PageUp	move up 5
Right	move right 1
Shift+Down	shift down 1
Shift+Up	shift up 1
Shift+a	goto artist
Shift+b	seek -10000
Shift+f	seek +10000
Shift+m	similar current
Shift+n	jumpprevious
Shift+o	open current
Shift+p	playpause
Shift+s	stop
Shift+u	update
Shift+x	share current
Space	queue; move down 1
Up	move up 1
[	voldown 5
]	volup 5
a	goto album
b	seek -1000