Skip to content

Commit e08f98e

Browse files
shinokadashinokada
authored
Merge pull request #104 from shinokada/fix/i-feel-lucky-2
fix: tab toggles focus between genre input and history nav; add visual indicators * **New Features** * Tab-based focus toggling between Genre/keyword input and history navigation * Shuffle now supports optional auto-advance, backward navigation through shuffle history, and configurable history behavior * **Documentation** * Expanded README: input-focus guidance, updated keyboard shortcuts, example shuffle session, clearer Shuffle Settings, and OS-specific locations for a dedicated shuffle configuration file
2 parents 8aa3426 + 1c0fd3d commit e08f98e

File tree

3 files changed

+141
-89
lines changed

3 files changed

+141
-89
lines changed

‎docs/README.md‎

Lines changed: 25 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -360,6 +360,10 @@ Set a timer to automatically stop playback — useful for falling asleep to radi
360360

361361
Enter a keyword (genre, mood, style) and TERA finds a random matching station. Perfect for music discovery!
362362

363+
**Input Focus**: The page has two focusable areas — `Genre/keyword` (default) and `Choose an option` (history navigation). Use `Tab` to toggle between them:
364+
- `▶ Genre/keyword:` is highlighted when active — type freely, including keywords starting with digits (e.g. `80s`, `2pac`)
365+
- `▶ Choose an option:` is highlighted when active — use `↑↓`/`jk` to navigate history, or `1-N` shortcuts to pick a recent search
366+
363367
**Shuffle Mode**: Enable shuffle mode to automatically cycle through multiple stations matching your keyword:
364368
- Press `Ctrl+T` to toggle shuffle on/off
365369
- Stations play in random order without repeats
@@ -564,19 +568,20 @@ Shuffle mode is an enhanced version of "I Feel Lucky" that lets you explore mult
564568

565569
### Shuffle Keyboard Shortcuts
566570

567-
| Key | Action |
568-
| ----- | ------------------------------------- |
569-
| `Ctrl+T` | Toggle shuffle mode (in input screen) |
570-
| `n` | Next shuffle station (manual skip) |
571-
| `[` | Previous station (from history) |
572-
| `b` | Block current station |
573-
| `u` | Undo block (5 sec window) |
574-
| `p` | Pause/resume auto-advance timer |
575-
| `h` | Stop shuffle, keep playing current |
576-
| `f` | Save to My-favorites |
577-
| `s` | Save to another list |
578-
| `v` | Vote for station |
579-
| `Esc` | Stop shuffle and return to input |
571+
| Key | Action |
572+
| -------- | ----------------------------------------- |
573+
| `Ctrl+T` | Toggle shuffle mode (in input screen) |
574+
| `Tab` | Switch focus: Genre/keyword ↔ Choose an option |
575+
| `n` | Next shuffle station (manual skip) |
576+
| `[` | Previous station (from history) |
577+
| `b` | Block current station |
578+
| `u` | Undo block (5 sec window) |
579+
| `p` | Pause/resume auto-advance timer |
580+
| `h` | Stop shuffle, keep playing current |
581+
| `f` | Save to My-favorites |
582+
| `s` | Save to another list |
583+
| `v` | Vote for station |
584+
| `Esc` | Stop shuffle and return to input |
580585

581586
### Shuffle Settings
582587

@@ -622,9 +627,9 @@ Codec: AAC • Bitrate: 128 kbps
622627
Space: Pause • n: Next • [: Prev • f: Fav • b: Block • p: Pause timer • h: Stop shuffle • 0: Main Menu • ?: Help
623628
```
624629

625-
### Configuration
630+
### Configuration File
626631

627-
Shuffle settings are stored in the unified `config.yaml`:
632+
Shuffle settings are stored in a dedicated `shuffle.yaml` file (separate from `config.yaml`):
628633

629634
```yaml
630635
shuffle:
@@ -634,6 +639,11 @@ shuffle:
634639
max_history: 5 # Remember last 5 stations
635640
```
636641

642+
File location:
643+
- Linux: `~/.config/tera/shuffle.yaml`
644+
- macOS: `~/Library/Application Support/tera/shuffle.yaml`
645+
- Windows: `%APPDATA%\tera\shuffle.yaml`
646+
637647
You can edit this file directly or use the Settings menu.
638648

639649
## Keyboard Shortcuts

‎v3/README.md‎

Lines changed: 24 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -272,6 +272,10 @@ Set a timer to automatically stop playback — useful for falling asleep to radi
272272

273273
Enter a keyword (genre, mood, style) and TERA finds a random matching station. Perfect for music discovery!
274274

275+
**Input Focus**: The page has two focusable areas — `Genre/keyword` (default) and `Choose an option` (history navigation). Use `Tab` to toggle between them:
276+
- `▶ Genre/keyword:` is highlighted when active — type freely, including keywords starting with digits (e.g. `80s`, `2pac`)
277+
- `▶ Choose an option:` is highlighted when active — use `↑↓`/`jk` to navigate history, or `1-N` shortcuts to pick a recent search
278+
275279
**Shuffle Mode**: Enable shuffle mode to automatically cycle through multiple stations matching your keyword:
276280
- Press `Ctrl+T` to toggle shuffle on/off
277281
- Stations play in random order without repeats
@@ -474,20 +478,21 @@ Shuffle mode is an enhanced version of "I Feel Lucky" that lets you explore mult
474478

475479
### Shuffle Keyboard Shortcuts
476480

477-
| Key | Action |
478-
| ----- | ------------------------------------- |
479-
| `Ctrl+T` | Toggle shuffle mode (in input screen) |
480-
| `n` | Next shuffle station (manual skip) |
481-
| `[` | Previous station (from history) |
482-
| `b` | Block current station |
483-
| `u` | Undo block (5 sec window) |
484-
| `p` | Pause/resume auto-advance timer |
485-
| `h` | Stop shuffle, keep playing current |
486-
| `f` | Save to My-favorites |
487-
| `s` | Save to another list |
488-
| `v` | Vote for station |
489-
| `r` | Rate station (then 1-5 / 0) |
490-
| `Esc` | Stop shuffle and return to input |
481+
| Key | Action |
482+
| -------- | ----------------------------------------- |
483+
| `Ctrl+T` | Toggle shuffle mode (in input screen) |
484+
| `Tab` | Switch focus: Genre/keyword ↔ Choose an option |
485+
| `n` | Next shuffle station (manual skip) |
486+
| `[` | Previous station (from history) |
487+
| `b` | Block current station |
488+
| `u` | Undo block (5 sec window) |
489+
| `p` | Pause/resume auto-advance timer |
490+
| `h` | Stop shuffle, keep playing current |
491+
| `f` | Save to My-favorites |
492+
| `s` | Save to another list |
493+
| `v` | Vote for station |
494+
| `r` | Rate station (then 1-5 / 0) |
495+
| `Esc` | Stop shuffle and return to input |
491496

492497
### Shuffle Settings
493498

@@ -545,6 +550,11 @@ shuffle:
545550
max_history: 5 # Remember last 5 stations
546551
```
547552

553+
File location:
554+
- Linux: `~/.config/tera/shuffle.yaml`
555+
- macOS: `~/Library/Application Support/tera/shuffle.yaml`
556+
- Windows: `%APPDATA%\tera\shuffle.yaml`
557+
548558
You can edit this file directly or use the Settings menu.
549559

550560
## Keyboard Shortcuts

0 commit comments

Comments
 (0)