Beyla - Revision history

Nthmost: Add Radio Control API documentation (port 8081, genre/queue/skip/search endpoints)

2026-03-15T22:36:20Z

Add Radio Control API documentation (port 8081, genre/queue/skip/search endpoints)

← Older revision		Revision as of 15:36, 15 March 2026
Line 36:		Line 36:

	The system uses a priority-based fallback chain: live DJ input always takes precedence, then scheduled programming, then a SomaFM internet radio fallback if all local sources fail.		The system uses a priority-based fallback chain: live DJ input always takes precedence, then scheduled programming, then a SomaFM internet radio fallback if all local sources fail.


			== Radio Control API ==

			Beyla exposes a local HTTP control API on port '''8081''' (<code>http://beyla.local:8081/</code>). It lets you switch genres, queue specific tracks, skip tracks, and see what's playing. The API is available on the Noisebridge LAN only.

			An OpenAPI 3.0 spec is available at <code>/api/spec</code>.

			=== Genre Endpoints ===

			{\| class="wikitable"
			! Method !! Endpoint !! Description
			\|-
			\| <code>GET</code> \|\| <code>/api/genres</code> \|\| List all genres with track counts and subgenres
			\|-
			\| <code>GET</code> \|\| <code>/api/genre</code> \|\| Get current genre override status
			\|-
			\| <code>POST</code> \|\| <code>/api/genre</code> \|\| Set genre override — plays shuffled tracks from that genre instead of the normal schedule. Takes effect after the current track finishes.
			\|-
			\| <code>DELETE</code> \|\| <code>/api/genre</code> \|\| Clear genre override, returning to the normal schedule
			\|}

			'''POST /api/genre''' request body:
			<pre>
			{
			"genre": "Bass", // required — parent genre name (see GET /api/genres for options)
			"subgenre": "Dubstep" // optional — narrows the track pool
			}
			</pre>

			=== Queue & Playback Endpoints ===

			{\| class="wikitable"
			! Method !! Endpoint !! Description
			\|-
			\| <code>GET</code> \|\| <code>/api/queue</code> \|\| Show queued tracks and current genre feed status
			\|-
			\| <code>POST</code> \|\| <code>/api/queue</code> \|\| Queue a specific track (by <code>track_id</code> or <code>search</code> string)
			\|-
			\| <code>DELETE</code> \|\| <code>/api/queue</code> \|\| Clear all queued tracks
			\|-
			\| <code>POST</code> \|\| <code>/api/skip</code> \|\| Skip the currently playing track immediately
			\|}

			=== Search & Status Endpoints ===

			{\| class="wikitable"
			! Method !! Endpoint !! Description
			\|-
			\| <code>GET</code> \|\| <code>/api/search?q=TEXT&genre=GENRE&limit=N</code> \|\| Search the music library by artist, title, or filename
			\|-
			\| <code>GET</code> \|\| <code>/api/now-playing</code> \|\| Current track, time remaining, listener count, genre override, and queue depth
			\|-
			\| <code>GET</code> \|\| <code>/api/spec</code> \|\| OpenAPI 3.0 spec for this API
			\|}

			=== Examples ===

			<pre>
			# Switch to Chill mode
			curl -X POST http://beyla.local:8081/api/genre \
			-H 'Content-Type: application/json' \
			-d '{"genre": "Chill"}'

			# Switch to Bass / Dubstep specifically
			curl -X POST http://beyla.local:8081/api/genre \
			-H 'Content-Type: application/json' \
			-d '{"genre": "Bass", "subgenre": "Dubstep"}'

			# Return to normal schedule
			curl -X DELETE http://beyla.local:8081/api/genre

			# Search and queue a track
			curl 'http://beyla.local:8081/api/search?q=aphex+twin&limit=5'
			curl -X POST http://beyla.local:8081/api/queue \
			-H 'Content-Type: application/json' \
			-d '{"track_id": 42}'

			# Skip current track
			curl -X POST http://beyla.local:8081/api/skip
			</pre>

			'''Note:''' Genre names are case-sensitive. Use <code>GET /api/genres</code> to get the exact names. Current genres: Bass, Chill, Electronic, Hip-Hop, Pop/Rock, Blues/Soul, Punk, Dub/Reggae, Metal, Jazz, Classical.

	== Getting Involved ==		== Getting Involved ==

Nthmost: Add Genre Statistics subpage link to See Also

2026-03-15T22:32:41Z

Add Genre Statistics subpage link to See Also

← Older revision		Revision as of 15:32, 15 March 2026
Line 44:		Line 44:

	* [[KNOB]] -- the radio station Beyla powers		* [[KNOB]] -- the radio station Beyla powers
			* [[Beyla/Genre_Statistics]] -- music library genre breakdown
	* [[Audio]] -- sound systems around Noisebridge		* [[Audio]] -- sound systems around Noisebridge
	* [[Rubber Ducky Guild]] -- MC Escher's people		* [[Rubber Ducky Guild]] -- MC Escher's people

Nthmost: Add SOAYAN-N6 manufacturer links in intro and About the Name section

2026-03-15T22:29:32Z

Add SOAYAN-N6 manufacturer links in intro and About the Name section

← Older revision		Revision as of 15:29, 15 March 2026
Line 1:		Line 1:
	= Beyla =		= Beyla =

	'''Beyla''' is the music server that powers [[KNOB]], Noisebridge's 24/7 internet radio station. It's a ~~small hexagonal~~ mini PC sitting on top of the primary audio amplifier in the [[RNA Lounge]] -- the one with '''[[Rubber Ducky Guild\|MC Escher]]''' on top (little green duck, gold chain, knitted cap).		'''Beyla''' is the music server that powers [[KNOB]], Noisebridge's 24/7 internet radio station. It's a [https://soayan.com/products/soayan-n6-mini-pc-rgb-hexagon-design-intel-n100-16gb-ram-500gb-ssd-dual-4k-windows-11 SOAYAN-N6] mini PC sitting on top of the primary audio amplifier in the [[RNA Lounge]] -- the one with '''[[Rubber Ducky Guild\|MC Escher]]''' on top (little green duck, gold chain, knitted cap).

	== Finding and Turning On Beyla ==		== Finding and Turning On Beyla ==
Line 50:		Line 50:
	== About the Name ==		== About the Name ==

	'''Beyla''' is named after a figure in Norse mythology — one of [https://en.wikipedia.org/wiki/Freyr Freyr]'s servants, whose name is etymologically linked to ''bees'' and who is associated with bees and mead in modern Germanic tradition. The name felt fitting: the SOAYAN-N6 mini PC has a distinctive '''hexagonal''' form factor, echoing the geometry of a honeycomb.		'''Beyla''' is named after a figure in Norse mythology — one of [https://en.wikipedia.org/wiki/Freyr Freyr]'s servants, whose name is etymologically linked to ''bees'' and who is associated with bees and mead in modern Germanic tradition. The name felt fitting: the [https://soayan.com/products/soayan-n6-mini-pc-rgb-hexagon-design-intel-n100-16gb-ram-500gb-ssd-dual-4k-windows-11 SOAYAN-N6] mini PC has a distinctive '''hexagonal''' form factor, echoing the geometry of a honeycomb.

	[[Category:Projects]]		[[Category:Projects]]
	[[Category:Radio]]		[[Category:Radio]]
	[[Category:Infrastructure]]		[[Category:Infrastructure]]

Nthmost: Add About the Name section explaining Norse mythology etymology and hexagonal design connection

2026-03-15T22:20:27Z

Add About the Name section explaining Norse mythology etymology and hexagonal design connection

← Older revision		Revision as of 15:20, 15 March 2026
Line 46:		Line 46:
	* [[Audio]] -- sound systems around Noisebridge		* [[Audio]] -- sound systems around Noisebridge
	* [[Rubber Ducky Guild]] -- MC Escher's people		* [[Rubber Ducky Guild]] -- MC Escher's people


			== About the Name ==

			'''Beyla''' is named after a figure in Norse mythology — one of [https://en.wikipedia.org/wiki/Freyr Freyr]'s servants, whose name is etymologically linked to ''bees'' and who is associated with bees and mead in modern Germanic tradition. The name felt fitting: the SOAYAN-N6 mini PC has a distinctive '''hexagonal''' form factor, echoing the geometry of a honeycomb.

	[[Category:Projects]]		[[Category:Projects]]
	[[Category:Radio]]		[[Category:Radio]]
	[[Category:Infrastructure]]		[[Category:Infrastructure]]

Nthmost: /* Finding and Turning On Beyla */

2026-03-09T11:42:38Z

Finding and Turning On Beyla

← Older revision		Revision as of 04:42, 9 March 2026
Line 7:		Line 7:
	Beyla lives in the [[RNA Lounge]], upstairs. Look for the amplifier with the green rubber duck on top -- that's MC Escher, and Beyla is the small hexagonal box sitting on the amp.		Beyla lives in the [[RNA Lounge]], upstairs. Look for the amplifier with the green rubber duck on top -- that's MC Escher, and Beyla is the small hexagonal box sitting on the amp.

	If Beyla appears to be off, look for a small round button on its side. Press it to power on. Give it a minute to boot and the stream should come back up automatically.		Beyla has a fancy little LED stripe light that indicates it's on. If Beyla appears to be off, look for a small round button on its side. Press it to power on.

			Give it a minute to boot and the stream should come back up automatically.

	== Physical Audio Distribution ==		== Physical Audio Distribution ==

Nthmost: Add Getting Involved section: contact @nthmost on Discord with SSH public key

2026-03-09T11:06:56Z

Add Getting Involved section: contact @nthmost on Discord with SSH public key

← Older revision		Revision as of 04:06, 9 March 2026
Line 34:		Line 34:

	The system uses a priority-based fallback chain: live DJ input always takes precedence, then scheduled programming, then a SomaFM internet radio fallback if all local sources fail.		The system uses a priority-based fallback chain: live DJ input always takes precedence, then scheduled programming, then a SomaFM internet radio fallback if all local sources fail.

			== Getting Involved ==

			If you'd like to help run or maintain Beyla, contact '''@nthmost''' on the [https://discord.gg/noisebridge Noisebridge Discord] and be prepared to send your SSH public key.

	== See Also ==		== See Also ==

Nthmost: Refocus on hardware: hexagonal mini PC, location, how to turn on, audio distribution, MC Escher; link to KNOB for radio station info

2026-03-09T11:03:29Z

Refocus on hardware: hexagonal mini PC, location, how to turn on, audio distribution, MC Escher; link to KNOB for radio station info

Show changes

Nthmost: Add physical audio distribution section: 1/8" output, 3-way split, audio baluns, three amps including MC Escher

2026-03-09T10:20:12Z

Add physical audio distribution section: 1/8" output, 3-way split, audio baluns, three amps including MC Escher

← Older revision		Revision as of 03:20, 9 March 2026
Line 121:		Line 121:

	Want to add tracks to the rotation? Contact '''nthmost''' on the [https://discord.gg/noisebridge Noisebridge Discord]. The music library lives on Beyla's local drive, and contributions in MP3, FLAC, OGG, or WAV format are welcome.		Want to add tracks to the rotation? Contact '''nthmost''' on the [https://discord.gg/noisebridge Noisebridge Discord]. The music library lives on Beyla's local drive, and contributions in MP3, FLAC, OGG, or WAV format are welcome.

			== Physical Audio Distribution ==

			Beyla's 1/8" output jack is split three ways. Each output is converted to balanced audio over ethernet via an '''audio balun''' (RCA → ethernet cable → RCA), allowing the signal to travel cleanly over long runs of Cat5 to amplifiers distributed around the space.

			There are three amplifiers:

			{\| class="wikitable"
			! Amp !! Location !! Notes
			\|-
			\| '''Primary''' (MC Escher) \|\| Near Beyla \|\| A little green rubber duck in a gold chain and knitted cap is permanently affixed to the top. He is a proud member of the [[Rubber Ducky Guild]].
			\|-
			\| '''RNA Lounge''' \|\| On top of the old NB podium, top of the stairs \|\| The FM transmitter lives inside the podium body; the amp sits on top.
			\|-
			\| '''Hallway''' \|\| Deep in the hallway next to the kitchen, across from the [[Electronics Lab]] door \|\|
			\|}

			Volume is controlled independently on each amplifier, so each area can dial in whatever level works for them.

	== Technical Details ==		== Technical Details ==

Nthmost: Add styled tune-in callout box, color-coded schedule, clarify beyla.noise/nbradio (LAN) vs nthmost.com/nbradio (external) URLs

2026-03-09T08:11:04Z

Add styled tune-in callout box, color-coded schedule, clarify beyla.noise/nbradio (LAN) vs nthmost.com/nbradio (external) URLs

← Older revision		Revision as of 01:11, 9 March 2026
Line 2:		Line 2:

	'''Beyla''' is the streaming server that powers '''KNOB''' (Noisebridge Radio), a 24/7 internet radio station run by and for the Noisebridge community. It broadcasts a mix of automated programming and live DJ sets, and anyone at the space can take over the airwaves.		'''Beyla''' is the streaming server that powers '''KNOB''' (Noisebridge Radio), a 24/7 internet radio station run by and for the Noisebridge community. It broadcasts a mix of automated programming and live DJ sets, and anyone at the space can take over the airwaves.

			<div style="background:#2a1a4a; color:#e8d5ff; border-left:4px solid #9966cc; padding:10px 16px; margin:12px 0; border-radius:4px;">
			'''Tune in now:'''
			* '''Inside Noisebridge:''' [http://beyla.noise/nbradio beyla.noise/nbradio]  (LAN only)
			* '''Anywhere:''' [https://nthmost.com/nbradio/ nthmost.com/nbradio]
			</div>

	== Listening ==		== Listening ==

	{\| class="wikitable"		{\| class="wikitable"
	! Method !! URL		! Method !! URL !! Notes
			\|-
			\| '''Web Dashboard''' (inside NB) \|\| [http://beyla.noise/nbradio beyla.noise/nbradio] \|\| In-browser player, LAN only
	\|-		\|-
	\| '''Web Dashboard''' (~~with in-browser player~~) \|\| [https://nthmost.com/nbradio/ nthmost.com/nbradio/]		\| '''Web Dashboard''' (anywhere) \|\| [https://nthmost.com/nbradio/ nthmost.com/nbradio] \|\| In-browser player, works everywhere
	\|-		\|-
	\| '''Direct Stream''' (~~for media players~~) \|\| <code>https://nthmost.com/nbradio/stream.ogg</code>		\| '''Direct Stream''' (anywhere) \|\| <code>https://nthmost.com/nbradio/stream.ogg</code> \|\| For VLC, mpv, etc.
	\|-		\|-
	\| '''LAN Stream''' (~~at Noisebridge~~) \|\| <code>http://beyla.local:8000/stream.ogg</code>		\| '''LAN Stream''' (raw Icecast) \|\| <code>http://beyla.local:8000/stream.ogg</code> \|\| Direct server access at Noisebridge
	\|}		\|}

Line 94:		Line 102:
	{\| class="wikitable"		{\| class="wikitable"
	! Time !! Show !! Description		! Time !! Show !! Description
	\|-		\|- style="background:#dce8f8;"
	\| 2am -- 10am \|\| '''AUTODJ''' \|\| Downtempo, lofi, and eclectic tracks with station IDs		\| 2am – 10am \|\| '''AUTODJ''' \|\| Downtempo, lofi, and eclectic tracks with station IDs
	\|-		\|- style="background:#ead5f0;"
	\| 10am -- 11am \|\| '''Pandora's Box''' \|\| Mixed-genre surprise hour		\| 10am – 11am \|\| '''Pandora's Box''' \|\| Mixed-genre surprise hour
	\|-		\|- style="background:#dce8f8;"
	\| 11am -- 5pm \|\| '''AUTODJ''' \|\| Downtempo, lofi, and eclectic tracks with station IDs		\| 11am – 5pm \|\| '''AUTODJ''' \|\| Downtempo, lofi, and eclectic tracks with station IDs
	\|-		\|- style="background:#ead5f0;"
	\| 5pm -- 6pm \|\| '''Pandora's Box''' \|\| Mixed-genre surprise hour		\| 5pm – 6pm \|\| '''Pandora's Box''' \|\| Mixed-genre surprise hour
	\|-		\|- style="background:#dce8f8;"
	\| 6pm -- 10pm \|\| '''AUTODJ''' \|\| Downtempo, lofi, and eclectic tracks with station IDs		\| 6pm – 10pm \|\| '''AUTODJ''' \|\| Downtempo, lofi, and eclectic tracks with station IDs
	\|-		\|- style="background:#1e2a3a; color:#b0c8e8;"
	\| 10pm -- 2am \|\| '''Noisefloor''' \|\| Dubstep, bass music, and deep electronic		\| 10pm – 2am \|\| '''Noisefloor''' \|\| Dubstep, bass music, and deep electronic
	\|}		\|}

Line 127:		Line 135:

	* [https://nthmost.com/nbradio/ KNOB Web Dashboard]		* [https://nthmost.com/nbradio/ KNOB Web Dashboard]
			* [[Audio]] -- sound systems around Noisebridge
			* [[Music]] -- Music Guild

	[[Category:Projects]]		[[Category:Projects]]
	[[Category:Radio]]		[[Category:Radio]]

Nthmost: New page: Beyla (KNOB radio streaming server) - how to listen and stream

2026-03-09T08:00:09Z

New page: Beyla (KNOB radio streaming server) - how to listen and stream

← Older revision		Revision as of 01:00, 9 March 2026
Line 79:		Line 79:
	#* '''Password''': <code>nbradio</code>		#* '''Password''': <code>nbradio</code>
	# Load up some tracks, start mixing, and enable broadcasting		# Load up some tracks, start mixing, and enable broadcasting

			=== Quick and Dirty with ffmpeg ===

			If you just want to stream an audio file with no extra software, '''ffmpeg''' works from the command line:

			ffmpeg -re -i <your-audio-file> -f mp3 icecast://nbradio:nbradio@beyla.noise:8005/live

			This was the first successful stream to Beyla -- shout out to '''Derek''' from the Infrastructure Meetup for proving it out.

	== Programming Schedule ==		== Programming Schedule ==