JackTrip Foundation publishes disk images that enable you to fully manage Raspberry Pi based audio devices using the Virtual Studio web application. This will enable anyone to build JackTrip-powered plug-and-play devices using a wide variety of sound cards.
You can download the latest image (about 340MB) at:
https://files.jacktrip.org/images/jacktrip-rpi-20211001.zip
You can use this SHA256 checksum file to verify the download:
https://files.jacktrip.org/images/jacktrip-rpi-20211001.zip.sha256
Note that this is a disk image that needs to be flashed to the MicroSD card using a software such as Balena Etcher. You cannot just drag and drop the file to the disk.
The image should work fine with any MicroSD card that is at least 2GB in size, which is basically any card that is currently available on the market. Please review Raspberry Pi Foundations' documentation about selecting SD cards.
The images are a custom, minimal build of Raspbian (Debian, optimized for Raspberry Pi devices), created using the pi-gen toolset. They leverage systemd to manage the jack, jacktrip and Jamulus processes. All configuration and services are managed using a jacktrip-agent that communicates with JackTrip's web services for management.
To register a new device, use the JackTrip mobile app.
See Registering and connecting to a Studio with app.jacktrip.org for more info.
The image is designed to be managed remotely, using your web browser and the web application at https://app.jacktrip.org. Under normal circumstances, there is no need to connect a monitor or keyboard, or log into a terminal. However, if you would like to access a terminal for troubleshooting purposes, please see Troubleshooting the Virtual Studio Image.
For Developers
Everything used to build this image is open source! The repositories are currently in fairly raw form; please forgive the warts.
- jacktrip/jacktrip-image: Used to build the Raspberry Pi image for Virtual Studio devices (github.com)
- jacktrip/jacktrip-agent: Golang source code for the jacktrip-agent binary used by Virtual Studio (github.com)
Building the image requires pi-gen, and pre-built binary files for ARM located in the 00-sys-tweaks/files/ subdirectory. The missing files you need are listed in this .gitignore file.
Future plans include merging in the server-side bits (note jacktrip-agent is the same thing that runs on the audio server VMs), and possibly repackaging things into a device/server hybrid container that could theoretically run anywhere.
Pull requests are very welcome!
Comments
8 comments
Once the device is up and talking to the server, does it update its software automatically or do new software versions need to be installed using the method on this page?
The image should update itself to the latest release whenever it is first powered on, before starting up any of the audio services. Unfortunately, there is an issue with older image releases (202008* and 202009*) where this is sometimes not happening. Usually, just trying it a few times (unplugging power, then plugging it back in) gets it to eventually update, but not always. See this for more info https://jacktrip.zendesk.com/hc/en-us/articles/360057892613-Device-Not-Updating-Firmware
Mike, thanks for you response! Does this mean that once a Jacktrip device has been initially deployed, its owner won't need to worry going forward about manually doing software updates?
That is the intention (with fingers crossed that there are no more update gremlins hiding in there..)
Indeed that would be swell. I will note that I'm looking at the HDMI console screen on one of my Pi devices and [FAILED] Failed to Start JackTrip-Patches does appear.
Are the build instructions/configuration/source code for these disk images available somewhere? I didn't find them on your GitHub.
Which Pi models is this compatible with?
can I run this image on a raspberry pi400?
Is there an image file for jacktrip for a raspberry pi400. I am currently running jamulus and would like to add jacktrip
Please sign in to leave a comment.