OpenFollow Preview

Manual / Help

PSNView

PSNView is a free desktop viewer for PSN by the OpenFollow project. It shows every tracker on the network with its position, speed and status, so you can check what a station sends without a console. It also sends test trackers to any PSN receiver.

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 station.

Install

Download the build for your computer from github.com/openfollowapp/psnview/releases.

PlatformFileHow to run
macOS (Apple Silicon)PSNView-<version>-macos-arm64.dmgOpen the DMG and drag PSNView into Applications.
WindowsPSNView-<version>-windows-x64.exeRun the file. No installer.
LinuxPSNView-<version>-linux-x64.tar.gzExtract and run PSNView (X11 or XWayland).
  • macOS asks for Local Network access on first launch. Allow it, or PSNView receives nothing.
  • Windows warns on first launch because the build is unsigned.
  • Windows and Linux take a few seconds to open the window.

View a station’s PSN

  1. Connect the computer to the same subnet as the station.
  2. Pick the network Interface that reaches the station. 0.0.0.0 listens on every interface and is usually right.
  3. Leave Port at 56565. PSNView listens on multicast group 236.10.10.10, OpenFollow’s default.
  4. Press Start. Each marker the station controls appears as one row.

Clear empties the table; trackers still on the wire come back with their next packet.

Reading the table

ColumnFrom an OpenFollow station
IDMarker ID.
NameMarker name from the marker catalog.
Pos X / Y / ZPosition in metres from the Reference Point.
Speed X / Y / ZVelocity in m/s; 0 while the marker stands still.
Ori, Accel, TargetAlways 0.
StatusTracker status, 0.0 to 1.0 – see Output Protocols → Tracker Status.
TimestampThe station’s own clock in microseconds.
Age (s)Seconds since PSNView last received this tracker.

A row turns gray after 2 seconds without data. The status bar shows Receiving or Listening (no data), the sending station’s name, the packet rate and the current frame. A station sends about 60 packets per second.

When something is missing

  • Listening (no data) on 0.0.0.0: pick the interface on the station’s subnet explicitly. A computer with Wi-Fi and Ethernet often listens on the wrong one.
  • Rows appear, but the console still sees nothing: the station is sending; the problem is between the switch and the console. See PSN not received by the console.
  • A row turns gray: that marker’s PSN stopped arriving. The station stopped, lost its network, or no longer controls the marker.
  • Rows update but Status reads 0.0: the station still sends but has stopped moving its markers – see The stream is live but nothing moves.

Send test trackers

Send in the toolbar opens a PSN transmitter. Use it to test a console’s PSN input before an OpenFollow station is on the network.

  1. Pick the Interface to send from. A LAN interface reaches other receivers; 127.0.0.1 reaches PSNView on the same computer.
  2. Set a System name; receivers show it as the server name.
  3. Edit the trackers in the table, or use Add tracker and Remove tracker. PSNView sends up to 13 trackers. Leave Timestamp blank to send the time since the transmitter started.
  4. Send once sends one packet. Start streams at the Rate (Hz) you set, up to 60 Hz.
  5. Animate moves the positions while streaming: Sine circles in the XY plane, Ramp sweeps along X, by Amplitude (m) over Period (s).

Do not send tracker IDs that an OpenFollow station on the same network also sends: the console then receives two positions for one tracker.

Source and issues

PSNView is free software under the AGPL-3.0. Source code and issue reports: github.com/openfollowapp/psnview.