ShowVizz 1.0.0
The stage player for TraxxTool Lighting Studio.

Linux, 64 bit x86. Built on Ubuntu 22.04, so any distribution with glibc
2.35 or newer runs it: Ubuntu 22.04 and later, Debian 12 and later,
Fedora 36 and later.


THE SCREENS
  Run ./start-showvizz.sh. That is the whole of it: it starts the player
  with its on-stage screens up, and they are where you pick tonight's show
  and band, say where the lights and the MIDI are, walk the show by hand
  before doors, and hit BLACKOUT.

  The same thing by hand, if you would rather:
        ./showvizz-player --ui

  Everything you set on those screens is remembered, so the next night you
  run the same file and it comes up the way you left it.

  To put ShowVizz in the desktop's own app menu, copy showvizz.desktop
  into ~/.local/share/applications and showvizz.png into
  ~/.local/share/icons - the second copy is what gives the menu entry its
  icon.

WHAT TO DO
  1. Unpack this whole folder somewhere on the stage machine. Keep it
     together: the player loads the files next to it.
  2. Export your show from TraxxTool. You get a show folder.
  3. Run:
        ./showvizz-player "/path/to/your show" --output artnet --midi-line 0
  4. ./showvizz-player --list shows the songs in a show and the outputs
     this machine can see. Nothing goes on the wire.

WHAT THIS MACHINE HAS TO HAVE ALREADY
  The graphics and X11 stack, because those belong to the machine and a
  bundled copy would shadow the driver. On Debian or Ubuntu:

    sudo apt-get install libgl1 libegl1 libxkbcommon-x11-0 libxcb-cursor0 \
         libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 \
         libxcb-render-util0 libxcb-shape0 libxcb-xinerama0 libasound2

  If the player starts and says it cannot find the Qt platform plugin xcb,
  one of those is missing. Run it again with QT_DEBUG_PLUGINS=1 and the
  message names the file.

IF A LIGHT WILL NOT ANSWER
  ./showvizz-dmxprobe --list      what adapters this machine has
  ./showvizz-dmxprobe --ramp      make a light at address 1 breathe

  If --list finds nothing and the adapter is plugged in, it is almost
  always permissions. See udev/README.txt.

MIDI
  ./showvizz-player --midi-list shows the MIDI inputs this machine can
  see, through the ALSA sequencer. A Stage Traxx 4 iPad connected by USB
  or by a network MIDI bridge appears there.

VIDEO FORMATS
  This player decodes H.264 (.mp4), VP9 (.webm), PNG and JPEG stills, and
  ProRes 4444 or QuickTime Animation (.mov) when a logo needs to be
  see-through. Export from TraxxTool and you get the right one. Anything
  else will not open: the layer says so and whatever is beneath it stays
  on the wall, so the show does not stop.

  That list is the whole of it, on purpose, it is the same on every
  platform, and it is checked at build time against the shipped
  libraries. See licenses/THIRD_PARTY.md.

SHOW FORMAT
  This player opens shows up to format 1. A show exported by a
  newer TraxxTool than this player says so and stops rather than half
  playing. Let TraxxTool hand you the matching player and this cannot
  happen.

  ./showvizz-player --version prints both numbers.

LICENCES
  See the licenses folder. Parts of this player come from Q Light
  Controller Plus, under the Apache License 2.0. The video path is
  libmpv, libplacebo and FFmpeg, all built under the LGPL 2.1 and shipped
  here as ordinary shared objects you are free to replace with your own
  build. licenses/THIRD_PARTY.md lists every file in this folder, where it
  came from and under what terms, and tells you how to check that for
  yourself.
