fix(news): make every offered font work, and document every setting

README.md

@@ -135,7 +135,7 @@ curl -X POST http://your-pi-ip:5000/api/v3/plugins/install \
 
 | Plugin | Description | Preview |
 |--------|-------------|---------|
-| [News Ticker](./plugins/news/) | RSS news headlines from ESPN, NCAA, custom sources | |
+| [News Ticker](./plugins/news/) | RSS news headlines from ESPN, NCAA, custom sources | <a href="./plugins/news/"><img src="./docs/assets/news/hero.png" width="240" alt="news on an LED panel"></a> |
 | [Of The Day](./plugins/of-the-day/) | Daily quotes, Bible verses, word of the day | <a href="./plugins/of-the-day/"><img src="./docs/assets/of-the-day/hero.png" width="240" alt="of-the-day on an LED panel"></a> |
 
 ### Integrations (2)

docs/assets/news/fixtures/espn-feeds.json

@@ -0,0 +1 @@
+{"news_MLB_2026090217":[{"feed_name":"MLB","title":"'This is all anonymous?': MLB players unfiltered on salary cap, CBA talks and -- whether there will be a 2027 season","description":"We asked more than two dozen major leaguers to weigh in on the state of baseball's labor negotiations.","published":"Wed, 2 Sep 2026 12:49:13 EST","link":"https://www.espn.com/mlb/story/_/id/49786246/mlb-labor-2026-players-survey-salary-cap-cba-negotiations-lockout-mlbpa","timestamp":"2026-09-02T17:00:00"},{"feed_name":"MLB","title":"Kroenke buying Angels; sale for $4B, sources say","description":"Stan Kroenke has reached an agreement to acquire controlling interest in the Los Angeles Angels from Arte Moreno.","published":"Wed, 2 Sep 2026 12:49:17 EST","link":"https://www.espn.com/mlb/story/_/id/49795578/kroenke-buy-controlling-interest-angels-moreno","timestamp":"2026-09-02T17:00:00"},{"feed_name":"MLB","title":"Trout on 'needed' Angels sale: It's a 'fresh start'","description":"Mike Trout said he was \"excited\" at the news of the Angels' sale to Stan Kroenke, pointing to the new owner's track record when it comes to his other teams.","published":"Wed, 2 Sep 2026 12:49:17 EST","link":"https://www.espn.com/mlb/story/_/id/49798568/mike-trout-needed-sale-angels-fresh-start","timestamp":"2026-09-02T17:00:00"},{"feed_name":"MLB","title":"Padres call up 20-year-old catching prospect Salas","description":"The Padres selected the contract of 20-year-old catcher Ethan Salas from Triple-A El Paso on Tuesday, making him the youngest active player in the major leagues.","published":"Wed, 2 Sep 2026 12:49:17 EST","link":"https://www.espn.com/mlb/story/_/id/49797349/padres-call-20-year-old-catching-prospect-ethan-salas","timestamp":"2026-09-02T17:00:00"},{"feed_name":"MLB","title":"Dodgers' Smith, Rushing, Wrobleski back for push","description":"The Dodgers welcomed back starting catcher Will Smith, backup Dalton Rushing and pitcher Justin Wrobleski from the injured list Tuesday, bolstering their bench and bullpen for the final month of the season.","published":"Wed, 2 Sep 2026 12:49:17 EST","link":"https://www.espn.com/mlb/story/_/id/49800590/dodgers-get-smith-rushing-wrobleski-back-il","timestamp":"2026-09-02T17:00:00"},{"feed_name":"MLB","title":"Dandy debuts for Morales, Simpson key Nats' win","description":"Yohandy Morales had three hits, including a home run, and Jared Simpson threw three perfect innings to pick up the victory, and Washington Nationals, with their expanded roster of minor league call-ups, defeated the Atlanta Braves 9-5 on Tuesday night.","published":"Wed, 2 Sep 2026 12:49:17 EST","link":"https://www.espn.com/mlb/story/_/id/49799673/memorable-debuts-morales-simpson-key-nationals-win","timestamp":"2026-09-02T17:00:00"}],"news_NFL_2026090217":[{"feed_name":"NFL","title":"Facts vs. Feelings: Should you be in or out on these seven players?","description":"In advance of the biggest draft weekend, Liz Loza reveals her strongest thoughts to help you have a successful draft.","published":"Wed, 2 Sep 2026 14:30:32 EST","link":"https://www.espn.com/fantasy/football/story/_/id/49798112/2026-fantasy-football-facts-vs-feelings-ladd-mcconkey-bucky-irving-lamar-jackson-colston-loveland","timestamp":"2026-09-02T17:00:00"},{"feed_name":"NFL","title":"10 bold predictions: Which players will surprise in fantasy?","description":"Our fantasy analysts picked their favorite \"out on a limb\" predictions for the NFL season ahead.","published":"Wed, 2 Sep 2026 14:30:32 EST","link":"https://www.espn.com/fantasy/football/story/_/id/49755632/fantasy-football-2026-rankings-bold-predictions","timestamp":"2026-09-02T17:00:00"},{"feed_name":"NFL","title":"Raiders name Cousins starting QB for Week 1","description":"Kirk Cousins will begin the season as the Raiders' starting quarterback over rookie Fernando Mendoza.","published":"Wed, 2 Sep 2026 16:52:25 EST","link":"https://www.espn.com/nfl/story/_/id/49804802/raiders-name-kirk-cousins-starting-qb-week-1-fernando-mendoza","timestamp":"2026-09-02T17:00:00"},{"feed_name":"NFL","title":"Hurts agrees that he, Brown grew apart: 'Clearly'","description":"Eagles quarterback Jalen Hurts confirmed former teammate A.J. Brown's comments that the two had grown apart last season in QB's interview with GQ magazine.","published":"Wed, 2 Sep 2026 16:52:25 EST","link":"https://www.espn.com/nfl/story/_/id/49804039/eagles-hurts-agrees-brown-grew-apart-last-season","timestamp":"2026-09-02T17:00:00"},{"feed_name":"NFL","title":"49ers star DE Bosa takes big step toward return","description":"49ers defensive end Nick Bosa took a big step toward returning to play Wednesday when he participated in a full practice for the first time since tearing his right anterior cruciate ligament in Week 3 of last season.","published":"Wed, 2 Sep 2026 16:52:26 EST","link":"https://www.espn.com/nfl/story/_/id/49806533/49ers-nick-bosa-practices-fully-first-acl-injury","timestamp":"2026-09-02T17:00:00"},{"feed_name":"NFL","title":"Emmitt Smith, his company cited in $2.5M suit","description":"A Native American development group says Pro Football Hall of Famer Emmitt Smith and his company misappropriated a loan intended to fund a solar farm project in Texas.","published":"Wed, 2 Sep 2026 16:52:26 EST","link":"https://www.espn.com/nfl/story/_/id/49805648/emmitt-smith-company-cited-fraud-claim","timestamp":"2026-09-02T17:00:00"}],"news_TOP SPORTS_2026090217":[{"feed_name":"TOP SPORTS","title":"Clippers lose five first-round picks, fined $30M","description":"Among the punishments announced by the NBA following an investigation into the Clippers: a loss of five first-round draft picks and a fine of $30M. Owner Steve Ballmer is suspended from all league and team activities for one year.","published":"Wed, 2 Sep 2026 16:47:28 EST","link":"https://www.espn.com/nba/story/_/id/49806356/nba-announces-punishments-clippers-kawhi-probe","timestamp":"2026-09-02T17:00:00"},{"feed_name":"TOP SPORTS","title":"Tiger's license suspended 5 years after plea deal","description":"Tiger Woods had his driver's license suspended five years Wednesday after striking a plea deal in his DUI case.","published":"Wed, 2 Sep 2026 17:22:36 EST","link":"https://www.espn.com/golf/story/_/id/49802892/tiger-woods-strikes-plea-deal-driver-license-suspended-5-years","timestamp":"2026-09-02T17:00:00"},{"feed_name":"TOP SPORTS","title":"Georgia AG to SEC: Oust LSU if Kiffin plays pros","description":"Georgia Attorney General Chris Carr is encouraging Greg Sankey to take \"all measures available,\" including suspending and/or removing LSU from the SEC if the Tigers roster former NFL players.","published":"Wed, 2 Sep 2026 17:22:36 EST","link":"https://www.espn.com/college-football/story/_/id/49806514/georgia-ag-sec-take-all-measures-available-lsu-plays-pros","timestamp":"2026-09-02T17:00:00"},{"feed_name":"TOP SPORTS","title":"Carr, Manning top packed Heisman odds boards","description":"Notre Dame quarterback CJ Carr and Texas quarterback Arch Manning are the favorites to win the Heisman Trophy, but the odds at sportsbooks suggest it's a wide-open race.","published":"Wed, 2 Sep 2026 17:22:35 EST","link":"https://www.espn.com/college-football/story/_/id/49804905/cj-carr-arch-manning-lead-congested-heisman-oddsboards","timestamp":"2026-09-02T17:00:00"},{"feed_name":"TOP SPORTS","title":"Vikings GM expects McCarthy on Week 1 roster","description":"Vikings general manager Nolan Teasley said Wednesday he expects quarterback J.J. McCarthy to be a part of the team when the regular season begins.","published":"Wed, 2 Sep 2026 17:22:36 EST","link":"https://www.espn.com/nfl/story/_/id/49805381/vikings-gm-expects-mccarthy-week-1-roster-develop","timestamp":"2026-09-02T17:00:00"},{"feed_name":"TOP SPORTS","title":"49ers star DE Bosa takes big step toward return","description":"49ers defensive end Nick Bosa took a big step toward returning to play Wednesday when he participated in a full practice for the first time since tearing his right anterior cruciate ligament in Week 3 of last season.","published":"Wed, 2 Sep 2026 17:22:36 EST","link":"https://www.espn.com/nfl/story/_/id/49806533/49ers-nick-bosa-practices-fully-first-acl-injury","timestamp":"2026-09-02T17:00:00"}]}

