wehub-resource-sync
187 lines
7.3 KiB
Markdown
187 lines
7.3 KiB
Markdown
# Keybindings
|
||
|
||
Press `?` or `Ctrl+K` in the player to see all keybindings.
|
||
|
||
## Playback
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `Space` | Play / Pause |
|
||
| `s` | Stop |
|
||
| `>` `.` | Next track |
|
||
| `<` `,` | Previous track |
|
||
| `Left` `Right` | Seek -/+5s |
|
||
| `Shift+Left` `Shift+Right` | Seek -/+30s (configurable) |
|
||
| `N` then `j` | Seek to N×10% of the track (e.g. `7j` jumps to 70%, `0j` to the start) |
|
||
| `+` `-` | Volume up/down |
|
||
| `]` `[` | Speed up/down (±0.25x) |
|
||
| `m` | Toggle mono |
|
||
| `Ctrl+J` | Jump to time |
|
||
|
||
## Navigation
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `Tab` | Toggle focus (Playlist / EQ) |
|
||
| `j` `k` / `Up` `Down` | Playlist scroll / EQ band adjust (wraps around) |
|
||
| `PageUp` `PageDown` / `Ctrl+U` `Ctrl+D` | Scroll playlist/file browser by page |
|
||
| `Home` `End` / `g` `G` | Go to top/end of playlist/file browser |
|
||
| `Shift+Up` `Shift+Down` | Move track up/down in playlist/queue |
|
||
| `h` `l` | EQ cursor left/right |
|
||
| `Enter` | Play selected track |
|
||
| `/` | Search playlist (navigate results with `↑` `↓` / `Ctrl+N` `Ctrl+P`; page scroll with `Ctrl+U` `Ctrl+D`) |
|
||
| `Ctrl+X` | Expand/collapse playlist |
|
||
| `o` | Open file browser |
|
||
| `b` `Esc` | Back to provider |
|
||
|
||
|
||
## EQ and Appearance
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `e` | Cycle EQ preset |
|
||
| `t` | Choose theme |
|
||
| `v` | Cycle visualizer |
|
||
| `Ctrl+V` | Pick visualizer from a list (live preview) |
|
||
| `V` | Full screen visualizer |
|
||
| `Ctrl+H` | Toggle album headers |
|
||
|
||
## Features
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `f` | Toggle bookmark ★ on selected track (or favorite radio station in radio browser) |
|
||
| `Ctrl+F` | Search — active provider's native search (Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, NetEase, Local) or YouTube fallback. Available from playlist and provider-browser views. |
|
||
| `u` | Load URL (stream/playlist) |
|
||
| `y` | Show lyrics |
|
||
| `Ctrl+S` | Save track to ~/Music |
|
||
| `w` | Write the highlighted track to a local playlist |
|
||
| `N` | Navidrome browser |
|
||
| `L` | Browse local playlists (with cliamp radio) |
|
||
| `R` | Open radio provider |
|
||
| `S` | Open Spotify provider |
|
||
| `P` | Open Plex provider |
|
||
| `J` | Open Jellyfin provider |
|
||
| `E` | Open Emby provider |
|
||
| `Y` | Open YouTube provider |
|
||
| `C` | Open SoundCloud provider |
|
||
| `M` | Open NetEase provider |
|
||
| `Q` | Open Qobuz provider |
|
||
|
||
## Playlist and Queue
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `a` | Toggle queue (play next) |
|
||
| `A` | Queue manager |
|
||
| `x` | Remove the highlighted track from the current playlist |
|
||
| `p` | Playlist manager |
|
||
| `r` | Cycle repeat (Off / All / One) |
|
||
| `z` | Toggle shuffle |
|
||
|
||
### Inside the playlist manager
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `↑` `↓` / `j` `k` | Move cursor |
|
||
| `/` | Filter (incremental); `Esc` clears |
|
||
| `Enter` / `→` | List screen: open the highlighted playlist · Tracks screen: play the **highlighted** track |
|
||
| `p` | Tracks screen: play all from the top |
|
||
| `a` | List: add the now-playing track to the highlighted playlist. Tracks: mark/unmark all visible tracks. |
|
||
| `w` | List: save the current queue through the playlist picker. Tracks: copy marked/highlighted tracks to another playlist. |
|
||
| `Space` | Tracks: mark/unmark highlighted track and advance |
|
||
| `[` `]` | Tracks: move highlighted track and save the playlist |
|
||
| `s` | Tracks: sort and save, cycling `track`, `title`, `artist`, `album`, `artist+album`, `path` |
|
||
| `o` | Tracks: open file browser to add files to this playlist |
|
||
| `r` | List: rename the playlist |
|
||
| `d` | List: delete playlist (confirms). Tracks: remove marked tracks, or highlighted track when none are marked |
|
||
| `u` | Undo the last manager edit |
|
||
| `←` `Backspace` `h` | Tracks screen: go back to the list |
|
||
| `Esc` | Close the playlist manager or go back |
|
||
|
||
Shift-letter keys are reserved for provider switching, so playlist-manager track actions use lowercase or punctuation keys.
|
||
|
||
## File browser
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `↑` `↓` / `j` `k` | Move cursor |
|
||
| `←` `→` / `h` `l` / `Enter` | Back / open directory or file |
|
||
| `/` | Filter files |
|
||
| `Space` | Select or unselect file/directory |
|
||
| `a` | Select/unselect all visible audio files |
|
||
| `R` | Replace the current queue with selected files |
|
||
| `w` | Write selected files to a local playlist |
|
||
| `~` `.` | Jump to home / current working directory |
|
||
| `Esc` `o` | Close file browser |
|
||
|
||
## Provider browser (`N` key)
|
||
|
||
When you press `N` to drill into a provider (Navidrome, Plex, Jellyfin, Emby, Spotify, Qobuz, YouTube Music), the album/artist/track screens use:
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `↑` `↓` / `j` `k` | Move cursor (wraps top↔bottom) |
|
||
| `←` `→` / `h` `l` | Back / drill in |
|
||
| `/` | Filter the visible list (search bar appears under the title) |
|
||
| `Enter` | Open (artists/albums) · play the highlighted track and queue the rest of the visible list |
|
||
| `R` | Replace the queue with all visible tracks (start from the top) |
|
||
| `a` | Append all visible tracks to the queue |
|
||
| `q` | Queue the highlighted track to play next |
|
||
| `s` | Cycle album sort (album list only) |
|
||
| `S` `N` `P` `J` `E` `Y` `C` `M` `Q` `L` `R` | Quick-switch to that provider without going back through the main pane |
|
||
| `Esc` `b` | Walk back one level / close the browser |
|
||
|
||
The track screen shows a `N tracks · 47:22` subtitle and right-aligned per-track durations when the provider returns them.
|
||
|
||
## Provider playlist list
|
||
|
||
The playlists pane (visible when focus is on a provider — Spotify, Navidrome, Local Playlists, etc.):
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `↑` `↓` / `j` `k` | Move cursor (wraps) |
|
||
| `Ctrl+U` `Ctrl+D` | Scroll by page |
|
||
| `Enter` | Load the highlighted playlist's tracks into the queue |
|
||
| `/` | Filter the playlist list |
|
||
| `Ctrl+F` | Online/server search (Spotify/Navidrome/NetEase/etc.'s own search) |
|
||
| `Ctrl+R` | Refresh — re-pull the playlist list from the provider |
|
||
| `S` `N` `P` `J` `E` `Y` `C` `M` `Q` `L` `R` | Switch to that provider |
|
||
| `Tab` | Switch focus to EQ |
|
||
| `Esc` `b` | Back to the playlist pane |
|
||
|
||
Playlist rows show `Name · N tracks · 1h 23m` when the provider returns track counts and total duration. The currently loaded playlist is marked with a `▶` prefix. Spotify groups its playlists under section headers (`── library ──`, `── your playlists ──`, `── followed playlists ──`).
|
||
|
||
## Search results overlays
|
||
|
||
When `Ctrl+F` opens provider search or YouTube/SoundCloud net search and you're viewing the results list:
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `↑` `↓` / `j` `k` / `Ctrl+N` `Ctrl+P` | Move cursor (single item) |
|
||
| `Ctrl+U` `Ctrl+D` | Scroll results by page |
|
||
| `Enter` | Play the selected track now |
|
||
| `a` | Append the selected track to the playlist |
|
||
| `q` | Queue the selected track to play next |
|
||
| `p` | (Spotify only) Save the selected track to a Spotify playlist |
|
||
| `Esc` `Backspace` | Back to the search input |
|
||
|
||
## Fuzzy search
|
||
|
||
The local search boxes match fuzzily: your query characters only need to appear in order, not contiguously, and results are ranked by relevance (best match first). For example, `skr` or `saku` both find a track titled "Sakura".
|
||
|
||
This applies to:
|
||
|
||
- `/` playlist search
|
||
- `/` file browser filter
|
||
- `Ctrl+F` when the active provider is Local (your saved playlists)
|
||
|
||
Other `Ctrl+F` providers (Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, NetEase, YouTube) send your query to their own search API, so matching there follows each service's rules.
|
||
|
||
## General
|
||
|
||
| Key | Action |
|
||
|---|---|
|
||
| `?` / `Ctrl+K` | Show keymap |
|
||
| `q` | Quit |
|