General Last updated: 2020-10-07

This is the documentation for the OnGenre Professional Livestreaming solution. If you have any questions about the contents of this document, please contact one of our team.

Your Account

The Your Account page of the OnGenre website is where you can create and modify your upcoming OnGenre events.

Creating an OnGenre account as a venue or an artist

Creating an OnGenre account for Professional Livestreaming is easy. Below are the steps.

  1. Go to the OnGenre Registration page and enter your venue/artist details.
  2. Once your account is activated (which should happen within a few hours) you can provide your Bank Account details for your event income payouts.
  3. You can then create an event and decide on the integration method you would like to use with your existing website (more details about this below).

Creating an Event

To create an event, simply go to your My Account page and if your account has been activated you can just press Create A New Livestream Event and fill out the form.

Your event will then be instantly created and you can begin ticket sales immediately.

Changing an Existing Event

Prior to an event's start you can make changes to event through your My Account page. Whether you wish to change the event's maximum sales quantity, price, date/time or description, the changes are easy to make.

Royalties

Our livestreaming solution includes royalty coverage for a number of territories. This means that if you are broadcasting an event that includes any form of copyrighted music, you will only legally be able to have viewers from certain countries.

It is important to note that we cover songwriting/composition royalties only.

Coverage for further territories

Please note, we are currently working hard to add more countries to our territory list for music royalties.

Providing us with information about performed works

In order for the Performing Rights Organisations (PROs) to correctly apportion royalty payments, once an event broadcaster through OnGenre is completed you must submit your "Performed Works Declaration".

Your declaration must be submitted with 24 hours of any event. If you wish to make any adjustments to your declaration, this must be done within 7 days of your submission.

For each work performed, the declaration requires:

  • Work title
  • Composers (include all the writers of the music and lyricists as appropriate)

Performance Venue Royalties

Please note, while OnGenre covers livestreaming royalties for a number of international territories, our licences do not change the requirement that your performance venue must have the appropriate licence for any in-person viewers you may have.

Payments

OnGenre enables you to accept Visa, MasterCard, Maestro, American Express, Google Pay and Apple Pay for your events.

Apple Pay - Google Pay

To accept Apple Pay payments from the embeddable In-line or Pop-out widgets:

  1. You must inform us of the domain name you will be using to sell tickets
  2. Download this file and host it at /.well-known/apple-developer-merchantid-domain-association on your site

Payouts

Payouts will be made to artists and venues as quickly as we possibly can. This will normally occur within 3 working days.

Integration

Our embeddable widgets enable you to simply copy and paste a couple of lines of code onto your event pages and be able to have viewers pay for and view events without any additional hassle.

We offer two different widgets, the Pop-Out widget and the In-line widget. Depending on your preferences about your website design and layout, you may prefer one over the other.

A guide detailing how to integrate each of the widgets is below.

Pop-Out Widget

Pop-Out Widget Image

The Pop-Out widget, of which a demo is available , opens above your website's existing content. You may find this preferable if you don't want your website looking too busy.

Essentially, this widget adds a button to your website and pressing that button opens out the OnGenre widget above your content.

To integrate this widget into your website, simply copy and paste the code below where you want the button to appear. You may wish to use CSS styling to make the button look perfect on your page.

