shirayu · July 10, 2026 02:19
diff --git a/0.Play Audio and Desktop Notifications from Docker or Podman Containers.md b/0.Play Audio and Desktop Notifications from Docker or Podman Containers.md
diff --git a/1.check_integration.py b/1.check_integration.py
 #!/usr/bin/env python3

 # SPDX-License-Identifier: AGPL-3.0-only
 # Copyright (c) shirayu

 import math
 import os
 import shutil
 import subprocess
 import sys
 import tempfile
 import wave
 from pathlib import Path
 from typing import NoReturn

 HOST_RUNTIME_DIR = Path("/run/host")


 def fail(message: str) -> NoReturn:
    print(f"ERROR: {message}", file=sys.stderr)
    raise SystemExit(1)


 def require_socket(path: Path) -> None:
    if not path.exists():
        fail(f"Socket does not exist: {path}")

    if not path.is_socket():
        fail(f"Path is not a UNIX socket: {path}")


 def require_command(name: str) -> None:
    if shutil.which(name) is None:
        fail(f"Required command is not installed: {name}")


 def require_environment(name: str, expected: str) -> None:
    actual = os.environ.get(name)

    if not actual:
        fail(f"{name} is not set")

    if actual != expected:
        fail(f"{name} must be {expected!r}, but is {actual!r}")


 def check_integration_configuration() -> None:
    pulse_socket = HOST_RUNTIME_DIR / "pulse" / "native"
    dbus_socket = HOST_RUNTIME_DIR / "bus"

    require_socket(pulse_socket)
    require_socket(dbus_socket)

    require_environment(
        "PULSE_SERVER",
        f"unix:{pulse_socket}",
    )
    require_environment(
        "DBUS_SESSION_BUS_ADDRESS",
        f"unix:path={dbus_socket}",
    )


 def run_command(command: list[str], description: str) -> None:
    try:
        subprocess.run(
            command,
            check=True,
            stdout=subprocess.DEVNULL,
            stderr=subprocess.PIPE,
            text=True,
        )
    except subprocess.CalledProcessError as error:
        details = error.stderr.strip() or f"exit status {error.returncode}"
        fail(f"{description} failed: {details}")


 def write_test_tone(path: Path) -> None:
    sample_rate = 44_100
    duration_seconds = 0.25
    frequency_hz = 880
    amplitude = 0.25

    frame_count = int(sample_rate * duration_seconds)
    frames = bytearray()

    for index in range(frame_count):
        sample = int(32_767 * amplitude * math.sin(2 * math.pi * frequency_hz * index / sample_rate))
        frames.extend(sample.to_bytes(2, "little", signed=True))

    with wave.open(str(path), "wb") as sound:
        sound.setnchannels(1)
        sound.setsampwidth(2)
        sound.setframerate(sample_rate)
        sound.writeframes(frames)


 def check_notification() -> None:
    require_command("notify-send")

    run_command(
        [
            "notify-send",
            "Container Test",
            "Notification integration works!",
        ],
        "Desktop notification test",
    )

    print("Sent a desktop notification.")


 def check_audio() -> None:
    require_command("paplay")

    with tempfile.TemporaryDirectory() as temp_dir:
        sound_path = Path(temp_dir) / "test.wav"
        write_test_tone(sound_path)

        run_command(
            ["paplay", str(sound_path)],
            "Audio playback test",
        )

    print("Played a test sound through PulseAudio/PipeWire.")


 def main() -> None:
    check_integration_configuration()
    check_notification()
    check_audio()

    print("Container integration commands completed successfully.")
    print("Please confirm that the notification appeared and the sound was audible.")


 if __name__ == "__main__":
    main()
	#!/usr/bin/env python3

	# SPDX-License-Identifier: AGPL-3.0-only
	# Copyright (c) shirayu

	import math
	import os
	import shutil
	import subprocess
	import sys
	import tempfile
	import wave
	from pathlib import Path
	from typing import NoReturn

	HOST_RUNTIME_DIR = Path("/run/host")


	def fail(message: str) -> NoReturn:
	print(f"ERROR: {message}", file=sys.stderr)
	raise SystemExit(1)


	def require_socket(path: Path) -> None:
	if not path.exists():
	fail(f"Socket does not exist: {path}")

	if not path.is_socket():
	fail(f"Path is not a UNIX socket: {path}")


	def require_command(name: str) -> None:
	if shutil.which(name) is None:
	fail(f"Required command is not installed: {name}")


	def require_environment(name: str, expected: str) -> None:
	actual = os.environ.get(name)

	if not actual:
	fail(f"{name} is not set")

	if actual != expected:
	fail(f"{name} must be {expected!r}, but is {actual!r}")


	def check_integration_configuration() -> None:
	pulse_socket = HOST_RUNTIME_DIR / "pulse" / "native"
	dbus_socket = HOST_RUNTIME_DIR / "bus"

	require_socket(pulse_socket)
	require_socket(dbus_socket)

	require_environment(
	"PULSE_SERVER",
	f"unix:{pulse_socket}",
	)
	require_environment(
	"DBUS_SESSION_BUS_ADDRESS",
	f"unix:path={dbus_socket}",
	)


	def run_command(command: list[str], description: str) -> None:
	try:
	subprocess.run(
	command,
	check=True,
	stdout=subprocess.DEVNULL,
	stderr=subprocess.PIPE,
	text=True,
	)
	except subprocess.CalledProcessError as error:
	details = error.stderr.strip() or f"exit status {error.returncode}"
	fail(f"{description} failed: {details}")


	def write_test_tone(path: Path) -> None:
	sample_rate = 44_100
	duration_seconds = 0.25
	frequency_hz = 880
	amplitude = 0.25

	frame_count = int(sample_rate * duration_seconds)
	frames = bytearray()

	for index in range(frame_count):
	sample = int(32_767 * amplitude * math.sin(2 * math.pi * frequency_hz * index / sample_rate))
	frames.extend(sample.to_bytes(2, "little", signed=True))

	with wave.open(str(path), "wb") as sound:
	sound.setnchannels(1)
	sound.setsampwidth(2)
	sound.setframerate(sample_rate)
	sound.writeframes(frames)


	def check_notification() -> None:
	require_command("notify-send")

	run_command(
	[
	"notify-send",
	"Container Test",
	"Notification integration works!",
	],
	"Desktop notification test",
	)

	print("Sent a desktop notification.")


	def check_audio() -> None:
	require_command("paplay")

	with tempfile.TemporaryDirectory() as temp_dir:
	sound_path = Path(temp_dir) / "test.wav"
	write_test_tone(sound_path)

	run_command(
	["paplay", str(sound_path)],
	"Audio playback test",
	)

	print("Played a test sound through PulseAudio/PipeWire.")


	def main() -> None:
	check_integration_configuration()
	check_notification()
	check_audio()

	print("Container integration commands completed successfully.")
	print("Please confirm that the notification appeared and the sound was audible.")


	if __name__ == "__main__":
	main()
No results found