The session-stream web app: a single HTTP listener (9988) that serves a page
per enabled session, keyed by a spoken phrase.
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. Tests: tests/live (51), all green with the full suite
(958). Not yet wired to the broker -- that is stage 2.
50 lines
1.8 KiB
Nix
50 lines
1.8 KiB
Nix
{
|
|
lib,
|
|
python3,
|
|
...
|
|
}:
|
|
python3.pkgs.buildPythonApplication {
|
|
pname = "hhstream";
|
|
version = "0.1.0";
|
|
pyproject = true;
|
|
|
|
src = ../.;
|
|
|
|
build-system = [ python3.pkgs.setuptools ];
|
|
|
|
# `hhstream-pointer` is a Wayland client, so it needs libwayland's
|
|
# marshalling; and it resolves keysym names against the XKB layout it
|
|
# uploads, so it needs xkbcommon.
|
|
#
|
|
# Neither protocol XML is a build input: both generated modules are vendored
|
|
# under src/hhstream_pointer/_protocol, so a checkout builds without a code
|
|
# generator. See that package's docstring for why, and
|
|
# hhstream_pointer._protocol.regenerate for how to refresh them -- including
|
|
# the note that virtual-keyboard-unstable-v1.xml is not in wayland-protocols
|
|
# or wlr-protocols in this nixpkgs and comes from pkgs.hyprland.src.
|
|
dependencies = [ python3.pkgs.pywayland python3.pkgs.xkbcommon ];
|
|
|
|
# Unit tests are wired up in the flake's `checks` so they can run without
|
|
# installing the package; see docs/CONTRACT.md.
|
|
doCheck = false;
|
|
|
|
# Cheap proof that the vendored protocols still bind against this pywayland:
|
|
# importing each runs the scanner-generated `_gen_c()` for its interfaces.
|
|
pythonImportsCheck = [
|
|
"hhstream_pointer.ops"
|
|
"hhstream_pointer.keymap"
|
|
"hhstream_pointer._protocol.wlr_virtual_pointer_unstable_v1"
|
|
"hhstream_pointer._protocol.virtual_keyboard_unstable_v1"
|
|
# The web app. Importing the server pulls in the router, the publisher and
|
|
# the pages; the phrase generator's wordlist is checked by the unit suite,
|
|
# which reads the *installed* package.
|
|
"hhstream_live.server"
|
|
];
|
|
|
|
meta = {
|
|
description = "Publish a headless Hyprland session's frames on a Unix socket";
|
|
license = lib.licenses.mit;
|
|
mainProgram = "hhstream-server";
|
|
};
|
|
}
|