Note: Source window is censored in this image.

NDI Viewer

A lightweight and stable NDI viewer application for macOS that allows you to view multiple NDI video sources with minimal resource usage.

Features

• View multiple NDI sources simultaneously
• Low resource usage (10 FPS default)
• Automatic source discovery
• Stable performance with automatic reconnection
• Clear status indicators and FPS display
• Simple and intuitive interface

Requirements

• macOS
• Python 3.12 or later
• NDI Video Monitor app (for NDI library)

Installation

1. Install NDI Video Monitor:

   • Download NDI Video Monitor from https://ndi.video/tools/ndi-video-monitor/
   • Install the application

2. Get the NDI library:

   • Right-click on NDI Video Monitor in Applications
   • Select "Show Package Contents"
   • Navigate to Contents/Frameworks/
   • Copy libndi_advanced.dylib to the ndi_viewer directory

3. Install the required Python packages:

pip install -r requirements.txt

Usage

1. Run the viewer:

python3 ndi_viewer.py

2. Using the viewer:
   • Click "Refresh" to scan for NDI sources
   • Select a source from the dropdown menu
   • Click "Connect" to view the stream
   • The status bar shows connection state and FPS
   • Click "Disconnect" to stop viewing

Performance Settings

Default settings are optimized for stability:

• Frame rate: 10 FPS
• Resolution: 640x480
• CPU processing only

Troubleshooting

If you experience issues:

1. Check the ndi_viewer.log file for error messages
2. Ensure NDI sources are running on your network
3. Try disconnecting and reconnecting to the source
4. If you get "NDI Library Not Found" error:
   • Verify NDI Video Monitor is installed
   • Check that libndi_advanced.dylib is in the correct location
   • Make sure the file permissions allow read access

Files

• ndi_viewer.py - Main application
• requirements.txt - Python dependencies
• ndi_viewer.log - Application log file

License

This project uses the NDI SDK, which is subject to the NDI SDK License Agreement. NDI® is a registered trademark of Vizrt Group.