smilebasic-launcher
===================

Launches SmileBASIC-under-QEMU. This package is only the launcher + host
daemon; you supply and manage the Docker image yourself.

Install the image (one time):
    docker load -i sbqemu.tar

Run:
    smilebasic-launcher

What the launcher does:
    1. Checks that the Docker image (default sbqemu:latest) is present;
       if not, it prints load instructions and exits.
    2. Starts the container (default name sbqemu) if it is not running.
    3. Starts smilebasic-daemon (host video+audio server) if not running.
    4. Runs `docker exec sbqemu /root/run-sb.sh` to start SmileBASIC.

Environment overrides:
    SB_IMAGE       Docker image     (default sbqemu:latest)
    SB_CONTAINER   container name   (default sbqemu)
    DISPLAY        X display        (default :0)

The host daemon logs to $TMPDIR/smilebasic-daemon.log (usually
/tmp/smilebasic-daemon.log).

Dependencies:
    docker            - runs the container
    x11-xserver-utils - xhost, to authorise local X clients
    libvirglrenderer1 - required by the video server
    virgl-server      - provides virgl_test_server (GPU replay). Recommended;
                        without it the daemon runs audio-only.
    an audio player   - alsa-utils (aplay) / pulseaudio-utils (pacat) /
                        pipewire-bin (pw-cat) / ffmpeg (ffplay); the daemon
                        auto-detects whichever is installed.
