This page contains information about setting up the custom VideoWhisper module and configuration for Wowza SE. See the software requirements for more details about HTML5 live streaming and implementation.
These instructions are for installing on your own dedicated or semi-dedicated (VPS) environment if you already have Wowza SE installed, configured and accessible. Server must be already configured for secure (StreamLock) WebRTC & HLS live streaming before installing the advanced configuration. Wowza SE samples for WebRTC broadcast/playback should already be functional.
Root SSH / administrative access is required to add the new libraries to streaming server files and restart the service to reload apps with the new module. This can only be done by server administrator.
VideoWhisper provides turnkey hosting plans with full installation and setup: html5 live streaming hosting plans (recommended). VideoWhisper administrators can also provide setup and administration for 3rd party streaming servers, for extra, if all required licensing is available.
Step 1. Download the latest module and configuration files for Wowza SE from the downloads section (scroll to bottom VideoWhisper RTMP Applications section).
This is a different download than web solution / plugin files and you will not find the rtmp application in the archive with the web files. There is a special archive you must download separately.
Advanced features require licensing the Stream Session Control functionality. Without Session Control licensing (included with VideoWhisper hosting), the specific functionality will not be available (only plain live streaming will be possible without the extra security and integration between web and streaming server for live room updates, snapshots, recording).
Step 2. Copy contents of zip (see Step1) file to your Wowza installation folder.
Verify that you have in Wowza installation folder:
These files are for required for streaming addresses like rtmp://your-server/videowhisper to work.
Use videowhisper live streaming, chat and videowhisper-recorder for video recording projects.
See more details on settings if combos are needed.
This was developed and tested with Wowza Streaming Engine.
For archiving streams broadcast with flash applications, default container in conf/Server.xml should be changed from mp4 to flv, to support flash audio codecs (nellymoser, speex).
- Go to http://[your-wowza-server]:8088/enginemanager/
- From the top menu select the [Server] page & In Server Setup > Edit
- Change Default Stream Prefix from mp4 to flv & Save
Your RTMP path should be rtmp://your-server-or-ip/videowhisper .
Test your rtmp address with the VideoWhisper RTMP Tester .
The server or ip must be publicly accessible for others to be able to access. Using something like "localhost" when you install locally or an intranet IP will only allow you to test (others will not be able to access).
You must fill this setting in a file or form depending on edition: each edition has a page on this website with detailed instructions (browse the left menu - i.e. Joomla Video Conference will have an input for that in parameters form).
You can have multiple RTMP application installs in different folders if you plan to run multiple projects (i.e. videowhisper_live, videowhisper_conference) . This means new rtmp addresses like rtmp://your-domain-or-ip/videowhisper_live & rtmp://your-domain-or-ip/videowhisper_conference . Also multiple projects can share the same RTMP path. We do not recommend that if you have overlapping rooms (with same name). Those will show users in the same place but website specific features (like file sharing) will not work between all users.
For Wowza you need to create a folder newapplication for each application in applications and copy conf/videowhisper/Application.xml to conf/newapplication/Application.xml . You will obtain this videowhisper rtmp address: rtmp://your-wowza-server/newapplication . Edit Application.xml stream type depending on project, as explained below.
VideoWhisper RTMP side package for Wowza comes with multiple apps configured for various scenarios.
- videowhisper-live = use with Live Streaming to publish live video
- videowhisper-chat = use for video chat (low latency)
: Video Conference, 2 Way Videochat, Video Consultation, Video Messenger
- videowhisper-record = use for recording and playback with Video Recorder and rtmp players
- videowhisper-archive = use with Live Streaming to publish and archive (record) live video
- videowhisper-x = use when transcoding stream for mobile delivery as HLS, MPEG-Dash
with Live Streaming, Video Consultation or publishing an mobile ready stream with external encoders
- videowhisper-xarchive = use for publishing live stream, transcoded stream for mobile delivery and also archiving . Note: when you publish a stream and also the transcoding both will be recorded.
VideoWhisper RTMP side for wowza allows specific configuration properties:
These are documented on:
Edit other Wowza options in conf/videowhisper/Application.xml as explained in Wowza configuration guide .
Configure <Streams> ... <Stream Type> for your needs: Use live for live streaming, live-lowlatency for video chat and conferencing, record for video recorder. Combos are also available as live-record or live-record-lowlatency as explained in the guide.
Configure video saving location in <Streams> ...
<StorageDir> . You can setup a public folder in public_html if on same server as web server.
Allow access to rtmp only from certain domain(s):
Wowza also supports direct streaming for Apple iPhone/iPad and other devices/applications that don't support flash: RTMP/RTSP/RTP Streaming.
Wowza allows enabling some security modes with the MediaSecurity Addon Package. These modules can:
Enable RTMP Authentication
This will allow broadcasting only trough external applications that support rtmp authentication. Web based flash application broadcasting will not work.
Add allowed usernames and passwords to conf/publish.password . In example, in Adobe Flash Media Live Encoder user will be prompted to fill username and password when connecting.
Enable Secure Token
This will allow only connections from applications that support configuring a token key.
Replace VideoWhisper with the token key of choice and update in web application settings.
RTMP Authentication and Secure Token can be used in combination with secure connections option.
Or this can be enabled separately:
Allow only RTMPE, RTMPTE or RTMPS
This will disable connections by RTMP based address.