Streaming

Main Window

On this tab you can specify all settings necessary for broadcasting a live preview from a WolfVision Visualizer as network stream. For broadcasting a network stream the URL of the stream (combination of protocol, IP address, port and filename) and the content of the stream have to be specified. To make it as easy as possible, pre-defined profiles can be used depending. You can specify if you want to have a video only stream or a combination of video and audio stream. The latter option is only available if there is at least one audio source available on the used computer, e.g. a microphone or a Line In.

 

To recall the default settings for this dialog tab, click "Reset settings". The other tabs of the "Preferences" dialog box are not affected.

Output Configuration

Protocol

The built-in streaming server supports four different transfer protocols:

Limitations for specific video/audio codec combinations

IP Address note

The IP address entered in this textbox is used together with the port number to identify the streaming server endpoint used for broadcasting the stream. The combination of selected protocol, IP address, port number and filename make up the complete address of the stream which has to be entered in a suitable media player application (e.g. Windows Media Player, VideoLAN media player, Classic Media Player, etc.) in order to receive the stream.

Limitations for specific streaming protocols

Port note

The port number entered in this textbox is used together with the IP address to identify the streaming server endpoint used for broadcasting the stream. The combination of selected protocol, IP address, port number and filename make up the complete address of the stream which has to be entered in a suitable media player application (e.g. Windows Media Player, VideoLAN media player, Classic Media Player, etc.) in order to receive the stream. The format of the port number follows the common rules for IP port number (range from 1 to 65535).

Some examples: 8080, 5400, 41859

File

The filename entered in this textbox is used to identify the stream on the streaming server. It’s not used for the streaming protocols MMS (Microsoft Media Server) and RTP (Real-Time Transport Protocol) but mandatory for HTTP (HyperText Transfer Protocol) and RTSP (Real-Time Streaming Protocol). The format of the filename follows the common URL rules (no blanks, no special characters, no backslash, etc.).

Some examples: MyStream.avi, Test/This_Is_A_Test_Stream.mp4

Profile Configuration note

For basic streams you can use the pre-defined profiles, which are:

Additionally you can define personalized new profiles by clicking onto the New button, select the desired settings and save it.

To change the settings of existing personal profiles, just select it and click the Edit button.

In case a personal profile will be no longer used, select it and click the Remove button for deleting.

 

Name

The name entered in this textbox is used to identify the profile on the drop box of the streaming ribbon. The name should be short and meaning full for easier differentiation afterwards. There is no limitation of length and symbols.

Template

For easy fine adjustment, pre-defined profiles can be taken as template.

Video Stream Configuration

Codec

The selected video codec controls the compression and format of the video stream. The following codecs are supported:

Bitrate

The video bitrate controls the bandwidth necessary for broadcasting the video stream and also the resulting picture quality of the stream. A higher bitrate leads to a better picture quality but also higher bandwidth requirement for broadcasting the stream. The video refresh rate has also an influence on the video bitrate because if you are using a lower refresh rate you also need a lower video bitrate. The third value which has influence on the necessary video bitrate is the video stream size (resolution). For a stream with VGA (640x480) resolution you need a lower bitrate than for a stream with XGA (1024x768) resolution. The bitrate can range from 100 Kbit/s up to 25.000 Kbit/s. The default value is 4.500 Kbit/s.

Typical values for the video bitrate for a 1024x768 (XGA) video stream with 20 frames per second:

Refresh rate

The video refresh rate controls the frames per second (FPS) encoded in the video stream. It has also influence on the video bitrate. A higher refresh rate needs a higher video bitrate which leads to a higher bandwidth requirement for broadcasting the steam. The video refresh rate has a range from 5 up to 30 frames per second. Typical values for the refresh rate are 10, 15 and 20 frames per second. The default value is 20 frames per second (FPS).

Audio Stream Configuration

If there is a suitable audio source (e.g. microphone, line in) available you are free to add an audio stream to your video stream, otherwise these settings are disabled.

Enable Audio Streaming

When checking the box, the broadcasted video stream will be accompanied by an audio stream.

Audio Source

Select the desired Audio Source. Available sources are depending on computer system configuration.

Codec

The selected audio codec controls the compression and format of the audio stream. The following codecs are supported:

Bitrate

The audio bitrate controls the bandwidth necessary for broadcasting the audio stream and also the resulting sound quality of the stream. A higher bitrate leads to a better sound quality but also higher bandwidth requirement for broadcasting the stream. Keep in mind that the audio sample rate has an influence on the bitrate because a lower sample rate leads to a lower bitrate requirement. Normally a value of 64 Kbit/s is more than sufficient for an audio stream which uses a microphone as source. The audio bitrate has a range from 8 up to 320 Kbit/s. Typical values for the bitrate are 32, 64, 128, 160, 192 and 320 kbit/s. The default value is 64 Kbit/s.

Mode

You can select if your audio stream should be a Mono or Stereo stream. Mono is your choice if you are using a microphone as audio source. Stereo can be used if you use a Line In as audio source which provides a stereo signal natively. The default value is Mono.

Sample rate

The audio sample rate controls the sound quality of the stream and is the main reason for a suitable audio bitrate. A higher sample rate creates a higher amount of audio data which has to be compressed in the selected audio bitrate. If these values don’t fit your audio stream gets choppy. Typical values for the audio sample rate are 8.000, 11.025, 22.050, 32.000, 44.100 and 48.000 Hz. The default value is 44.100 Hz.

Troubleshooting Streaming

Video stream is choppy or malformed pictures are displayed

In most cases this has one of the following reasons:

Video stream is present but no audio

In most cases the reason for this problem is a missing audio source. If there is no audio source available on your computer the stream will only contain video. Add an audio source (e.g. a microphone) to your computer to fix this issue.

Audio stream is present but no video

This problem is often caused by using wrong settings for the video encoding process. If the video encoding process can’t be initialized because of wrong settings, no video stream will be broadcasted. The most common error in configuring the video encoding process is using a video refresh rate which is not supported by the selected video codec (e.g. some codecs only support 25 FPS or no FPS value lower than 15, etc.). Try to use a common video refresh rate (e.g. 15, 20, 25 or 30 FPS) to fix this problem.

GUI of application freezes or reacts very slowly on user events (e.g. mouse clicks, etc.)

The CPU requirements for encoding the streams can’t be fulfilled by your computer (CPU usage at 95% or even higher). Try to reduce the picture resolution (on the Live Preview ribbon tab, change the Resolution to a lower value until the CPU usage falls under 90%). The stream has to be stopped while the picture resolution is changed otherwise the application will stop streaming automatically and display a warning message.

Cannot open a stream which uses Microsoft Media Server protocol (MMS)

Some media players (e.g. VLC media player) can’t open URLs of MMS streams if they are written in the format ‘mms://<Address of Stream>’. Instead, try the format ‘mmsh://<Address of Stream>’.