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.

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
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.

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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.

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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.

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
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.

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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.

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
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.

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
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.