ferrosonic 0.8.2

A terminal-based Subsonic music client with bit-perfect audio playback
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

# Keybindings Reference

Ferrosonic is fully keyboard-driven. Vim-style `j`/`k` navigation is available alongside arrow keys throughout the application.

## Global

| Key | Action |
|---|---|
| `q` | Quit |
| `p` / `Space` | Toggle play/pause |
| `l` | Next track |
| `h` | Previous track |
| `shift + h` | Seek backward 5 seconds |
| `shift + l` | Seek forward 5 seconds |
| `Ctrl+R` | Refresh data from server |
| `t` | Cycle to next theme |
| `F1` | Browse page |
| `F2` | Artists page |
| `F3` | Queue page |
| `F4` | Playlists page |
| `F5` | Radio page |
| `F6` | Server configuration page |
| `F7` | Settings page |

## Songs Page (F1)

| Key | Action |
|---|---|
| `Tab` | Switch focus between song options and song list |
| `Up` / `k` | Move selection up |
| `Down` / `j` | Move selection down |
| `Enter` | Play selected song (queues all visible songs and starts from selection) |

The Songs page has two modes selectable from the options pane: **Starred** (your favourited songs) and **Random** (a random selection from the server).

## Artists Page (F2)

| Key | Action |
|---|---|
| `/` | Filter artists by name |
| `Esc` | Clear filter |
| `Up` / `k` | Move selection up |
| `Down` / `j` | Move selection down |
| `Left` / `Right` | Switch focus between tree and song list |
| `Enter` | Expand/collapse artist, or play album/song |
| `Backspace` | Return to tree from song list |
| `e` | Add selected item to end of queue |
| `n` | Add selected item as next in queue |
| `s` | Shuffle play all songs by the selected artist or album |

## Queue Page (F3)

| Key | Action |
|---|---|
| `Up` / `k` | Move selection up |
| `Down` / `j` | Move selection down |
| `Enter` | Play selected song |
| `d` | Remove selected song from queue |
| `J` (Shift+J) | Move selected song down |
| `K` (Shift+K) | Move selected song up |
| `s` | Shuffle queue (current song stays in place) |
| `c` | Clear played history (remove songs before current) |

## Playlists Page (F4)

| Key | Action |
|---|---|
| `Tab` / `Left` / `Right` | Switch focus between playlists and songs |
| `Up` / `k` | Move selection up |
| `Down` / `j` | Move selection down |
| `Enter` | Load playlist songs or play selected song |
| `e` | Add selected item to end of queue |
| `n` | Add selected song as next in queue |
| `s` | Shuffle play all songs in selected playlist |

## Radio Page (F5)

| Key | Action |
|---|---|
| `Up` / `k` | Move selection up |
| `Down` / `j` | Move selection down |
| `Enter` | Play selected station |
| `Space` | Play selected station, or toggle pause if it is already current |
| `Ctrl+R` | Refresh all data, including radio stations |

The Radio page lists internet radio stations from servers that support the Subsonic `getInternetRadioStations` endpoint, such as Navidrome.

## Server Page (F6)

| Key | Action |
|---|---|
| `Tab` | Move between fields |
| `Enter` | Test connection or Save configuration |
| `Backspace` | Delete character in text field |

## Settings Page (F7)

| Key | Action |
|---|---|
| `Up` / `Down` | Move between settings |
| `Left` | Previous option |
| `Right` / `Enter` | Next option |

Settings include theme selection and cava visualizer toggle. Changes are saved automatically.