A suite of add-on components for Jamulus server (gojam, jamulus-lounge, jamviz)

[dtinth]

I’m running a Jamulus server in Thailand (MusicJammingTH.net) and I have built a few add-on components for it. I’m sharing them here in case other server owners find them useful.

Note
Currently, these components are built for Linux servers only, and requires Docker and programming knowledge to set up on your own server.

Overview of components

• jamviz is a Jamulus activity visualizer, useful for creating nice visuals for a livestream / recording. (See example video.)
  • Requires jamulus-lounge to be setup on the server.
• jamulus-lounge provides a web-based interface to a Jamulus server to let people listen in from a web browser.
  • Built on top of gojam.
• gojam is an implementation of a Jamulus client written in Go language.

gojam

gojam is a programmable Jamulus client written in Go language. Once connected to a server, it can generate a live MP3 audio stream and JSON event stream. It is used as a foundation for the next component, jamulus-lounge. It has a very limited feature set (just enough to support jamulus-lounge), but can be used standalone to build bots and other kind of integrations. Source code here: dtinth/gojam.

jamulus-lounge

jamulus-lounge is a web-based interface for gojam. You can install jamulus-lounge on your own Jamulus server to let people listen in from a web browser. Source code here: dtinth/jamulus-lounge.

 

jamviz

jamviz is a Jamulus activity visualizer. It takes the data from jamulus-lounge, and generates a live (or replayed) visualization of Jamulus activity. It looks like this:

It can be used to create nice visuals for a livestream (or a recording) of a Jamulus session. See example video.

It is a web-based application hosted at https://jamviz.vercel.app/ and the source code is here: dtinth/jamviz

[ann0see]

Interesting and thanks for sharing! Is there a reason why you re-wrote the client instead of modifying the existing C++ client? Probably you could add more customization to your client?
I seem to understand that @mcfnord is interested in your work.

[dtinth]

A few reasons:

• I'm more comfortable writing Go than C++. I find using goroutines easier to work with than threads or signals. And I'm not very productive in languages without a garbage collector.
• gojam is built for headless use case (no UI / direct sound output) and intended to be used programmatically. So I avoid big dependencies like audio libraries, Qt, etc.

[ann0see]

Thanks for the comment.

Hoffie once proposed to have a simplified "recorder" or API client - which is exactly what you did - at least to some extent.
I'm just thinking out loudly, but I think of gojam a good foundation for further work.

The website based approach has the upside that once setup everyone can use it without much hassle. However, some people might want to have a simple local client for listening and recording for arbitrary servers - and want to have it on their own machine. I believe gojam could be used as backend.

[ann0see]

For all - not just this, feel free to update https://jamulus.io/kb/2022/01/25/Related-Projects.html

[mcfnord]

#3090

[mcfnord]

I added a leasing mechanism to one instance of jamulus-lounge to let it connect to most servers. This lets me notice Ultimate Guitar links and display the song title/artist. Perhaps eventually I can do same with SSE streams for the stationary lounges (3 right now). I'd like to support Jitsi links in a similar way. I hope to detect silence by watching the level data. I've built and run gojam on Raspberry Pi 4 to listen in. (Not sure what the input device could be.)