From 035283f42f1e7e766126b53bba0fed3511ae7509 Mon Sep 17 00:00:00 2001 From: oca-agent <277152249+oca-agent@users.noreply.github.com> Date: Mon, 18 May 2026 17:18:44 -0400 Subject: [PATCH 1/2] docs: remove category column from common settings table --- README.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 832b442..c4ea043 100644 --- a/README.md +++ b/README.md @@ -273,24 +273,24 @@ Create or edit `~/.config/smoc/config.json` to customize settings. #### Common Settings -| Category | Key | Type | Default Value | Description | -| :----------------- | :--------------------------------------------- | :----------------- | :----------------- | :------------------------------------------------------------------ | -| **Streaming** | `SmocConfiguration.ActiveService` | `StreamingService` | `YouTubeMusic` | Active service (`YouTubeMusic`, `Subsonic`) | -| **Subsonic** | `SubsonicConfig.ServerScheme` | `string` | `http` | URI Scheme for the Subsonic API | -| | `SubsonicConfig.ServerHost` | `string` | `null` | Hostname of your Subsonic server | -| | `SubsonicConfig.ServerPort` | `int` | `80` | Port of your Subsonic server | -| | `SubsonicConfig.Username` | `string` | `null` | Subsonic username | -| | `SubsonicConfig.Password` | `string` | `null` | Subsonic password | -| | `SubsonicConfig.UseToken` | `bool` | `true` | Whether to use token auth instead of plaintext password | -| **Caching** | `SmocConfiguration.SongCacheSizeBytes` | `long` | `536870912` | Max size of song cache in bytes (512MB, 0 = no limit) | -| | `SmocConfiguration.AlbumCoverCacheSizeBytes` | `long` | `104857600` | Max size of album cover cache in bytes (100MB, 0 = no limit) | -| | `SmocConfiguration.SongCacheMaxElements` | `int` | `0` | Max number of songs to cache (0 = no limit) | -| | `SmocConfiguration.AlbumCoverCacheMaxElements` | `int` | `0` | Max number of album covers to cache (0 = no limit) | -| **Logging** | `SmocConfiguration.LogLevel` | `LogLevel` | `Information` | Min log level (Trace, Debug, Information, Warning, Error, Critical) | -| **Listen History** | `ListenHistory.Enabled` | `bool` | `true` | Whether listen history tracking is enabled | -| | `ListenHistory.MinimumPositionSeconds` | `int` | `30` | Minimum position (seconds) to consider listened | -| | `ListenHistory.MinimumFraction` | `double` | `0.5` | Minimum fraction of a song to consider listened | -| **UI** | `Theme` | `string` | `default` | The name of the theme to use | +| Key | Type | Default Value | Description | +| :--------------------------------------------- | :----------------- | :----------------- | :------------------------------------------------------------------ | +| `SmocConfiguration.ActiveService` | `StreamingService` | `YouTubeMusic` | Active service (`YouTubeMusic`, `Subsonic`) | +| `SubsonicConfig.ServerScheme` | `string` | `http` | URI Scheme for the Subsonic API | +| `SubsonicConfig.ServerHost` | `string` | `null` | Hostname of your Subsonic server | +| `SubsonicConfig.ServerPort` | `int` | `80` | Port of your Subsonic server | +| `SubsonicConfig.Username` | `string` | `null` | Subsonic username | +| `SubsonicConfig.Password` | `string` | `null` | Subsonic password | +| `SubsonicConfig.UseToken` | `bool` | `true` | Whether to use token auth instead of plaintext password | +| `SmocConfiguration.SongCacheSizeBytes` | `long` | `536870912` | Max size of song cache in bytes (512MB, 0 = no limit) | +| `SmocConfiguration.AlbumCoverCacheSizeBytes` | `long` | `104857600` | Max size of album cover cache in bytes (100MB, 0 = no limit) | +| `SmocConfiguration.SongCacheMaxElements` | `int` | `0` | Max number of songs to cache (0 = no limit) | +| `SmocConfiguration.AlbumCoverCacheMaxElements` | `int` | `0` | Max number of album covers to cache (0 = no limit) | +| `SmocConfiguration.LogLevel` | `LogLevel` | `Information` | Min log level (Trace, Debug, Information, Warning, Error, Critical) | +| `ListenHistory.Enabled` | `bool` | `true` | Whether listen history tracking is enabled | +| `ListenHistory.MinimumPositionSeconds` | `int` | `30` | Minimum position (seconds) to consider listened | +| `ListenHistory.MinimumFraction` | `double` | `0.5` | Minimum fraction of a song to consider listened | +| `Theme` | `string` | `default` | The name of the theme to use | #### Custom Themes If specifying a custom theme (as in the example config above), you will need to specify styling for all schemes. From 52f123a4a93ba4e2bae0cd4f280c55af26f2e055 Mon Sep 17 00:00:00 2001 From: oca-agent <277152249+oca-agent@users.noreply.github.com> Date: Mon, 18 May 2026 17:20:46 -0400 Subject: [PATCH 2/2] docs: optimize common settings table to reduce width --- README.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index c4ea043..6a1526b 100644 --- a/README.md +++ b/README.md @@ -273,24 +273,24 @@ Create or edit `~/.config/smoc/config.json` to customize settings. #### Common Settings -| Key | Type | Default Value | Description | -| :--------------------------------------------- | :----------------- | :----------------- | :------------------------------------------------------------------ | -| `SmocConfiguration.ActiveService` | `StreamingService` | `YouTubeMusic` | Active service (`YouTubeMusic`, `Subsonic`) | -| `SubsonicConfig.ServerScheme` | `string` | `http` | URI Scheme for the Subsonic API | -| `SubsonicConfig.ServerHost` | `string` | `null` | Hostname of your Subsonic server | -| `SubsonicConfig.ServerPort` | `int` | `80` | Port of your Subsonic server | -| `SubsonicConfig.Username` | `string` | `null` | Subsonic username | -| `SubsonicConfig.Password` | `string` | `null` | Subsonic password | -| `SubsonicConfig.UseToken` | `bool` | `true` | Whether to use token auth instead of plaintext password | -| `SmocConfiguration.SongCacheSizeBytes` | `long` | `536870912` | Max size of song cache in bytes (512MB, 0 = no limit) | -| `SmocConfiguration.AlbumCoverCacheSizeBytes` | `long` | `104857600` | Max size of album cover cache in bytes (100MB, 0 = no limit) | -| `SmocConfiguration.SongCacheMaxElements` | `int` | `0` | Max number of songs to cache (0 = no limit) | -| `SmocConfiguration.AlbumCoverCacheMaxElements` | `int` | `0` | Max number of album covers to cache (0 = no limit) | -| `SmocConfiguration.LogLevel` | `LogLevel` | `Information` | Min log level (Trace, Debug, Information, Warning, Error, Critical) | -| `ListenHistory.Enabled` | `bool` | `true` | Whether listen history tracking is enabled | -| `ListenHistory.MinimumPositionSeconds` | `int` | `30` | Minimum position (seconds) to consider listened | -| `ListenHistory.MinimumFraction` | `double` | `0.5` | Minimum fraction of a song to consider listened | -| `Theme` | `string` | `default` | The name of the theme to use | +| Key | Type | Default | Description | +| :--------------------------------------------- | :--- | :------ | :---------- | +| `SmocConfiguration.ActiveService` | `StreamingService` | `YouTubeMusic` | Active service (`YouTubeMusic`, `Subsonic`) | +| `SubsonicConfig.ServerScheme` | `string` | `http` | Subsonic API URI scheme | +| `SubsonicConfig.ServerHost` | `string` | `null` | Subsonic server hostname | +| `SubsonicConfig.ServerPort` | `int` | `80` | Subsonic server port | +| `SubsonicConfig.Username` | `string` | `null` | Subsonic username | +| `SubsonicConfig.Password` | `string` | `null` | Subsonic password | +| `SubsonicConfig.UseToken` | `bool` | `true` | Use token auth instead of password | +| `SmocConfiguration.SongCacheSizeBytes` | `long` | `536870912` | Max song cache size in bytes | +| `SmocConfiguration.AlbumCoverCacheSizeBytes` | `long` | `104857600` | Max album cover cache size in bytes | +| `SmocConfiguration.SongCacheMaxElements` | `int` | `0` | Max songs to cache (0 = no limit) | +| `SmocConfiguration.AlbumCoverCacheMaxElements` | `int` | `0` | Max album covers to cache (0 = no limit) | +| `SmocConfiguration.LogLevel` | `LogLevel` | `Information` | Minimum log level | +| `ListenHistory.Enabled` | `bool` | `true` | Enable listen history tracking | +| `ListenHistory.MinimumPositionSeconds` | `int` | `30` | Min seconds for 'listened' status | +| `ListenHistory.MinimumFraction` | `double` | `0.5` | Min fraction for 'listened' status | +| `Theme` | `string` | `default` | Name of the theme to use | #### Custom Themes If specifying a custom theme (as in the example config above), you will need to specify styling for all schemes.