docs/assets/news/shots.json

@@ -0,0 +1,253 @@
+{
+  "plugin": "news",
+  "defaults": {
+    "width": 128,
+    "height": 32,
+    "scale": 6,
+    "freeze_time": "2026-09-02T21:00:00+00:00",
+    "mock_data": "fixtures/espn-feeds.json",
+    "config": {
+      "enabled": true,
+      "feeds": {
+        "enabled_feeds": [
+          "MLB",
+          "NFL",
+          "TOP SPORTS"
+        ]
+      }
+    }
+  },
+  "shots": [
+    {
+      "name": "hero",
+      "frames": 60,
+      "config": {
+        "global": {
+          "font_size": 8
+        }
+      },
+      "width": 256,
+      "scale": 4
+    },
+    {
+      "name": "size-12",
+      "frames": 60,
+      "config": {
+        "global": {
+          "font_size": 12
+        }
+      },
+      "standalone": false
+    },
+    {
+      "name": "size-8",
+      "frames": 60,
+      "config": {
+        "global": {
+          "font_size": 8
+        }
+      },
+      "standalone": false
+    },
+    {
+      "name": "size-6",
+      "frames": 60,
+      "config": {
+        "global": {
+          "font_size": 6
+        }
+      },
+      "standalone": false
+    },
+    {
+      "name": "col-default",
+      "frames": 300,
+      "config": {
+        "global": {
+          "font_size": 8
+        }
+      },
+      "width": 256,
+      "scale": 4,
+      "standalone": false
+    },
+    {
+      "name": "col-amber",
+      "frames": 300,
+      "config": {
+        "global": {
+          "font_size": 8
+        },
+        "feeds": {
+          "text_color": [
+            255,
+            176,
+            0
+          ],
+          "separator_color": [
+            255,
+            90,
+            0
+          ]
+        }
+      },
+      "width": 256,
+      "scale": 4,
+      "standalone": false
+    },
+    {
+      "name": "col-green",
+      "frames": 300,
+      "config": {
+        "global": {
+          "font_size": 8
+        },
+        "feeds": {
+          "text_color": [
+            0,
+            255,
+            120
+          ],
+          "separator_color": [
+            0,
+            140,
+            200
+          ]
+        }
+      },
+      "width": 256,
+      "scale": 4,
+      "standalone": false
+    },
+    {
+      "name": "col-mono",
+      "frames": 300,
+      "config": {
+        "global": {
+          "font_size": 8
+        },
+        "feeds": {
+          "text_color": [
+            255,
+            255,
+            255
+          ],
+          "separator_color": [
+            255,
+            255,
+            255
+          ]
+        }
+      },
+      "width": 256,
+      "scale": 4,
+      "standalone": false
+    },
+    {
+      "name": "panel-64",
+      "frames": 60,
+      "config": {
+        "global": {
+          "font_size": 6
+        }
+      },
+      "width": 64,
+      "scale": 8,
+      "standalone": false
+    },
+    {
+      "name": "panel-128",
+      "frames": 60,
+      "config": {
+        "global": {
+          "font_size": 8
+        }
+      },
+      "width": 128,
+      "scale": 8,
+      "standalone": false
+    },
+    {
+      "name": "panel-256",
+      "frames": 60,
+      "config": {
+        "global": {
+          "font_size": 8
+        }
+      },
+      "width": 256,
+      "scale": 4,
+      "standalone": false
+    }
+  ],
+  "composites": [
+    {
+      "name": "font-size",
+      "columns": 1,
+      "cells": [
+        {
+          "shot": "size-12",
+          "label": "font_size: 12",
+          "sublabel": "the default; about ten characters on a 128-wide panel"
+        },
+        {
+          "shot": "size-8",
+          "label": "font_size: 8",
+          "sublabel": "noticeably more headline on screen at once"
+        },
+        {
+          "shot": "size-6",
+          "label": "font_size: 6",
+          "sublabel": "the most text, at the limit of legibility across a room"
+        }
+      ]
+    },
+    {
+      "name": "colors",
+      "columns": 1,
+      "cells": [
+        {
+          "shot": "col-default",
+          "label": "The defaults",
+          "sublabel": "white headlines, red separator"
+        },
+        {
+          "shot": "col-amber",
+          "label": "Amber",
+          "sublabel": "feeds.text_color and feeds.separator_color"
+        },
+        {
+          "shot": "col-green",
+          "label": "Green",
+          "sublabel": ""
+        },
+        {
+          "shot": "col-mono",
+          "label": "All white",
+          "sublabel": "separator matched to the text"
+        }
+      ]
+    },
+    {
+      "name": "panel-sizes",
+      "columns": 1,
+      "cells": [
+        {
+          "shot": "panel-64",
+          "label": "64 x 32",
+          "sublabel": "font_size 6; only a few characters at a time"
+        },
+        {
+          "shot": "panel-128",
+          "label": "128 x 32",
+          "sublabel": "font_size 8; the common two-panel chain"
+        },
+        {
+          "shot": "panel-256",
+          "label": "256 x 32",
+          "sublabel": "font_size 8; a headline fragment you can actually read"
+        }
+      ]
+    }
+  ]
+}

plugins.json

@@ -554,10 +554,10 @@
       "plugin_path": "plugins/news",
       "stars": 0,
       "downloads": 0,
-      "last_updated": "2026-08-05",
+      "last_updated": "2026-09-02",
       "verified": true,
       "screenshot": "",
-      "latest_version": "1.3.2"
+      "latest_version": "1.4.0"
     },
     {
       "id": "on-air",