FeedBeat - The Stage Performance Platform

Index

1. Purpose
2. Prerequisites
3. Configure
4. Build
5. Run
6. Test
7. Setup
8. Understand
9. License
10. Support

Purpose

FeedBeat is a platform for hybrid and digital stage performances.
Designed especially for actors and audiences with fairness & privacy in mind.
It includes features for high interactivity and strong feedback to create the best connection between actors and audience in live situations.
FeedBeat supports standard (RTMP) an low latency (WebRTC) streaming for interactivity and massive reach.
Typical use cases are events such as concerts, comedy shows, readings, game shows, conferences or panel discussions.

Prerequisites

In order to install FeedBeat it is required to have the following logical machines. Although it is possible to host everything on a single machine we recommend to host each on a dedicated machine for improved scalability, isolation and maintenance.

• FeedBeat server (e.g. Ubuntu)
• WebRTC streaming server (e.g. Jitsi or Livekit)
• RTMP streaming server (e.g. NGINX/RTMP or Vimeo)

Configure

• Adjust all settings in application.yaml according to your needs. All settings can be overwritten at the application startup as shown in the run section.
• Create json file in the folder principalconfigs with the following content:

{
    "name":"john",
    "organization":"FeedBeat",
    "displayName":"John Doe",
    "permissions":["ADMIN","ADMIN_ALL"],
    "password":"bcryptedpassword"
}

Password generator: https://www.springboot.ch/tools/crypt/bcrypt
Normal users get permission ADMIN, whereas Superuser also get ADMIN_ALL.

Build

In order to build FeedBeat from the sources you need the following software:

• Java JDK >= 17
• Maven

Build FeedBeat-Jar via mvn clean install.
Build Docker-Image via mvn compile jib:dockerBuild

Development

For development you need to install:

• NodeJS: https://nodejs.org/en/download/
• Angular CLI: npm install -g @angular/cli

Run

Plain

Copy the FeedBeat-Jar to the server and run it.
Example (replace the placeholder to match your specific environment):

java -jar <FEEDBEAT-JAR>.jar --server.port=8082 --server.ssl.enabled=false

Docker

docker run --rm -it -p 8082:8082 feedbeat/server:latest

Test

http://localhost:8082/admin/login
Login with the credentials specified in the configuration section.

If you want to test a live instance without setting everything up yourself, please register for an admin account at https://live1.feedbeat.io/admin/register

Setup

FeedBeat is a proven solution with many years production use and thousands of events. The platform is tested and used with audiences of all sizes ranging from 10 up to 3000 participants. The FeedBeat setup is described above.

In order to create a production grade setup one needs FeedBeat + RTMP Server + WebRTC Server, ideally on dedicated machines for maximum load and scalabilty. To setup those additional services please refer to the respective documentation on the web.

Resources

• WebRTC: Livekit or Jitsi Meet
• RTMP: Nginx + RTMP or Vimeo

Understand

Architecture documentation

License

Copyright (c) 2025 Wolfgang Pleus
FeedBeat is distributed by an AGPL-3.0 Licence.

Support

Built with ♥️
In case you need support please contact info@feedbeat.io.
We can help you for example with server provisioning or special feature development.