Merge pull request #113 from shinokada/feat/v3.7

feat: v3.7.0 Play history
* **New Features**
  * Recently Played section in main menu (below Quick Play) with keyboard shortcuts and playback from recent list
  * Play History settings: enable/disable, size, duplicate handling, clear history

* **Changed**
  * “Search History” renamed to “History” to consolidate search and play history controls
  * Quick Play layout and shortcut numbering updated
  * Play History now persisted with sensible defaults and validation

* **Documentation**
  * README and guides updated for Recently Played and History settings

* **Tests**
  * Added tests for Recently Played and Play History defaults/validation

Author: shinokada

v3/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to TERA will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.7.0] - 2026-03-08
+
+### Added
+- **Recently Played** — Last N stations now appear in the main menu below Quick Play Favorites, with number shortcuts continuing from where Quick Play ends.
+  - Navigate and play with `↑↓` + `Enter` or number shortcuts
+  - Shows station name, country, and time since last played
+  - `▶` indicator marks the currently playing station
+  - Zero new storage — reuses `station_metadata.json` via `MetadataManager`
+- **Play History settings** (`Settings > History > Play History`)
+  - Toggle show/hide (`1`)
+  - Increase/decrease section size, 1–20 stations (`2`/`3`)
+  - Toggle Allow Duplicate (`4`)
+  - Clear all play history (`5`)
+- **History top-level menu** — `Settings > 5. History` now acts as a switcher between Search History and Play History sub-menus, with stats (search items count, tracked stations count).
+
+### Changed
+- Settings menu item `Search History` renamed to `History` to cover both search and play history.
+- `PlayHistoryConfig` added to unified `config.yaml` (`play_history` section).
+
+### Tests
+- Added `internal/ui/app_test.go`: `TestLoadRecentlyPlayed_*` and `TestPlayRecentStation_*` covering disabled state, nil manager, empty history, size clamping, valid/invalid indices.
+- `internal/config/config_test.go`: `TestPlayHistoryConfigDefaults` and `TestPlayHistoryConfigValidation` (added in Phase 1).
+
 ## [3.5.1] - 2026-02-26
 
 * **Documentation**

v3/README.md

