Files
hyprland-headless-stream-pl…/tests/live/fake_jpeg.py
T
Hermenix 9744d35945 feat(live): one port, a router, and a phrase per session (stage 1)
The session-stream web app: a single HTTP listener (9988) that serves a page
per enabled session, keyed by a spoken phrase. Off by default, so a stream
exists only for the sessions it was enabled on.

  src/hhstream_live/phrase.py     four EFF-large words + a 5-char base-36 tail
                                  (~77.5 bits); the phrase is the password
  src/hhstream_live/publisher.py  one capture thread + one frame slot per
                                  output; one slot/no queue; capture paused at
                                  zero viewers
  src/hhstream_live/server.py     the router: /, /<phrase>/, /stream.mjpg,
                                  /frame.jpg, /status.json; unknown phrase is
                                  an empty 404, rate-limited
  src/hhstream_live/pages.py      the built-in dark pages (no CDN, no build)
  src/hhstream_live/__main__.py   hhstream-live serve|phrase, standalone

The root page is a form, never a list: the phrase is known only by whoever
enabled the stream. Transport is MJPEG (multipart/x-mixed-replace), reusing
the JPEG grim already produces. Not yet wired to the broker -- that is
stage 2. Tests: tests/live (51).
2026-10-06 13:32:00 +00:00

32 lines
1.3 KiB
Python

"""A tiny real JPEG, for tests that need decodable image bytes.
The frame server's tests use a fake that writes a PNG (zlib is in the standard
library). MJPEG needs *JPEG* parts, and there is no JPEG encoder in the stdlib,
so the smallest honest thing is one real 1x1 JPEG embedded as base64 and reused.
`jpeg_bytes(marker)` rewrites one *quantisation-table* byte, so two frames differ
byte-for-byte (a test can prove "a new frame arrived") while the image stays
valid: the EOI marker, the headers and the scan data are untouched.
"""
from __future__ import annotations
import base64
#: A 1x1 JPEG. Real enough that `hhstream.capture.image_size` reports (1, 1).
_ONE_PIXEL = (
"/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRof"
"Hh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/wAALCAABAAEBAREA/8QAFAAB"
"AAAAAAAAAAAAAAAAAAAACf/EABQQAQAAAAAAAAAAAAAAAAAAAAD/2gAIAQEAAD8AVN//2Q=="
)
#: The start of the quantisation table: `FFDB`, length `0043`, precision/id `00`.
_DQT = b"\xff\xdb\x00C\x00"
def jpeg_bytes(marker: int = 0) -> bytes:
"""The 1x1 JPEG with one table byte varied by `marker` (0..249)."""
data = bytearray(base64.b64decode(_ONE_PIXEL))
start = data.index(_DQT) + len(_DQT)
data[start + 63] = (marker % 250) + 1 # a nonzero quantiser keeps it decodable
return bytes(data)