Eyevinn Open Intercom Server

Part of Eyevinn Open Intercom Solution

Eyevinn Open Intercom is a low latency, web based, open source, high quality, voice-over-ip intercom solution. It is designed to be used in broadcast and media production environments, where low latency and high quality audio are critical. The solution is built on top of WebRTC technology and provides a user-friendly interface for managing intercom channels and users.

Requirements

• A Symphony Media Bridge running and reachable
• A MongoDB server or CouchDB server
• Docker engine

Hosted Solution

Available as an open web service in Eyevinn Open Source Cloud. Read this documentation to quickly get started with the hosted solution.

Environment variables

Variable name	Description
PORT	Intercom-Manager API port
SMB_ADDRESS	The address:port of the Symphony Media Bridge instance
SMB_APIKEY	When set, provide this API key for the Symphony Media Bridge (optional)
DB_CONNECTION_STRING	DB connection string (default: mongodb://localhost:27017/intercom-manager)
PUBLIC_HOST	Hostname for frontend application for generating URLs to share
OSC_ACCESS_TOKEN	Personal Access Token from OSC for link sharing and reauthenticating
MONGODB_CONNECTION_STRING	DEPRECATED: MongoDB connection string

Installation / Usage

Start an Intercom Manager instance:

docker run -d -p 8000:8000 \
  -e PORT=8000 \
  -e SMB_ADDRESS=http://<smburl>:<smbport> \
  -e DB_CONNECTION_STRING=<mongodb|http>://<host>:<port>/<db-name> \
  eyevinntechnology/intercom-manager

The API docs is then available on http://localhost:8000/api/docs/

Development

Requires Node JS engine >= v18 and MongoDB (tested with MongoDB v7) or CouchDB.

Install dependencies

npm install

Run tests

npm test

Start server locally

SMB_ADDRESS=http://<smburl>:<smbport> SMB_APIKEY=<smbapikey> npm start

See Environment Variables for a full list of environment variables you can set. The default DB_CONNECTION_STRING is probably what you want to use for local development unless you use a remote db server.

Terraform infrastructure

Requires terraform and AWS access

cd infra
terraform init -var-file="dev.tfvars"

Development workspace

Create or select workspace dev

cd infra
terraform workspace new dev

or

cd infra
terraform workspace select dev

Create resources with variables for dev environment

terraform plan -var-file="dev.tfvars"
terraform apply -var-file="dev.tfvars"

Production workspace

Create or select workspace prod

cd infra
terraform workspace select prod

terraform plan -var-file="prod.tfvars"
terraform apply -var-file="prod.tfvars"

Contributing

See CONTRIBUTING

Support

Join our community on Slack where you can post any questions regarding any of our open source projects. Eyevinn's consulting business can also offer you:

• Further development of this component
• Customization and integration of this component into your platform
• Support and maintenance agreement

Contact [email protected] if you are interested.

About Eyevinn Technology

Eyevinn Technology is an independent consultant firm specialized in video and streaming. Independent in a way that we are not commercially tied to any platform or technology vendor. As our way to innovate and push the industry forward we develop proof-of-concepts and tools. The things we learn and the code we write we share with the industry in blogs and by open sourcing the code we have written.

Want to know more about Eyevinn and how it is to work here. Contact us at [email protected]!