@@ -10,6 +10,7 @@ A terminal-based internet radio player powered by [Radio Browser](https://www.ra
 - ⭐ **Star Ratings** - Rate stations 1-5 stars and browse your top-rated collection
 - 🏷️ **Custom Tags** - Tag stations with personal labels and build dynamic playlists
 - ⚡ **Quick Play** - Direct playback from main menu (shortcuts 10-99+)
+- 🕐 **Recently Played** - Last N stations shown below Quick Play Favorites in the main menu
 - 🔊 **Playback Control** - Play/pause with persistent status, adjust volume, and mute during playback
 - 🚫 **Block List** - Block unwanted stations from appearing in searches and auto-play
 - ☁️ **Gist Sync** - Backup and restore favorites via GitHub Gists
@@ -300,7 +301,7 @@ Access app configuration from the main menu (Settings: `-`):
 - **Appearance** - Customize header display (text, ASCII art, alignment, colors, padding)
 - **Connection Settings** - Auto-reconnect and buffering for unstable networks (4G/GPRS)
 - **Shuffle Settings** - Configure shuffle mode behavior (auto-advance, history size)
-- **Search History** - View and clear your search history
+- **History** - Search history and Recently Played display settings
 - **Check for Updates** - View current version and check for new releases
 - **About TERA** - See version, installation method, and update command
 
@@ -338,40 +339,45 @@ For users on unstable networks (mobile data, GPRS, 4G), configure automatic reco
 
 Settings stored in the config directory (see [File Locations](#file-locations)).
 
-### Quick Play from Main Menu
+### Quick Play & Recently Played
 
-The main menu shows your "My-favorites" list with shortcuts 10-99+. Type the number to play instantly:
+The main menu shows two instant-access sections below the regular menu:
 
-```
+```text
 Main Menu & Quick Play
 
 Choose an option:
 
   1. Play from Favorites
-  2. Search Stations
-  3. Most Played
-  4. Top Rated
-  5. Browse by Tag
-  6. Tag Playlists 
-  7. Manage Lists
-  8. Block List
-  9. I Feel Lucky
-  0. Gist Management
+  ...
   -. Settings
 
 ─── Quick Play Favorites ───
   10. Jazz FM • UK • MP3 192kbps
   11. BBC Radio 6 Music • UK • AAC 128kbps
-  12. KEXP 90.3 FM • US • AAC 128kbps
 
-Type 10-12 to play instantly!
+─── Recently Played ───
+  12. WBGO Jazz 88.3 • United States • 3 minutes ago
+  13. FIP • France • 1 hour ago
+  14. Radio Swiss Jazz • Switzerland • Yesterday
+
+Type 10-14 to play instantly!
 ```
 
+**Quick Play Favorites:** Stations from "My-favorites.json" with shortcuts starting at 10.
+
+**Recently Played:** Your last N stations (default 5), shown in most-recently-played order. Shortcuts continue from where Quick Play Favorites end.
+
 **How it works:**
-- Stations from "My-favorites.json" appear with shortcuts 10+
-- Type the number (e.g., `11`) and press Enter
-- Station plays immediately
+- Type the shortcut number and press Enter, or navigate with `↑↓` and press Enter
+- Station plays immediately via the shared player
 - Press `Esc` to stop playback
+- The `▶` indicator marks the currently playing station in both sections
+
+**Configure Recently Played:**
+1. Press `-` from the main menu → Settings
+2. Select **5. History → 2. Play History**
+3. Toggle show/hide, adjust size (1-20), toggle allow duplicate, or clear history
 
 ## Theme Configuration
 
@@ -584,7 +590,7 @@ You can edit this file directly or use the Settings menu.
 | -------- | ---------------------------- |
 | `0`      | Gist Management              |
 | `1-9`    | Quick select menu item       |
-| `10-99+` | Quick play from My-favorites |
+| `10-99+` | Quick play from My-favorites / Recently Played |
 | `-`      | Settings                     |
 
 ### Playback Controls

v3/internal/config/config.go

@@ -13,12 +13,13 @@ const (
 
 // Config represents the unified application configuration
 type Config struct {
-	Version   string          `yaml:"version"`
-	Player    PlayerConfig    `yaml:"player"`
-	UI        UIConfig        `yaml:"ui"`
-	Network   NetworkConfig   `yaml:"network"`
-	Shuffle   ShuffleConfig   `yaml:"shuffle"`
-	Blocklist BlocklistConfig `yaml:"blocklist"`
+	Version     string            `yaml:"version"`
+	Player      PlayerConfig      `yaml:"player"`
+	UI          UIConfig          `yaml:"ui"`
+	Network     NetworkConfig     `yaml:"network"`
+	Shuffle     ShuffleConfig     `yaml:"shuffle"`
+	Blocklist   BlocklistConfig   `yaml:"blocklist"`
+	PlayHistory PlayHistoryConfig `yaml:"play_history"`
 }
 
 // PlayerConfig represents player settings
@@ -83,6 +84,22 @@ type ShuffleConfig struct {
 	MaxHistory      int  `yaml:"max_history"` // Number of stations to remember
 }
 
+// PlayHistoryConfig holds Recently Played display settings for the main menu
+type PlayHistoryConfig struct {
+	Enabled        bool `yaml:"enabled"`         // Show Recently Played section in main menu (default: true)
+	Size           int  `yaml:"size"`            // Number of stations to display, range [1, 20] (default: 5)
+	AllowDuplicate bool `yaml:"allow_duplicate"` // Allow same station to appear more than once (default: false)
+}
+
+// DefaultPlayHistoryConfig returns a PlayHistoryConfig with sensible defaults.
+func DefaultPlayHistoryConfig() PlayHistoryConfig {
+	return PlayHistoryConfig{
+		Enabled:        true,
+		Size:           5,
+		AllowDuplicate: false,
+	}
+}
+
 // DefaultConfig returns a new Config with sensible defaults
 func DefaultConfig() Config {
 	return Config{
@@ -138,6 +155,7 @@ func DefaultConfig() Config {
 			RememberHistory: true,
 			MaxHistory:      5,
 		},
+		PlayHistory: DefaultPlayHistoryConfig(),
 	}
 }
 
@@ -170,6 +188,11 @@ func (c *Config) Validate() error {
 		errs = append(errs, fmt.Sprintf("shuffle: %v", err))
 	}
 
+	// Validate PlayHistory config
+	if err := c.PlayHistory.Validate(); err != nil {
+		errs = append(errs, fmt.Sprintf("play_history: %v", err))
+	}
+
 	if len(errs) > 0 {
 		return errors.New(strings.Join(errs, "; "))
 	}
@@ -436,3 +459,22 @@ func (s *ShuffleConfig) Validate() error {
 	}
 	return nil
 }
+
+// Validate validates PlayHistoryConfig, clamping Size to [1, 20].
+func (p *PlayHistoryConfig) Validate() error {
+	var errs []string
+
+	if p.Size < 1 {
+		p.Size = 1
+		errs = append(errs, "size must be >= 1, set to 1")
+	}
+	if p.Size > 20 {
+		p.Size = 20
+		errs = append(errs, "size must be <= 20, set to 20")
+	}
+
+	if len(errs) > 0 {
+		return errors.New(strings.Join(errs, "; "))
+	}
+	return nil
+}