The section of the code with the URL (beginning with https:// and ending with /) should be replaced with your own event's URL, which you can find in the My Account page.

<script src="https://cdn.ongenre.com/widget/box.js"></script>
<button onclick="OnGenre.initPopupWidget({url: 'https://td.ongenre.com/popout/2020/11/08/johns-jazz-club/fred-jones-live-at-johns/'});return false;">Livestream Tickets</button>

In-line Widget

Pop-Out Widget Image

The In-line widget, of which a demo is available , will add a section to your page where people can buy livestream tickets, and once the event begins, can also view the stream and chat. You may find this preferrable if you want the OnGenre livestreaming widget to appear seamlessly on your website and appear as a part of your site.

To integrate this widget into your website, simply copy and paste the code below where you want the OnGenre livestreaming box to appear. You may wish to use CSS styling to make the box look perfect on your page.

The section of the code with the URL (beginning with https:// and ending with /) should be replaced with your own event's URL, which you can find in the My Account page.

If you have any problems with the way this widget appears on-screen, we suggest you alternatively try the Pop-Out widget or contact us for help.

<script src="https://cdn.ongenre.com/widget/inline.js"></script>
<div class="ongenre-inline-widget" data-url="https://td.ongenre.com/inline/2020/11/08/johns-jazz-club/fred-jones-live-at-johns/" style="min-width:320px;height:550px;border-style:solid"></div>

Artist, Venue, or Dedicated Event Page

When you create a livestream through your OnGenre account, a dedicated page for your artist/venue is automatically created. A dedicated page for your event is also made. If you wish to use this page instead of one of our embedded widgets, simply use the link provided in the event page on the My Account section of our website.

If you are interested in a more customised page, please Contact Us about our Custom Solution and we will then be able to create something that perfectly fits with your needs. Whether it's for a single artist, festival or performance venue, we'll be able to help.

Streaming to OnGenre

Streaming to the OnGenre servers is easy. This section provides details about software and hardware that can be used to stream.

Streaming from OBS

The Open Broadcaster Software (OBS) is the easiest way to broadcast your streams to the OnGenre servers. The software, which is free and open-source, is compatible with Windows, macOS and Linux Operating Systems.

Download OBS

Steps to setup your connection to the OnGenre server from OBS:

  • Go to Settings
  • Select the Stream section
  • In the Server box, enter: rtmp://live.ongenre.com:5222/app
  • In the Stream Key box, enter the Stream Key that you were provided when you created your event through OnGenre. They Stream Key will also be available on your OnGenre My Account Page.

Direct from Blackmagic ATEM Devices

To stream directly from a Blackmagic ATEM Mini Pro device or similar, you will need to add OnGenre's streaming RTMP link to the Streaming.xml file. To do this, please follow the following steps:

  1. Navigate to the Streaming.xml file.

    On Windows, the location of the file is C:\Program Files (x86)\Blackmagic Design\Blackmagic ATEM Switchers\ATEM Software Control

    On a Mac, the location of the file is /Library/Application Support/Blackmagic Design/Switchers

  2. Within this folder, find the Streaming.xml file and open it in a Text Editor. Notepad or equivalent is fine, but we suggest using Sublime Text
  3. Copy and paste the below into the Streaming.xml file before the final </streaming>. Note, you may wish to change the resolutions and bit rate to better suit your circumstances and equipment.
    
    	<service>
    		<name>OnGenre</name>
    		<servers>
    			<server>
    				<name>RTMP</name>
    				<url>rtmp://live.ongenre.com:5222/app</url>
    			</server>
    		</servers>
    		<profiles>
    			<profile>
    				<name>Streaming High</name>
    				<config resolution="1080p" fps="25">
    					<bitrate>9000000</bitrate>
    					<keyframe-interval>2</keyframe-interval>
    				</config>
    				<config resolution="1080p" fps="25">
    					<bitrate>6000000</bitrate>
    					<keyframe-interval>2</keyframe-interval>
    				</config>
    			</profile>
    			<profile>
    				<name>Streaming Medium</name>
    				<config resolution="1080p" fps="25">
    					<bitrate>7000000</bitrate>
    					<keyframe-interval>2</keyframe-interval>
    				</config>
    				<config resolution="1080p" fps="25">
    					<bitrate>4500000</bitrate>
    					<keyframe-interval>2</keyframe-interval>
    				</config>
    			</profile>
    			<profile>
    				<name>Streaming Low</name>
    				<config resolution="1080p" fps="25">
    					<bitrate>4500000</bitrate>
    					<keyframe-interval>2</keyframe-interval>
    				</config>
    				<config resolution="1080p" fps="25">
    					<bitrate>3000000</bitrate>
    					<keyframe-interval>2</keyframe-interval>
    				</config>
    			</profile>
    			<profile>
    				<name>Streaming Very low</name>
    				<config resolution="1080p" fps="25">
    					<bitrate>2000000</bitrate>
    					<keyframe-interval>2</keyframe-interval>
    				</config>
    				<config resolution="1080p" fps="25">
    					<bitrate>1000000</bitrate>
    					<keyframe-interval>2</keyframe-interval>
    				</config>
    			</profile>
    		</profiles>
    	</service>
  4. Save the file and open up the ATEM Software Control. You should now see OnGenre appear in the 'Live Streaming' panel.

iOS/Android App Suggestions

There is an abundance of iOS and Android apps that are perfect for streaming to OnGenre. Any of the apps that allow for streaming to RTMP/RTMPS links should work well.

However, in order to ensure that your stream is best enjoyed by your viewers, we very much suggest that you invest in a livestreaming setup that makes use of a standalone camera and microphones.

Streaming Bit Rate and Internet Connections

As a livestream host, to ensure your internet connection is solid during a livestream, we very much suggest you making use of a load-balancing router which has a failover facility. This means that in the event that one of your internet connections begins to wobble, ticket-holders viewing the event would not miss a single moment of your stream.

While the ideal solution for this would be to have two broadband internet connections, a simple alternative would be to have a single broadband connection alongside a backup 4/5G connection. As long as you have a reasonable upload speed on your 4/5G device, this could provide you with an excellent backup for the load-balancer to use in the event of problems with your primary internet connection.