WebRTC Video Filter

Utility for webrtc-cdn to apply a video filter with FFMpeg.

It uses FFMpeg for the video filtering, and the pion/webrtc for WebRTC connectivity.

Compilation

In order to install dependencies, type:

go get github.com/AgustinSRG/webrtc-video-filter

To compile the code type:

go build

The build command will create a binary in the currenct directory, called webrtc-video-filter, or webrtc-video-filter.exe if you are using Windows.

Usage

You can use the program from the command line:

webrtc-video-filter [OPTIONS] <SOURCE> <DESTINATION>

SOURCE

The source must be a websocket URL of one of the webrtc-cdn nodes. Examples:

ws://localhost/stream-id
wss://www.example.com/stream-id

DESTINATION

The destination must be a websocket URL of one of the webrtc-cdn nodes. Examples:

ws://localhost/stream-id
wss://www.example.com/stream-id

OPTIONS

Here is a list of all the options:

Option	Description
`--help, -h`	Shows the command line options
`--version, -v`	Shows the version
`--port, -p <port>`	Sets the port to use to forward the RTP packets to FFmpeg. By default, the port 400 is used.
`--video-filter, -vf <filter>`	Sets the video filter for FFmpeg
`--debug`	Enables debug mode (prints more messages)
`--ffmpeg-path <path>`	Sets the FFMpeg path. By default is `/usr/bin/ffmpeg`. You can also change it with the environment variable `FFMPEG_PATH`
`--auth-source, -as <auth-token>`	Sets auth token for the source.
`--auth-destination, -ad <auth-token>`	Sets auth token for the destination.
`--secret, -s <secret>`	Provides secret to generate authentication tokens.

WebRTC options

You can configure WebRTC configuration options with environment variables:

Variable Name	Description
STUN_SERVER	STUN server URL. Example: `stun:stun.l.google.com:19302`
TURN_SERVER	TURN server URL. Set if the server is behind NAT. Example: `turn:turn.example.com:3478`
TURN_USERNAME	Username for the TURN server.
TURN_PASSWORD	Credential for the TURN server.

agustinsrg / webrtc-video-filter Goto Github PK