OpenFollow Preview

Manual / Getting Started

Try It Out

See OpenFollow work in about ten minutes, without a camera, a stage or a console. A fresh station boots with a sample stage picture, a calibrated grid and marker 1 ready to move.

What you need

  • Raspberry Pi 5 with a power supply and a microSD card (16 GB or larger)
  • An HDMI display
  • A USB keyboard or a USB-wired gamepad
  • A Mac or PC where you can run Raspberry Pi Imager
  • Optional: a network cable to your LAN, for the web interface and PSN

A Compute Module 5 works the same way; flashing its eMMC is described in Installation → Compute Module 5.

1. Flash and boot

  1. In the Download section of this website, choose For Raspberry Pi 5 and download the Raspberry Pi 5 Image (openfollow-pi5_<version>.img.xz).
  2. In Raspberry Pi Imager: Choose OS → Use custom, select the file, Choose Storage → the microSD card → Write.
  3. Insert the card, connect the display, keyboard or gamepad and network, then power on.

The Pi boots straight into the Operator Screen: the Stage scene from the built-in Media Gallery, the grid on its floor and marker 1. The panel in the bottom-left corner shows the station’s IP Address.

Operator Screen of a new station: the Media Gallery Stage picture with the grid's corner marks on the floor, Marker 1 standing at the Reference Point, the Show help label top left, the station panel with IP Address bottom left and the Marker 1 card bottom right.
A new station on first boot.

2. Move the marker

Steer marker 1 with a USB-wired gamepad, such as an Xbox1 or PlayStation2 controller, or the keyboard of the station. Choose yours:

Xbox gamepad with each button's default action: LT lower the marker, RT raise it, LB slower, RB faster, View the Settings menu, Y the key list, B cancel and A confirm in a menu, X reset the marker, D-pad left and right the previous and next marker, the right stick moves the marker, the left stick is not used.

The marker card shows the position in metres from the Reference Point, which in the Stage scene is the middle of the grid’s downstage edge. Every position OpenFollow sends is measured from there.

A gamepad that doesn’t respond is usually wireless or not in XInput mode – see Gamepad not detected.

3. Open the web interface

On a computer on the same network, browse to http://<IP Address> from the Operator Screen. The Overview tab lists this station under Station Network. All settings live here; the Web Interface chapter tours the tabs.

If the page doesn’t open, check that both devices are on the same subnet. A network without DHCP needs an address set on the station: press M (gamepad: BACK) for the Settings menu, then Network Interfaces.

4. See the PSN data

The station sends marker 1 as PSN from the moment it boots, on multicast group 236.10.10.10, port 56565.

  • With a console: add a PSN input on a console in the same subnet – grandMA3, ChamSys MagicQ and Hog 5 accept PSN – and move the marker. The position updates at about 60 Hz.
  • Without a console: run PSNView by OpenFollow on your Mac or PC (macOS, Windows and Linux) and pick the network interface that reaches the station. Marker 1 appears with its position as you move it.
PSNView receiving the station's PSN: interface, multicast group 236.10.10.10 and port 56565 at the top, one row for tracker 1, Marker 1, at X 0, Y 0, Z 1.6, and the status bar showing Receiving from the station at about 60 packets per second.
PSNView receiving marker 1 from a new station.

ETC Eos takes positions over OSC instead of PSN; see Move lights with ETC Eos.

5. Practise a calibration

The Stage picture has a taped 10 × 6 m rectangle on the floor, so you can run the Setup Wizard before you have a camera. Open Camera & Grid → Open Setup Wizard.

Video Source

Keep Media Gallery with the Stage tile selected and click Save & Next.

Setup Wizard, Video Source step: Source Type Media Gallery with the Stage tile selected among Stage, Concert, Festival and Grey, and the Save and Save & Next buttons.

Lens

The Stage picture has no lens distortion, so there is nothing to measure: click Next without drawing lines.

A station that was calibrated before first shows This camera has a lens calibration with three options. Choose Clear it and measure the lens again, then click Next without drawing lines.

Setup Wizard, Lens step on a new station: the note Draw straight lines on the picture above the Stage picture, the line buttons, and Next.

Camera Calibration

In Simple mode, fill in the first three questions:

  • Where is your camera? – Front of House.
  • What is the size of your rectangle? – width 10 m, depth 6 m.
  • Where is the point of origin? – keep Default, centred between DSL and DSR.
Setup Wizard, Camera Calibration in Simple mode: camera at Front of House, rectangle 10 by 6 m, point of origin Default, and the note Drag DSL onto its tape mark.

Place the corners

Drag each of the four corners – DSL, DSR, USR, USL – onto its tape mark. While you drag, a loupe shows the picture 4× larger; let go when its crosshair sits on the mark. Once all four are placed, the grid lies on the floor. Click Next.

Animation: three corners already sit on the Stage picture's tape marks, the last corner, USL, is dragged onto its mark with the 4x loupe showing, and the grid snaps onto the floor.
Dragging the last corner onto its tape mark.

Review

Check that the grid lies on the floor and click Save and finish. The note that the lens was not measured is expected here. Then move the marker along the tape lines: it should follow them.

Setup Wizard Review step: the grid over the Stage picture, a Something might be wrong note because the lens was not measured, and the Camera, Lens, Calibration and Grid values with Save and finish.

The Festival and Concert pictures were taken with a wide lens. To practise the Lens step as well, calibrate one of them: draw lines along edges that are straight on stage, such as the tape and the deck seams, before you place the 12 × 6 m corners.

Next steps

  • Core Concepts – the terms used in the rest of the manual.
  • Quick Start – set up a real camera on a real stage.
  • How To – move lights from grandMA2, grandMA3, ETC Eos or ChamSys MagicQ.

1. Xbox is a trademark of the Microsoft group of companies. OpenFollow is not affiliated with or endorsed by Microsoft.

2. PlayStation is a registered trademark or trademark of Sony Interactive Entertainment Inc. OpenFollow is not affiliated with or endorsed by Sony.