rdsclock 1.1.0__tar.gz → 2.0.0__tar.gz

{rdsclock-1.1.0 → rdsclock-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rdsclock
-Version: 1.1.0
+Version: 2.0.0
 Summary: Passive RDS Clock-Time receiver for FM via RTL-SDR, with multi-source consensus for GPS-denied environments
 Author-email: Mateusz Klatt <mateusz@klatt.ie>
 License-Expression: Apache-2.0
@@ -225,6 +225,26 @@ gets tkinter from `apt install python3-tk`. With `--jsonl`, `recon` instead
 writes one JSON event per line for other programs; the
 [operator guide](docs/operator-quickstart.md) describes all these modes.
 
+#### Dashboard language
+
+All three dashboards support English, Polish and French in 2.0.0. Use
+`--lang en`, `--lang pl` or `--lang fr` with `--tui`, `--web` or `--gui`;
+English is the default. For example, to open a Polish browser dashboard:
+
+```bash
+.venv/bin/python -m rdsclock recon --host 127.0.0.1 \
+  --wide 98.3,98.8 --gain 28 --dwell 75 --web --lang pl
+```
+
+The selected language applies to controls, headings, status messages and the
+operator log. Broadcast PS/PI/CT values and JSON Lines field names remain
+unchanged. Each dashboard owns one receiver process; run one of these commands
+at a time against a single RTL-TCP server. The live screenshots below show the
+English interface; the Polish and French READMEs show their own.
+
+[2.0.0 release notes — EN / PL / FR](docs/releases/2.0.0.md) ·
+[Release procedure](docs/releasing.md)
+
 #### WIDE: two stations from one capture
 
 With `--wide`, `recon` records stations that fit in the receiver bandwidth
@@ -242,15 +262,15 @@ come from this command, with `--web` or `--gui` in place of `--tui`:
 
 **Terminal** (`--tui`)
 
-![Terminal dashboard during live WIDE reception: trust MEDIUM from two stations in one capture, both with Clock-Time](docs/images/dashboard-wide-tui.png)
+![Terminal dashboard during live WIDE reception: trust MEDIUM from two stations in one capture, both with Clock-Time](docs/images/dashboard-wide-tui-en.png)
 
 **Browser** (`--web`)
 
-![Browser dashboard during live WIDE reception of RMF Classic and PR Trójka, with Rescan and Pause view buttons](docs/images/dashboard-wide-web.png)
+![Browser dashboard during live WIDE reception of RMF Classic and PR Trójka, with Rescan and Pause view buttons](docs/images/dashboard-wide-web-en.png)
 
 **Desktop window** (`--gui`)
 
-![Desktop window during live WIDE reception of RMF Classic and PR Trójka, with Rescan, Pause view and Quit buttons](docs/images/dashboard-wide-gui.png)
+![Desktop window during live WIDE reception of RMF Classic and PR Trójka, with Rescan, Pause view and Quit buttons](docs/images/dashboard-wide-gui-en.png)
 
 #### HOP: three stations, one after another
 
@@ -260,8 +280,8 @@ each report a different minute, and all three agree (N=3). The receiver
 assesses trust once per cycle, and the dashboards keep that label until the next
 assessment. HIGH needs three confirmed stations whose median Clock-Time is under
 two minutes old at that moment; MEDIUM needs two under three minutes. A cycle of
-three 75-second captures can end on either side of the two-minute limit, which
-is why the window below shows MEDIUM:
+three 75-second captures can end on either side of the two-minute limit; the
+cycle in these screenshots ended at HIGH:
 
 ```bash
 .venv/bin/python -m rdsclock recon --host 127.0.0.1 \
@@ -271,19 +291,19 @@ is why the window below shows MEDIUM:
 
 **Terminal** (`--tui`)
 
-![Terminal dashboard during live HOP reception: trust HIGH from three stations, each with Clock-Time](docs/images/dashboard-hop-tui.png)
+![Terminal dashboard during live HOP reception: trust HIGH from three stations, each with Clock-Time](docs/images/dashboard-hop-tui-en.png)
 
 **Browser** (`--web`)
 
-![Browser dashboard during live HOP reception of Radio ZET, PR Jedynka and PR Trójka](docs/images/dashboard-hop-web.png)
+![Browser dashboard during live HOP reception of Radio ZET, PR Jedynka and PR Trójka](docs/images/dashboard-hop-web-en.png)
 
 **Desktop window** (`--gui`)
 
-![Desktop window during live HOP reception of Radio ZET, PR Jedynka and PR Trójka](docs/images/dashboard-hop-gui.png)
+![Desktop window during live HOP reception of Radio ZET, PR Jedynka and PR Trójka](docs/images/dashboard-hop-gui-en.png)
 
-*Live reception in Warsaw on 3 and 4 November 2026. These stations send Polish
-local time in the UTC field, which is why the consensus runs an hour ahead of
-the host clock.*
+*Live reception in Warsaw on 4 November 2026. Received UTC declarations
+were approximately one hour ahead of host UTC. This is an observed disagreement;
+source agreement does not establish the cause or calibrate absolute accuracy.*
 
 ## How it works
 

{rdsclock-1.1.0 → rdsclock-2.0.0}/README.md

@@ -185,6 +185,26 @@ gets tkinter from `apt install python3-tk`. With `--jsonl`, `recon` instead
 writes one JSON event per line for other programs; the
 [operator guide](docs/operator-quickstart.md) describes all these modes.
 
+#### Dashboard language
+
+All three dashboards support English, Polish and French in 2.0.0. Use
+`--lang en`, `--lang pl` or `--lang fr` with `--tui`, `--web` or `--gui`;
+English is the default. For example, to open a Polish browser dashboard:
+
+```bash
+.venv/bin/python -m rdsclock recon --host 127.0.0.1 \
+  --wide 98.3,98.8 --gain 28 --dwell 75 --web --lang pl
+```
+
+The selected language applies to controls, headings, status messages and the
+operator log. Broadcast PS/PI/CT values and JSON Lines field names remain
+unchanged. Each dashboard owns one receiver process; run one of these commands
+at a time against a single RTL-TCP server. The live screenshots below show the
+English interface; the Polish and French READMEs show their own.
+
+[2.0.0 release notes — EN / PL / FR](docs/releases/2.0.0.md) ·
+[Release procedure](docs/releasing.md)
+
 #### WIDE: two stations from one capture
 
 With `--wide`, `recon` records stations that fit in the receiver bandwidth
@@ -202,15 +222,15 @@ come from this command, with `--web` or `--gui` in place of `--tui`:
 
 **Terminal** (`--tui`)
 
-![Terminal dashboard during live WIDE reception: trust MEDIUM from two stations in one capture, both with Clock-Time](docs/images/dashboard-wide-tui.png)
+![Terminal dashboard during live WIDE reception: trust MEDIUM from two stations in one capture, both with Clock-Time](docs/images/dashboard-wide-tui-en.png)
 
 **Browser** (`--web`)
 
-![Browser dashboard during live WIDE reception of RMF Classic and PR Trójka, with Rescan and Pause view buttons](docs/images/dashboard-wide-web.png)
+![Browser dashboard during live WIDE reception of RMF Classic and PR Trójka, with Rescan and Pause view buttons](docs/images/dashboard-wide-web-en.png)
 
 **Desktop window** (`--gui`)
 
-![Desktop window during live WIDE reception of RMF Classic and PR Trójka, with Rescan, Pause view and Quit buttons](docs/images/dashboard-wide-gui.png)
+![Desktop window during live WIDE reception of RMF Classic and PR Trójka, with Rescan, Pause view and Quit buttons](docs/images/dashboard-wide-gui-en.png)
 
 #### HOP: three stations, one after another
 
@@ -220,8 +240,8 @@ each report a different minute, and all three agree (N=3). The receiver
 assesses trust once per cycle, and the dashboards keep that label until the next
 assessment. HIGH needs three confirmed stations whose median Clock-Time is under
 two minutes old at that moment; MEDIUM needs two under three minutes. A cycle of
-three 75-second captures can end on either side of the two-minute limit, which
-is why the window below shows MEDIUM:
+three 75-second captures can end on either side of the two-minute limit; the
+cycle in these screenshots ended at HIGH:
 
 ```bash
 .venv/bin/python -m rdsclock recon --host 127.0.0.1 \
@@ -231,19 +251,19 @@ is why the window below shows MEDIUM:
 
 **Terminal** (`--tui`)
 
-![Terminal dashboard during live HOP reception: trust HIGH from three stations, each with Clock-Time](docs/images/dashboard-hop-tui.png)
+![Terminal dashboard during live HOP reception: trust HIGH from three stations, each with Clock-Time](docs/images/dashboard-hop-tui-en.png)
 
 **Browser** (`--web`)
 
-![Browser dashboard during live HOP reception of Radio ZET, PR Jedynka and PR Trójka](docs/images/dashboard-hop-web.png)
+![Browser dashboard during live HOP reception of Radio ZET, PR Jedynka and PR Trójka](docs/images/dashboard-hop-web-en.png)
 
 **Desktop window** (`--gui`)
 
-![Desktop window during live HOP reception of Radio ZET, PR Jedynka and PR Trójka](docs/images/dashboard-hop-gui.png)
+![Desktop window during live HOP reception of Radio ZET, PR Jedynka and PR Trójka](docs/images/dashboard-hop-gui-en.png)
 
-*Live reception in Warsaw on 3 and 4 November 2026. These stations send Polish
-local time in the UTC field, which is why the consensus runs an hour ahead of
-the host clock.*
+*Live reception in Warsaw on 4 November 2026. Received UTC declarations
+were approximately one hour ahead of host UTC. This is an observed disagreement;
+source agreement does not establish the cause or calibrate absolute accuracy.*
 
 ## How it works
 

{rdsclock-1.1.0 → rdsclock-2.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rdsclock"
-version = "1.1.0"
+version = "2.0.0"
 description = "Passive RDS Clock-Time receiver for FM via RTL-SDR, with multi-source consensus for GPS-denied environments"
 readme = "README.md"
 requires-python = ">=3.12"

{rdsclock-1.1.0 → rdsclock-2.0.0}/src/rdsclock/__init__.py

@@ -28,7 +28,7 @@ from .rds_clock import ClockTime
 from .rds_groups import StationInfo
 from .time_consensus import SubSecondEstimate, TimeConsensus
 
-__version__ = "1.1.0"
+__version__ = "2.0.0"
 
 __all__ = [
     "__version__",

{rdsclock-1.1.0 → rdsclock-2.0.0}/src/rdsclock/cli.py

@@ -37,6 +37,7 @@ from .channelizer import (
     required_bandwidth,
 )
 from .decoder import decode_file, decode_iq
+from .i18n import SUPPORTED_LANGUAGES, translate
 from .plot import plot_iq_waterfall, plot_mpx_spectrum
 from .rds_groups import StationInfo, encode_group_4a, encode_ps_groups
 from .recon import (
@@ -792,35 +793,55 @@ def _recon_child_argv(args: argparse.Namespace) -> list[str]:
 def _recon_tui(args: argparse.Namespace) -> int:
     """Run the terminal dashboard, which reads a ``recon --jsonl`` child process."""
     if args.from_dir:
-        print("error: --tui applies to live reception, not --from-dir", file=sys.stderr)
+        print(
+            translate(
+                args.lang, "error: {flag} applies to live reception, not --from-dir", flag="--tui"
+            ),
+            file=sys.stderr,
+        )
         return 2
     if importlib.util.find_spec("textual") is None:
         print(
-            "error: the dashboard requires the optional 'textual' dependency; "
-            "install with: pip install 'rdsclock[tui]'",
+            translate(
+                args.lang,
+                "error: the dashboard requires the optional 'textual' dependency; "
+                "install with: pip install 'rdsclock[tui]'",
+            ),
             file=sys.stderr,
         )
         return 2
     from .tui import run_dashboard
 
-    return run_dashboard([sys.executable, "-m", "rdsclock", *_recon_child_argv(args)])
+    return run_dashboard(
+        [sys.executable, "-m", "rdsclock", *_recon_child_argv(args)], language=args.lang
+    )
 
 
 def _recon_web(args: argparse.Namespace) -> int:
     """Serve the browser dashboard, which reads a ``recon --jsonl`` child process."""
     if args.from_dir:
-        print("error: --web applies to live reception, not --from-dir", file=sys.stderr)
+        print(
+            translate(
+                args.lang, "error: {flag} applies to live reception, not --from-dir", flag="--web"
+            ),
+            file=sys.stderr,
+        )
         return 2
     from .web import run_web
 
     command = [sys.executable, "-m", "rdsclock", *_recon_child_argv(args)]
-    return run_web(command, args.web_host, args.web_port)
+    return run_web(command, args.web_host, args.web_port, language=args.lang)
 
 
 def _recon_gui(args: argparse.Namespace) -> int:
     """Open the desktop window, which reads a ``recon --jsonl`` child process."""
     if args.from_dir:
-        print("error: --gui applies to live reception, not --from-dir", file=sys.stderr)
+        print(
+            translate(
+                args.lang, "error: {flag} applies to live reception, not --from-dir", flag="--gui"
+            ),
+            file=sys.stderr,
+        )
         return 2
     # Import rather than look the package up: tkinter can be present without
     # its native _tkinter extension or the Tcl/Tk libraries it loads.
@@ -828,12 +849,16 @@ def _recon_gui(args: argparse.Namespace) -> int:
         from .gui import run_gui
     except ImportError as exc:
         print(
-            f"error: the desktop window requires tkinter ({exc}); install your "
-            "Python's Tk support (for example: apt install python3-tk)",
+            translate(
+                args.lang,
+                "error: the desktop window requires tkinter ({error}); install your "
+                "Python's Tk support (for example: apt install python3-tk)",
+                error=exc,
+            ),
             file=sys.stderr,
         )
         return 2
-    return run_gui([sys.executable, "-m", "rdsclock", *_recon_child_argv(args)])
+    return run_gui([sys.executable, "-m", "rdsclock", *_recon_child_argv(args)], language=args.lang)
 
 
 def _recon_config(args: argparse.Namespace) -> ReconConfig:
@@ -1174,6 +1199,12 @@ def build_parser() -> argparse.ArgumentParser:
         action="store_true",
         help="Open a desktop window (tkinter) fed by a --jsonl child",
     )
+    pr.add_argument(
+        "--lang",
+        choices=SUPPORTED_LANGUAGES,
+        default="en",
+        help="Language of the terminal, browser or desktop dashboard (default: en)",
+    )
     pr.add_argument(
         "--web-host",
         default="127.0.0.1",