sciveo 0.2.99__tar.gz → 0.3.2__tar.gz

{sciveo-0.2.99/sciveo.egg-info → sciveo-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sciveo
-Version: 0.2.99
+Version: 0.3.2
 Description-Content-Type: text/markdown
 Provides-Extra: mon
 Provides-Extra: agent
@@ -1894,8 +1894,8 @@ sciveo nvr --input-path cameras.json --play term --view list --max-streams 256 -
 sciveo rtsp --url rtsp://192.168.1.20/stream1 --play term
 ```
 
-Use the existing NVR `cam` mapping. Recording/storage settings in an existing
-file are ignored by playback. Credentials may remain in legacy URLs or be
+Use the existing NVR `cam` mapping. Playback also reads finalized recordings
+when storage paths are configured; it never saves video. Credentials may remain in legacy URLs or be
 specified separately (per camera overrides the optional top-level defaults):
 
 ```json
@@ -2125,7 +2125,7 @@ Common camera URL starting points (confirm against the model/firmware settings):
 Use H.264 or H.265 and a short keyframe interval, such as 1-2 seconds, for quick
 switching. A substream reduces capture bandwidth and decoder load for large grids.
 
-The camera dashboard is shared by `--play term`, `--play cv2` and `--play native`.
+The camera dashboard is shared by `--play term`, `--play cv2`, `--play native` and `--play http`.
 The same `TerminalPage`, panels, menus, tables and `ImageWidget` compose every
 view. `sciveo.ui.gui.GraphicalRenderer` paints those widgets onto a pixel canvas;
 video retains its original decoded resolution and fits its panel without turning
@@ -2153,6 +2153,194 @@ The legacy native plain RTSP path uses FFplay, or the Windows URL handler;
 RTSPS currently uses this plain path. Offscreen camera previews stay bounded at
 320x180; only active decoders retain full-resolution frames.
 
+In an active NVR/RTSP single-camera view, press `e` to enter ONVIF PTZ control.
+The shared direction-pad overlay flashes the pending arrow until movement and
+Stop complete, then restores its theme color. New movement keys are ignored
+while pending; Stop and exit remain available. This also works in graphical and
+HTTP views, using the reusable `sciveo.ui.term.DirectionPad` widget.
+Arrows or `i` (up), `j` (left), `k` (right), `m` (down) move the camera;
+`+`/`-` controls zoom when advertised. Space stops movement and `e` returns to
+camera navigation. Terminal/native Escape also leaves PTZ mode; HTTP Escape
+retains its browser-local refresh toggle. Slideshow is disabled while controlling
+PTZ, and camera selection stays fixed. Unsupported cameras or denied ONVIF access
+show a status message. Passive sniffing never offers PTZ or sends ONVIF commands.
+
+Each key requests a 250 ms pulse at 25% of the advertised velocity range, followed
+by an explicit pan/tilt/zoom Stop. A camera-side timeout (at most one second) is
+also sent. Repeated keys are dropped while a pulse is executing; leaving PTZ,
+losing the selected stream, or closing playback cancels pending motion. The
+reusable clients are `sciveo.network.onvif.ONVIFPTZClient` and
+`ONVIFPTZController`; regular ONVIF discovery remains read-only. PTZ reuses the
+credentials accepted by ONVIF discovery, including its clock correction.
+
+Press `c` in active NVR/RTSP single-camera view to open **Camera settings** in
+terminal/native/OpenCV/HTTP. Up/down or Tab selects a field; Enter toggles a
+choice or opens text editing. Enter accepts the draft, Escape cancels editing.
+Choose **Apply changes** to send changed clock/NTP settings and read them back;
+**Reload / discard draft** fetches current values, and **Cancel / close** discards
+unapplied edits. An Apply already in progress finishes before the panel closes.
+UTC date/time uses `YYYY-MM-DD HH:MM:SS`; time zones use the camera's ONVIF/POSIX
+string, e.g. `UTC0` or `EET-2EEST`. NTP servers accept comma-separated DNS names,
+IPv4 or IPv6 addresses; DHCP-provided servers and NTP-controlled UTC are read-only.
+Unavailable NTP access is marked explicitly. Partial failures require Reload;
+the UI never claims an atomic update across the clock and NTP operations.
+HTTP Escape closes the settings panel/editor; outside it, q/Esc still pauses only
+browser refresh. The reusable client is `sciveo.network.onvif.ONVIFSettingsClient`.
+Passive sniffing never exposes these settings or sends camera requests.
+
+HTTP playback serves the same widgets as HTML/CSS through
+`sciveo.ui.gui.html.HtmlRenderer` and `HttpWindow`, without a separate web widget
+set or additional server dependencies:
+
+```shell
+sciveo rtsp --url rtsp://192.168.10.179:8550/cam --play http --port 8080
+sciveo nvr --input-path cameras.json --play http --port 8080 --view grid --size 4x3
+sciveo capture --src tv --play http --port 8080
+sudo sciveo sniff --if enx00e04c360035 --proto rtsp --play http --port 8080
+```
+
+Open `http://localhost:8080/`. The configured theme and player keyboard controls
+work in the browser, including `[ theme ]`, `g`, `v`, `i`, and `s`. All connected
+browsers control one shared dashboard; the latest browser resize sets its viewport.
+`q`/Escape pauses refresh in that browser tab, keeping the last image visible;
+press it again to resume. Other tabs and the HTTP service continue running.
+Use Ctrl+C in the launching terminal to stop the service. `--view plain` hides dashboard panels.
+The HTTP port defaults to 8080 unless explicitly configured; specify the camera
+port inside `--url`, since `--port` belongs to the HTTP service in this mode.
+
+Sciveo receives and decodes the camera stream, then serves binary JPEG frames at
+original decoded resolution, fitted to the video panels by CSS. JavaScript polls
+for updates (up to 10 times per second) and replaces the display after images load.
+This is a JPEG preview transport, with higher bandwidth than compressed H.264
+browser playback; it carries no audio. The last image stays visible during an
+interruption. Only the latest two rendered frames are retained. Browsers receive
+neither camera credentials nor RTSP URLs for direct playback. Sniff mode remains
+passive: HTTP displays already captured video and never connects to cameras.
+
+The service defaults to `--host 127.0.0.1` and uses plain HTTP. Use `--host 0.0.0.0`
+to listen on all IPv4 interfaces, then browse `http://SERVER_IP:8080/`.
+For example, `sciveo nvr --input-path recordings.json --play http --host 0.0.0.0 --port 8080`.
+A local nginx reverse proxy
+can provide HTTPS, authentication and external access; preserve the original
+`Host` header for same-origin browser controls. No TLS or authentication is built
+into this local preview service. RTSPS sources currently require native plain
+playback instead.
+
+#### NVR recording playback
+
+The same dashboard can combine live `cam` / `auto` sources with recordings, or
+use a separate recording-only JSON. Add this object to the camera configuration:
+
+```json
+{
+  "recordings": {
+    "paths": ["/mnt/data-2/nvr/video", "/mnt/data-1/nvr/video"],
+    "scan_period": 5
+  }
+}
+```
+
+`recordings.paths` names the finalized video directories directly. Existing
+capture configurations also work: top-level `paths` names storage bases, so the
+viewer reads each `BASE/video`; legacy `path.video` is accepted too. An explicit
+`recordings.paths` overrides these capture paths. Optional `recordings.cameras`
+is a list of camera directory names to include. Recording-only configurations
+do not scan or connect to network cameras.
+
+```shell
+sciveo nvr --input-path recordings.json --play term --view grid --size 2x2
+sciveo nvr --input-path recordings.json --play native
+sciveo nvr --input-path recordings.json --play http --port 8080
+```
+
+The index reads the recorder's `CAMERA/YYYY-MM-DD/HH.MM.SS-HH.MM.SS.mp4`
+layout, including clips crossing midnight. Pending files and symlinks are
+ignored. Dates are recorder-local wall time from the filenames. Each video
+shows its from/to timestamps; decoded clips use their measured duration.
+Recent files refresh in the background every five seconds after the previous
+refresh finishes; a separate worker indexes full history at startup and at least
+60 seconds between completed passes. Unchanged day listings are cached. Slow
+history reads do not block the recent-file worker or navigation.
+
+Live and recorded sources appear as separate camera entries. Grid mode follows
+each archive camera's newest finalized file, holds its last image at the end,
+and switches when the next file arrives. Entering grid mode returns historical
+selections to latest. Only visible cameras and single-view neighbors decode,
+up to 20 at once; GUI/HTTP retain original video resolution.
+
+The selected camera marker identifies its source in both lists and grids:
+`▶` live RTSP, `▣` recording/video file, `◉` sniffed RTP/RTSP. The selection
+highlight keeps the configured theme. Other menus keep their `>` default;
+`MenuView(marker="◆")` or `MenuView(marker=callable)` customizes that single-cell
+marker for third-party widgets.
+
+In single recorded-video view, the 24-hour timeline highlights available
+recordings and shows the selected time:
+
+- Left/right selects the previous/next recording file (normally about one minute).
+  It uses actual file timestamps, including gaps, rather than a fixed time jump.
+- `-` / `+` adjusts it by one hour (`=` also moves forward).
+- `p` / `n` adjusts it by one day. PageUp/PageDown also works
+  (Fn + Up/Down on MacBook keyboards).
+- Adjustments accumulate until ten seconds after the last keypress. The overlay
+  shows the total offset, target and countdown. Left three times then `-` means
+  three files back plus one hour (normally minus one hour three minutes), with
+  one file opened after the pause.
+  Enter applies immediately; Escape cancels the adjustment. Changing camera or
+  view cancels an unapplied adjustment.
+- `b` opens date/time entry (`YYYY-MM-DD HH:MM:SS`); Enter seeks, Escape cancels.
+- `,` / `.` plays the previous/next clip; `l` jumps to the latest file at 1x
+  and follows new recordings, including while an earlier seek is pending.
+- `x` cycles archive playback speed: 1x (default), 2x, 4x, 8x, 16x, 32x, 64x, then 1x.
+  The timeline and key legend show the speed. Changes keep the current position
+  and continue at that speed across files; live streams and latest-file playback
+  stay at 1x. All speeds above 1x sample keyframes to reduce decoder work.
+  Speed changes reconfigure the decoder in the background at the current position;
+  display refresh stays constant. Actual throughput depends on disk and decoder performance.
+- During a seek, a flashing overlay shows the pressed key, target time and elapsed
+  wait over the last frame. Further seek keys pause until a new frame or an error;
+  camera selection, view changes and quit remain available.
+- `f` opens the selected video fullscreen without menus, timeline or borders;
+  `f` or Escape restores the previous view. This also works for live and sniffed
+  video. Native/OpenCV use display fullscreen, HTTP requests browser fullscreen,
+  and terminal playback fills the terminal area. Video keeps its aspect ratio.
+- A seek starts continuous forward playback through the same camera's files,
+  in timestamp order, across gaps and date boundaries. Each file starts at its
+  beginning. At the end of the archive, playback retains the last frame and
+  continues when the index discovers a later recording.
+- Gaps longer than one recording period (60 seconds by default, configurable as
+  `recordings.period`) are marked red on the timeline. After crossing a gap, a
+  **MISSING 1h 15m of videos** stripe uses red text on the theme's background
+  and shows its duration and from/to times.
+  Short gaps occupy at least one timeline cell so they remain visible at a
+  compact width. Seeking into a gap starts the next available file, including on
+  a later day. Before the archive it starts the first file; after the archive it
+  starts the last file. The timeline shows the actual selected time. Only a
+  camera with no available recordings shows **NO RECORDING**.
+  These controls work in the terminal, native/OpenCV dashboard and HTTP viewer.
+
+Navigation has one-recording-file resolution (normally one minute): the camera
+and requested date/time select a file, which always plays from its beginning.
+The timeline then shows its actual start/playback time, with no within-file seek.
+Indexed dates are reused, metadata probes run separately from decoding and are
+cached for 256 files, and file frames are paced after decoding so input startup
+is not throttled to real time. During the adjustment countdown, one background
+worker prepares the target file and holds its first frame. Confirming the seek
+reuses that decoder. Forward archive playback also prepares the next indexed
+file. Neighboring cameras retain a paused preview; only visible recordings keep
+decoding. Only current/prepared frames and bounded decoder pipes are retained;
+files are not pre-decoded into RAM.
+
+All TUI/GUI/HTTP event loops are for rendering and keyboard/mouse input. Disk
+scans, network operations, decoding, metadata queries and slow cleanup belong
+to background workers. Event handlers enqueue work and render published state;
+they must not wait for a worker or hold a lock used for long-running work.
+Archive navigation uses the in-memory index, with history sorting outside its
+short snapshot lock and timeline rendering limited to the visible day.
+
+Archive playback only reads files and never modifies the recording service or
+retention settings. Camera PTZ/settings controls apply only to live entries.
+
 Third-party clients render the existing widgets with the same API:
 
 ```python

{sciveo-0.2.99 → sciveo-0.3.2}/README.md

@@ -1869,8 +1869,8 @@ sciveo nvr --input-path cameras.json --play term --view list --max-streams 256 -
 sciveo rtsp --url rtsp://192.168.1.20/stream1 --play term
 ```
 
-Use the existing NVR `cam` mapping. Recording/storage settings in an existing
-file are ignored by playback. Credentials may remain in legacy URLs or be
+Use the existing NVR `cam` mapping. Playback also reads finalized recordings
+when storage paths are configured; it never saves video. Credentials may remain in legacy URLs or be
 specified separately (per camera overrides the optional top-level defaults):
 
 ```json
@@ -2100,7 +2100,7 @@ Common camera URL starting points (confirm against the model/firmware settings):
 Use H.264 or H.265 and a short keyframe interval, such as 1-2 seconds, for quick
 switching. A substream reduces capture bandwidth and decoder load for large grids.
 
-The camera dashboard is shared by `--play term`, `--play cv2` and `--play native`.
+The camera dashboard is shared by `--play term`, `--play cv2`, `--play native` and `--play http`.
 The same `TerminalPage`, panels, menus, tables and `ImageWidget` compose every
 view. `sciveo.ui.gui.GraphicalRenderer` paints those widgets onto a pixel canvas;
 video retains its original decoded resolution and fits its panel without turning
@@ -2128,6 +2128,194 @@ The legacy native plain RTSP path uses FFplay, or the Windows URL handler;
 RTSPS currently uses this plain path. Offscreen camera previews stay bounded at
 320x180; only active decoders retain full-resolution frames.
 
+In an active NVR/RTSP single-camera view, press `e` to enter ONVIF PTZ control.
+The shared direction-pad overlay flashes the pending arrow until movement and
+Stop complete, then restores its theme color. New movement keys are ignored
+while pending; Stop and exit remain available. This also works in graphical and
+HTTP views, using the reusable `sciveo.ui.term.DirectionPad` widget.
+Arrows or `i` (up), `j` (left), `k` (right), `m` (down) move the camera;
+`+`/`-` controls zoom when advertised. Space stops movement and `e` returns to
+camera navigation. Terminal/native Escape also leaves PTZ mode; HTTP Escape
+retains its browser-local refresh toggle. Slideshow is disabled while controlling
+PTZ, and camera selection stays fixed. Unsupported cameras or denied ONVIF access
+show a status message. Passive sniffing never offers PTZ or sends ONVIF commands.
+
+Each key requests a 250 ms pulse at 25% of the advertised velocity range, followed
+by an explicit pan/tilt/zoom Stop. A camera-side timeout (at most one second) is
+also sent. Repeated keys are dropped while a pulse is executing; leaving PTZ,
+losing the selected stream, or closing playback cancels pending motion. The
+reusable clients are `sciveo.network.onvif.ONVIFPTZClient` and
+`ONVIFPTZController`; regular ONVIF discovery remains read-only. PTZ reuses the
+credentials accepted by ONVIF discovery, including its clock correction.
+
+Press `c` in active NVR/RTSP single-camera view to open **Camera settings** in
+terminal/native/OpenCV/HTTP. Up/down or Tab selects a field; Enter toggles a
+choice or opens text editing. Enter accepts the draft, Escape cancels editing.
+Choose **Apply changes** to send changed clock/NTP settings and read them back;
+**Reload / discard draft** fetches current values, and **Cancel / close** discards
+unapplied edits. An Apply already in progress finishes before the panel closes.
+UTC date/time uses `YYYY-MM-DD HH:MM:SS`; time zones use the camera's ONVIF/POSIX
+string, e.g. `UTC0` or `EET-2EEST`. NTP servers accept comma-separated DNS names,
+IPv4 or IPv6 addresses; DHCP-provided servers and NTP-controlled UTC are read-only.
+Unavailable NTP access is marked explicitly. Partial failures require Reload;
+the UI never claims an atomic update across the clock and NTP operations.
+HTTP Escape closes the settings panel/editor; outside it, q/Esc still pauses only
+browser refresh. The reusable client is `sciveo.network.onvif.ONVIFSettingsClient`.
+Passive sniffing never exposes these settings or sends camera requests.
+
+HTTP playback serves the same widgets as HTML/CSS through
+`sciveo.ui.gui.html.HtmlRenderer` and `HttpWindow`, without a separate web widget
+set or additional server dependencies:
+
+```shell
+sciveo rtsp --url rtsp://192.168.10.179:8550/cam --play http --port 8080
+sciveo nvr --input-path cameras.json --play http --port 8080 --view grid --size 4x3
+sciveo capture --src tv --play http --port 8080
+sudo sciveo sniff --if enx00e04c360035 --proto rtsp --play http --port 8080
+```
+
+Open `http://localhost:8080/`. The configured theme and player keyboard controls
+work in the browser, including `[ theme ]`, `g`, `v`, `i`, and `s`. All connected
+browsers control one shared dashboard; the latest browser resize sets its viewport.
+`q`/Escape pauses refresh in that browser tab, keeping the last image visible;
+press it again to resume. Other tabs and the HTTP service continue running.
+Use Ctrl+C in the launching terminal to stop the service. `--view plain` hides dashboard panels.
+The HTTP port defaults to 8080 unless explicitly configured; specify the camera
+port inside `--url`, since `--port` belongs to the HTTP service in this mode.
+
+Sciveo receives and decodes the camera stream, then serves binary JPEG frames at
+original decoded resolution, fitted to the video panels by CSS. JavaScript polls
+for updates (up to 10 times per second) and replaces the display after images load.
+This is a JPEG preview transport, with higher bandwidth than compressed H.264
+browser playback; it carries no audio. The last image stays visible during an
+interruption. Only the latest two rendered frames are retained. Browsers receive
+neither camera credentials nor RTSP URLs for direct playback. Sniff mode remains
+passive: HTTP displays already captured video and never connects to cameras.
+
+The service defaults to `--host 127.0.0.1` and uses plain HTTP. Use `--host 0.0.0.0`
+to listen on all IPv4 interfaces, then browse `http://SERVER_IP:8080/`.
+For example, `sciveo nvr --input-path recordings.json --play http --host 0.0.0.0 --port 8080`.
+A local nginx reverse proxy
+can provide HTTPS, authentication and external access; preserve the original
+`Host` header for same-origin browser controls. No TLS or authentication is built
+into this local preview service. RTSPS sources currently require native plain
+playback instead.
+
+#### NVR recording playback
+
+The same dashboard can combine live `cam` / `auto` sources with recordings, or
+use a separate recording-only JSON. Add this object to the camera configuration:
+
+```json
+{
+  "recordings": {
+    "paths": ["/mnt/data-2/nvr/video", "/mnt/data-1/nvr/video"],
+    "scan_period": 5
+  }
+}
+```
+
+`recordings.paths` names the finalized video directories directly. Existing
+capture configurations also work: top-level `paths` names storage bases, so the
+viewer reads each `BASE/video`; legacy `path.video` is accepted too. An explicit
+`recordings.paths` overrides these capture paths. Optional `recordings.cameras`
+is a list of camera directory names to include. Recording-only configurations
+do not scan or connect to network cameras.
+
+```shell
+sciveo nvr --input-path recordings.json --play term --view grid --size 2x2
+sciveo nvr --input-path recordings.json --play native
+sciveo nvr --input-path recordings.json --play http --port 8080
+```
+
+The index reads the recorder's `CAMERA/YYYY-MM-DD/HH.MM.SS-HH.MM.SS.mp4`
+layout, including clips crossing midnight. Pending files and symlinks are
+ignored. Dates are recorder-local wall time from the filenames. Each video
+shows its from/to timestamps; decoded clips use their measured duration.
+Recent files refresh in the background every five seconds after the previous
+refresh finishes; a separate worker indexes full history at startup and at least
+60 seconds between completed passes. Unchanged day listings are cached. Slow
+history reads do not block the recent-file worker or navigation.
+
+Live and recorded sources appear as separate camera entries. Grid mode follows
+each archive camera's newest finalized file, holds its last image at the end,
+and switches when the next file arrives. Entering grid mode returns historical
+selections to latest. Only visible cameras and single-view neighbors decode,
+up to 20 at once; GUI/HTTP retain original video resolution.
+
+The selected camera marker identifies its source in both lists and grids:
+`▶` live RTSP, `▣` recording/video file, `◉` sniffed RTP/RTSP. The selection
+highlight keeps the configured theme. Other menus keep their `>` default;
+`MenuView(marker="◆")` or `MenuView(marker=callable)` customizes that single-cell
+marker for third-party widgets.
+
+In single recorded-video view, the 24-hour timeline highlights available
+recordings and shows the selected time:
+
+- Left/right selects the previous/next recording file (normally about one minute).
+  It uses actual file timestamps, including gaps, rather than a fixed time jump.
+- `-` / `+` adjusts it by one hour (`=` also moves forward).
+- `p` / `n` adjusts it by one day. PageUp/PageDown also works
+  (Fn + Up/Down on MacBook keyboards).
+- Adjustments accumulate until ten seconds after the last keypress. The overlay
+  shows the total offset, target and countdown. Left three times then `-` means
+  three files back plus one hour (normally minus one hour three minutes), with
+  one file opened after the pause.
+  Enter applies immediately; Escape cancels the adjustment. Changing camera or
+  view cancels an unapplied adjustment.
+- `b` opens date/time entry (`YYYY-MM-DD HH:MM:SS`); Enter seeks, Escape cancels.
+- `,` / `.` plays the previous/next clip; `l` jumps to the latest file at 1x
+  and follows new recordings, including while an earlier seek is pending.
+- `x` cycles archive playback speed: 1x (default), 2x, 4x, 8x, 16x, 32x, 64x, then 1x.
+  The timeline and key legend show the speed. Changes keep the current position
+  and continue at that speed across files; live streams and latest-file playback
+  stay at 1x. All speeds above 1x sample keyframes to reduce decoder work.
+  Speed changes reconfigure the decoder in the background at the current position;
+  display refresh stays constant. Actual throughput depends on disk and decoder performance.
+- During a seek, a flashing overlay shows the pressed key, target time and elapsed
+  wait over the last frame. Further seek keys pause until a new frame or an error;
+  camera selection, view changes and quit remain available.
+- `f` opens the selected video fullscreen without menus, timeline or borders;
+  `f` or Escape restores the previous view. This also works for live and sniffed
+  video. Native/OpenCV use display fullscreen, HTTP requests browser fullscreen,
+  and terminal playback fills the terminal area. Video keeps its aspect ratio.
+- A seek starts continuous forward playback through the same camera's files,
+  in timestamp order, across gaps and date boundaries. Each file starts at its
+  beginning. At the end of the archive, playback retains the last frame and
+  continues when the index discovers a later recording.
+- Gaps longer than one recording period (60 seconds by default, configurable as
+  `recordings.period`) are marked red on the timeline. After crossing a gap, a
+  **MISSING 1h 15m of videos** stripe uses red text on the theme's background
+  and shows its duration and from/to times.
+  Short gaps occupy at least one timeline cell so they remain visible at a
+  compact width. Seeking into a gap starts the next available file, including on
+  a later day. Before the archive it starts the first file; after the archive it
+  starts the last file. The timeline shows the actual selected time. Only a
+  camera with no available recordings shows **NO RECORDING**.
+  These controls work in the terminal, native/OpenCV dashboard and HTTP viewer.
+
+Navigation has one-recording-file resolution (normally one minute): the camera
+and requested date/time select a file, which always plays from its beginning.
+The timeline then shows its actual start/playback time, with no within-file seek.
+Indexed dates are reused, metadata probes run separately from decoding and are
+cached for 256 files, and file frames are paced after decoding so input startup
+is not throttled to real time. During the adjustment countdown, one background
+worker prepares the target file and holds its first frame. Confirming the seek
+reuses that decoder. Forward archive playback also prepares the next indexed
+file. Neighboring cameras retain a paused preview; only visible recordings keep
+decoding. Only current/prepared frames and bounded decoder pipes are retained;
+files are not pre-decoded into RAM.
+
+All TUI/GUI/HTTP event loops are for rendering and keyboard/mouse input. Disk
+scans, network operations, decoding, metadata queries and slow cleanup belong
+to background workers. Event handlers enqueue work and render published state;
+they must not wait for a worker or hold a lock used for long-running work.
+Archive navigation uses the in-memory index, with history sorting outside its
+short snapshot lock and timeline rendering limited to the visible day.
+
+Archive playback only reads files and never modifies the recording service or
+retention settings. Camera PTZ/settings controls apply only to live entries.
+
 Third-party clients render the existing widgets with the same API:
 
 ```python

{sciveo-0.2.99 → sciveo-0.3.2}/sciveo/cli.py

@@ -106,9 +106,9 @@ def main(argv=None):
   parser.add_argument('--net', type=str, default=None, help='Network like 192.168.10.0/24')
   parser.add_argument('--watchdog-net', action='store_true', help=argparse.SUPPRESS)
   parser.add_argument('--url', type=str, default=None, help='URL')
-  parser.add_argument('--host', type=str, default=None, help='Host ip or name')
+  parser.add_argument('--host', type=str, default=None, help='Host ip or name; HTTP player bind address with --play http (default 127.0.0.1)')
   parser.add_argument('--capture-port', type=int, default=502, help='Modbus server port in the source PCAP for session emulation')
-  parser.add_argument('--port', type=int, default=22, help='Host port number, used for network ops')
+  parser.add_argument('--port', type=int, default=22, help='Host port for network ops; HTTP player listen port with --play http (default 8080)')
   parser.add_argument('--s3', action='store_true', help='Run the local S3-compatible storage service')
   parser.add_argument('--sync', action='store_true', help='Synchronize local storage files with local metadata and exit when supported')
   parser.add_argument('--stats', action='store_true', help='Show local storage statistics when supported')
@@ -146,7 +146,7 @@ def main(argv=None):
   parser.add_argument('--arp', action='store_true', help='For scan --health, run ARP/neighbors and live DHCP discovery only')
   parser.add_argument('--l2', action='store_true', help='Include L2/link-local discovery for scan or scan --health')
   parser.add_argument('--interface', '--if', dest='device', type=str, default=None, help='Network interface or bridge, for example eth1 or br-1')
-  parser.add_argument('--play', choices=('term', 'cv2', 'native'), default=None, help='Video display for any source: terminal, OpenCV, or native window')
+  parser.add_argument('--play', choices=('term', 'cv2', 'native', 'http'), default=None, help='Video display for any source: terminal, OpenCV, native window, or HTTP browser')
   parser.add_argument('--show-period', type=float, default=3, help='Terminal camera slideshow interval in seconds (default 3); s toggles playback')
   parser.add_argument('--view', choices=('list', 'grid', 'table', 'plain', 'packets', 'connections', 'protocols', 'transactions', 'devices', 'registers'), default=None, help='Camera dashboard, plain video, or network sniffer view')
   parser.add_argument('--max-packets', type=int, default=2000, help='Retained packet metadata records for sniffer')
@@ -333,6 +333,10 @@ def main(argv=None):
       args.period = 1
     if "proto" not in configured and not any(arg == '--proto' or arg.startswith('--proto=') for arg in argv):
       args.proto = 'all'
+  if args.play == 'http':
+    args.host = args.host or '127.0.0.1'
+    if not port_was_set:
+      args.port = 8080
   if args.command == 'admin' and not port_was_set:
     args.port = None
   if args.command == 'scan' and args.health and not parallel_was_set:

{sciveo-0.2.99 → sciveo-0.3.2}/sciveo/help.py

@@ -959,7 +959,9 @@ class Help:
         "options": [
           ("--interface IFACE, --if IFACE", "Interface or bridge to capture, for example eth1 or br-1."),
           ("--proto rtsp|rtp", "Both names select camera RTSP control and UDP/TCP-interleaved RTP together. Omit --proto (or use all) for the generic packet renderer."),
-          ("--play term|cv2|native", "Use the same camera dashboard and keys in terminal, OpenCV or native SDL2 windows; GUI video keeps original resolution."),
+          ("--play term|cv2|native|http", "Use the same camera dashboard and keys in terminal, OpenCV native SDL2 windows or the HTTP browser; GUI video keeps original resolution."),
+          ("--host HOST", "HTTP player bind address with --play http. Default: 127.0.0.1; use 0.0.0.0 for all IPv4 interfaces."),
+          ("--port PORT", "HTTP player listen port with --play http. Default: 8080."),
           ("--show-period SECONDS", "Slideshow interval: positive, finite seconds, including fractions. Default: 3. Press s to toggle cameras in single view or pages in grid view; this option does not start it."),
           ("--cam-expiry SECONDS", "Hide cameras after this long without video: positive, finite seconds. Default: 60. Red STALE warning remains at 10 seconds; returning video restores visibility. Also available in sciveo config."),
           ("--view list|grid|table|plain", "Camera list/player, paged grid or statistics; plain shows video only in any display backend."),
@@ -987,6 +989,7 @@ class Help:
           "Live capture requires Scapy, system libpcap and OS capture permissions. Terminal images require Pillow; decoding requires FFmpeg.",
           "Playback uses captured packets only and never reconnects or authenticates to a camera. Wait for codec parameter sets and a keyframe.",
           "Strictly passive: no RTSP, ONVIF or discovery requests and no camera credentials. i cycles main captured stream, info, other captured streams from the same camera, then main. Uncaptured catalog hints are never listed or requested.",
+          "HTTP defaults to http://127.0.0.1:8080/; --host 0.0.0.0 allows LAN access and --port overrides the port; HTML/CSS widgets and binary JPEG frames share the same theme and keys.",
           "All displays consume decoded captured frames only, including native/OpenCV windows; they never open camera URLs. A desktop session is required for GUI windows.",
           "Model/resolution are shown only when advertised or decoded; the observed Ethernet MAC may belong to a router. FPS and Mbit/s use a rolling window; sequence gaps are capture gaps, not confirmed network loss.",
           "H.264, HEVC, AV1 and H.266/VVC RTP reassembly; other advertised formats use FFmpeg SDP/RTP. Missing decoders and decode failures name the codec. Encrypted RTSPS/SRTP cannot be decoded.",
@@ -1003,7 +1006,7 @@ class Help:
         ],
       },
       "nvr": {
-        "summary": "Record RTSP cameras or view them in a terminal without saving video.",
+        "summary": "Record RTSP cameras or play live cameras and HDD recordings in the shared dashboard.",
         "usage": [
           f"{self.name} nvr --input-path CAMS_JSON",
           f"{self.name} nvr --input-path CAMS_JSON --play term --view grid --size 4x5",
@@ -1011,7 +1014,12 @@ class Help:
         "options": [
           ("--input-path PATH", "Camera/NVR configuration JSON file."),
           ("--url URL", "Single RTSP source for terminal playback instead of a camera JSON file."),
-          ("--play term|cv2|native", "Use the same themed camera dashboard in terminal, OpenCV or native SDL2 windows, without recording."),
+          ("e (single video)", "ONVIF PTZ mode: arrows/i/j/k/m move, +/- zoom, Space stops, e returns to camera selection."),
+          ("c (single video)", "Active NVR/RTSP camera settings: clock, time zone, daylight saving, NTP; Enter edits, Apply writes."),
+          ("b (recorded video)", "Pick recording-local date/time, then Enter plays. Immediate seeks: Left/right -/+5min, -/+ -/+1hour (= also advances), p/n -/+1day; ,/. previous/next clip, l latest. PgUp/PgDn also changes day."),
+          ("--play term|cv2|native|http", "Use the same themed camera dashboard in terminal, OpenCV native SDL2 windows or the HTTP browser, without recording."),
+          ("--host HOST", "HTTP player bind address with --play http. Default: 127.0.0.1; use 0.0.0.0 for all IPv4 interfaces."),
+          ("--port PORT", "HTTP player listen port with --play http. Default: 8080."),
           ("--show-period SECONDS", "Slideshow interval: positive, finite seconds, including fractions. Default: 3. Press s to toggle cameras in single view or pages in grid view; this option does not start it."),
           ("--cam-expiry SECONDS", "Hide cameras after this long without video: positive, finite seconds. Default: 60. Red STALE warning remains at 10 seconds; returning video restores visibility. Also available in sciveo config."),
           ("--view list|grid|table|plain", "Use the same player, paged grid and statistics as sniff; plain shows video only. Implies playback only."),
@@ -1030,7 +1038,8 @@ class Help:
           "Local Tapo, Hikvision, Dahua, Axis and Reolink references supplement device reports; catalog capabilities are labeled separately from current measured video. Unsupported ONVIF does not prevent playback.",
           "i cycles main -> camera info/configuration -> URL-ordered secondary video -> JPEG profiles -> main. Info lists profiles, model/manufacturer, firmware and camera time; PgUp/PgDn scrolls. No settings are changed. Playback uses available FFmpeg decoders.",
           "TCP-interleaved RTSP, Basic/Digest authentication, keepalive and reconnect. All streams are buffered. Single view prepares current/previous/next; grid decodes at most 20. Last images survive interruptions with a NO VIDEO DATA stripe until fresh video resumes.",
-          "Playback ignores recording/storage settings and never saves video. Without --play or --view, the existing recording behavior remains.",
+          "Playback reads finalized recordings from recordings.paths, capture paths (BASE/video), or legacy path.video. Optional recordings.scan_period defaults to 5 seconds; recordings.cameras filters directory names. Recording-only JSON needs no cam/auto settings or network access.",
+          "Archive grid follows newest files and shows from/to dates. Single view has a 24-hour availability timeline and b date/time entry. Files follow CAMERA/YYYY-MM-DD/HH.MM.SS-HH.MM.SS.mp4. Playback never saves video; without --play or --view, existing recording behavior remains.",
           "Use camera-specific RTSP paths: Tapo /stream1 or /stream2; Hikvision /Streaming/Channels/101 or /102; Dahua /cam/realmonitor?channel=1&subtype=0 or 1; Axis /axis-media/media.amp.",
           "Grid +/- changes layout; n/p or PageUp/PageDown changes pages; arrows/j/k selects cameras and wraps in single view; s toggles camera/grid-page slideshow (--show-period, default 3s); v video, g grid, t stats, i stream/info, q/Esc exit.",
         ],
@@ -1046,20 +1055,21 @@ class Help:
           f"{self.name} rtsp --url URL",
           f"{self.name} rtsp --url URL --play term",
           f"{self.name} rtsp --url URL --play cv2|native",
+          f"{self.name} rtsp --url URL --play http --port 8080",
           f"{self.name} rtsp --host HOST --port PORT --stream STREAM",
           f"{self.name} rtsp --src SRC [--src-id ID] [--width W] [--height H] [--fps FPS]",
         ],
         "options": [
           ("--url URL", "RTSP URL to play."),
-          ("--play term|cv2|native", "Choose the shared dashboard in terminal, OpenCV or native SDL2 windows. With no --play, select from an availability-marked menu on an interactive terminal."),
+          ("--play term|cv2|native|http", "Choose the shared dashboard in terminal, OpenCV native SDL2 windows or the HTTP browser. With no --play, select from an availability-marked menu on an interactive terminal."),
           ("--duration SECONDS", "Stop terminal, OpenCV or native FFplay playback after this positive, finite interval."),
           ("--show-period SECONDS", "Slideshow interval: positive, finite seconds, including fractions. Default: 3. Press s to toggle cameras in single view or pages in grid view; this option does not start it."),
           ("--cam-expiry SECONDS", "Hide cameras after this long without video: positive, finite seconds. Default: 60. Red STALE warning remains at 10 seconds; returning video restores visibility. Also available in sciveo config."),
           ("--input-path PATH", "NVR-format camera JSON for terminal playback; see nvr help."),
           ("--view list|grid|table|plain", "Shared camera dashboard by default; plain retains the simple video window. GUI and terminal share themes and keys."),
           ("--size N|COLUMNSxROWS", "Terminal grid size, maximum 4x5."),
-          ("--host HOST", "RTSP host or server bind host."),
-          ("--port PORT", "RTSP port."),
+          ("--host HOST", "RTSP host or server bind host; with --play http, HTTP bind address (default 127.0.0.1; 0.0.0.0 for all IPv4 interfaces)."),
+          ("--port PORT", "RTSP server port; with --play http, HTTP listen port (default 8080), so specify the camera using --url."),
           ("--stream STREAM", "RTSP stream path/name."),
           ("--src SRC", "Server source, for example color or camera source."),
           ("--src-id ID", "Camera/source id."),
@@ -1076,6 +1086,7 @@ class Help:
           "The native dashboard needs SDL2, Pillow, FFmpeg and a desktop session; OpenCV needs a GUI-enabled cv2 build. All backends use the same camera widgets, navigation, grid, info, statistics and theme. q/Esc or closing the window exits; audio is disabled.",
           "Use --view plain for the previous simple player: FFplay on macOS/Linux, registered RTSP handler on Windows. RTSPS currently uses this plain path. An explicit native selection skips throwaway GUI probe windows.",
           "OpenCV playback needs a GUI-enabled cv2 build and a display. Without a terminal, no --play selects an available GUI player.",
+          "Active NVR/RTSP single video: e toggles ONVIF PTZ; arrows or i/j/k/m move; +/- zoom if supported; Space stops. Passive sniffing never controls cameras.",
           "The shared RTSP dashboard supports authenticated URLs in every display backend. The legacy native plain launcher disallows embedded credentials, queries and fragments. Terminal display requires POSIX terminal controls, Pillow and FFmpeg.",
           "ONVIF is opt-in for stream servers only. Its protocol API is sciveo.network.onvif, alongside network.modbus and network.snmp.",
           "onvif may be true, false or an object: host, port, advertise_host, discovery, users, identity, state_path, allow_system_time.",
@@ -1095,10 +1106,10 @@ class Help:
       "capture": {
         "summary": "Play video from a TV test pattern, file, camera, screen, Raspberry Pi camera or RTSP source.",
         "usage": [
-          f"{self.name} capture --src tv --play term|cv2|native",
-          f"{self.name} capture --input-path VIDEO --play term|cv2|native",
-          f"{self.name} capture --url RTSP_URL --play term|cv2|native",
-          f"{self.name} capture --src cam --src-id ID --play term|cv2|native",
+          f"{self.name} capture --src tv --play term|cv2|native|http",
+          f"{self.name} capture --input-path VIDEO --play term|cv2|native|http",
+          f"{self.name} capture --url RTSP_URL --play term|cv2|native|http",
+          f"{self.name} capture --src cam --src-id ID --play term|cv2|native|http",
           f"{self.name} capture --src screen [--src-id DISPLAY] [--data-json REGION]",
           f"{self.name} capture --src rpi [--src-id ID] [--width W] [--height H]",
         ],
@@ -1106,7 +1117,9 @@ class Help:
           ("--src cam|screen|rpi|tv", "Capture source. tv (also test/color) generates a moving FFmpeg test pattern entirely in memory."),
           ("--input-path VIDEO", "Play a local video file using the installed FFmpeg decoders."),
           ("--url RTSP_URL", "Play RTSP through the same player selection as sciveo rtsp."),
-          ("--play term|cv2|native", "Choose the shared dashboard display independently of the source. Omit it for the availability-marked player selector."),
+          ("--play term|cv2|native|http", "Choose the shared dashboard display independently of the source. Omit it for the availability-marked player selector."),
+          ("--host HOST", "HTTP player bind address with --play http. Default: 127.0.0.1; use 0.0.0.0 for all IPv4 interfaces."),
+          ("--port PORT", "HTTP player listen port with --play http. Default: 8080."),
           ("--view list|grid|table|plain", "Use shared camera views, or plain for video without dashboard controls."),
           ("--duration SECONDS", "Stop after a positive, finite interval. q/Esc or closing a video window exits."),
           ("--theme NAME", "Shared terminal/GUI player theme; uses the global theme when omitted. [ and ] cycle themes."),
@@ -1118,6 +1131,7 @@ class Help:
         ],
         "examples": [
           f"{self.name} capture --src tv --play native",
+          f"{self.name} capture --src tv --play http --port 8080",
           f"{self.name} capture --src tv --play cv2 --duration 30",
           f"{self.name} capture --src tv --play term --theme amber",
           f"{self.name} capture --input-path video.mp4 --play native",