Skip to content
Zachary edited this page Nov 26, 2023 · 5 revisions

Welcome to the BELABOX tutorial wiki!

What is BELABOX?

BELABOX is a collection of open-source software that acts as an Encoder, for use in IRL Live Streaming. So it takes a video feed from a camera and transmits it by bonding multiple internet connections. The video feed can be HDMI, USB MVC, or RTMP. The internet connections can be Ethernet, Wifi, or USB.

https://github.com/BELABOX/

It's just one part of a mobile Streaming setup. You also need a Camera, Internet Connections in whatever form, and a Power Source.

What's the required hardware?

Check the Peripherals, Accessories, and Power Banks for known good hardware. ( Community Maintained, so feel free to update )

Encoder

BELABOX runs on the following SBC's (single-board computers)

OS Images can be downloaded from https://belabox.net/

  • Orange Pi 5 Plus
  • Radxa Rock 5A
  • Radxa Rock 5B
  • Banana Pi BPI-W3
  • Jetson Nano ( check the discord for specific models and more information )
    • Requires USB Capture card for HDMI

Go to https://belabox.net/rk3588/ for more information

Wifi

The Intel Wireless-AC 8265 M.2 is the recommended wifi card, Other intel devices are known to work as well.

Modems

You should be able to use any USB modems that are supported on Linux and that create a virtual Ethernet interface (as opposed to the older style PPP-over-USB-serial modems). Huawei E5576 and E3372 are known to be working. If you want to use more than one modem, ensure that you can change their IP classes to non-overlapping ranges.

SD Card / EMMC

If using an SD Card use a UHS Class 3 or V30 card or higher rated.

If using EMMC get the appropriate EMMC module for a given board ( note EMMC issues have been reported on the Rock boards, check discord )

How to get started?

Follow this tutorial. Most steps apply to both the Jetson and RK3588 devices https://www.youtube.com/watch?v=YuH_B48nz1M

If you're using an EMMC Card instead of an SD Card download the appropriate install image.

How do I access the Web UI?

BELABOX provides a web configuration and control interface suitable for access from a phone.

Setup

For first-time setup, connect the encoder to a network via Ethernet. Then go to http://belabox.local or http://ip_addr_of_belabox to configure the device.

Settings and Changes are only saved when you Start a Stream.

Streaming

To connect to it directly, you can utilize a modem with Wifi support. Then go to http://belabox.local or http://ip_addr_of_belabox , For Ease of use you may want to set a static IP for your BELABOX.

BELABOX Cloud also offers a remotes feature and secret URL's for ease of use.

Are multiple video capture sources supported?

No. At the moment this niche feature is considered out of scope. We have higher priorities to keep us busy for a while.

Is it possible to have the stream auto-start at boot?

No. It would be easy to implement, but it's a very bad idea to have an encoder that will go from offline/brb to live by bumping its power cable.

In addition to that, you should check your BELABOX remote, Modem Status, and Camera, before going live. And at that point, you're one button press away from starting anyway.

That said, There are some 3rd Party tools that can connect to the BELABOX to report status and control it via chat.