Skip to main content

Getting started

Before starting

To begin, please sign in to your nanoStream Cloud/Bintu account and copy your API key here.
If you have not created an account yet, you can sign up or reach out to our dedicated sales team via the contact form or by sending an email to sales(at)nanocosmos.de.

Using bintu.live​

bintu.live is the API for nanoStream Cloud. You can use it via the nanoStream Cloud Dashboard or the API.

What you need​

To create and broadcast a live stream, you need a live source. This can be either a webcam, external camera, streaming device, or even your PC screen. To send a live stream to nanoStream Cloud, you need a streaming software or hardware, or just your browser which directly can be used to send a live stream to your audience.

See our introduction videos and tutorials for step-by-step instructions!

Create a nanoStream Cloud account (bintu.live)​

If you have not created an account yet, you can sign up or reach out to our dedicated sales team via the contact form or by sending an email to sales(at)nanocosmos.de.

Click here to see how you can authenticate to the nanoStream Cloud/Bintu Dashboard.

Create a new live stream​

To learn how to create your first stream with our nanoStream Cloud/Bintu dashboard, click here.

Start a live stream broadcast​

Once you created a stream via the dashboard, you will see stream instructions to start your stream. Click here to learn more about it.

To start a live stream broadcast, you need a live encoder software, either based on an RTMP Live Encoder application, or the browser-based nanoStream Webcaster broadcaster.

You can use 3rd part software like OBS (Open Broadcaster) or professional Live Encoders like Elemental Live.

info

The primary ingest protocol is RTMP.

Live Encoder Usage​

Copy/paste the ingest URL to use it with your live encoder software.

If you are not sure, where you can find these informations, click here to learn more about the stream overview of the nanoStream Cloud/bintu Dashboard.

Example

rtmp://bintu-stream.nanocosmos.de/live/XXXXX-YYYYY

For some live encoder software, you might need to separate the stream url and stream name, e.g.

  • RTMP URL: rtmp://bintu-stream.nanocosmos.de/live
  • Stream Name: XXXXX-YYYYY
good to know

Some applications like OBS use the name Stream Key instead Stream Name

Configuring the camera and live encoder​

Codecs:

  • H264 video,
  • AAC audio

Video resolution: flexible, e.g. 640×480, 1280×720, 1920×1080

Video bitrate: flexible, e.g. 500 kbits/s, 1 MBit/s

Running the stream​

After entering the RTMP ingest URL and stream name into your live encoder software, you can instantly start the broadcast to nanoStream Cloud / bintu.live.

Play your live stream​

Play the stream directly in your browser or by inserting the Playout URL into a player application. By using the Web Playout URL, you will automatically be directed to a web player page based on our unique nanoStream H5Live low-latency playback technology.

note

The player URL is different from the Ingest URL! This is to adjust to world regional locations of our worldwide CDN with ingest and playback servers.

The H5Live player is running on a sample page which also shows an embed code to copy to your own web page.

Click here to learn more about the nanoPlayer within the nanoStream Cloud/Bintu dashboard. If you want to learn more about the usage of the nanoPlayer, click here to dive into our developer documentation.

Additional features​

Metrics​

nanoStream Cloud and the unique nanoStream H5Live Player have been designed as an easy to use ultra-low-latency and light-weight live streaming platform. nanoStream Analytics follows the same philosophy. Easy to use, lightweight and focused on delivering our partners the information that makes their business more successful.

nanoStream Cloud Analytics offers a great way to monitor and analyze the performance and quality of service of your live streams.

Getting started

If you have not created an account yet, you can sign up or reach out to our dedicated sales team via the contact form or by sending an email to sales(at)nanocosmos.de.

API Access​

Your API key

You can find your bintu API key on the organisation overview page.

Secure Streaming​

Secure streaming can be done on the ingest side based on rtmps or WebRTC.

For encrypted ingest with rtmps, you can use port 1937 instead 1935.

Example:​

Standard non-encrypted ingest (RTMP): rtmp://bintu-stream.nanocosmos.de:1935/live/STREAM Encrypted ingest (RTMPS): rtmps://bintu-stream.nanocosmos.de:1937/live/STREAM

For secure playback with the nanoStream H5Live Player you need to have your account enabled for playback security. See the h5live secure playback documentation.

Learn more about Secure Playback & Secure Token.

More information​

Last updated on