A fork of JamTaba, based on defterai's version, that sends and receives synchronized video using the NinjamZap video format. Musicians on JamtabaZap and on the NinjamZap apps can see each other in the same room.
Status: beta. Download it from Releases.
- H.264 video synchronized with each musician's audio interval, on servers that relay video. On other servers it falls back to JamTaba's previous video format, in SD.
- Video quality in Preferences > Video: SD, VGA or HD. The same tab turns off receiving video.
- Audio quality in Preferences > Audio: Economy, Standard, High or Studio (64, 128, 192 or 256 kbps).
- Video kept in step with audio in voice chat.
-
Windows: unzip and run
JamtabaZap.exe. It needs an ASIO driver; ASIO4ALL works if your interface has none. The build isn't signed, so Windows SmartScreen warns about it: choose "More info", then "Run anyway". -
macOS: Intel build, which also runs on Apple Silicon through Rosetta. It isn't signed: right-click the app and choose "Open".
-
Linux: a single file,
JamtabaZap-x86_64.AppImage, for 64-bit distributions. It brings the libraries it needs; nothing has to be installed.- Make it executable: right-click it, Properties > Permissions, and tick "Allow executing file as program". Or, in a terminal:
chmod +x JamtabaZap-x86_64.AppImage - Double-click it, or run
./JamtabaZap-x86_64.AppImage
If it says FUSE is missing, start it with
./JamtabaZap-x86_64.AppImage --appimage-extract-and-run, or install thefuse3package. - Make it executable: right-click it, Properties > Permissions, and tick "Allow executing file as program". Or, in a terminal:
-
VST plugin (Windows): unzip
JamtabaZap-VST-windows-x64.zipand copyJamtabaZapVST.dllto your DAW's VST folder.
JamTaba's user guide covers the rest of the app.
- VST2 plugins can be used inside JamtabaZap. JamtabaZap itself is also available as a VST2 plugin for 64-bit Windows; there's no plugin version for macOS yet.
- HD takes a lot of CPU on older computers. When the encoder can't keep up, frames are skipped: choose VGA or SD if your computer struggles.
All credit for JamTaba goes to its author, Elieser de Jesus, and its contributors, and to defterai for the version this fork builds on.
JamtabaZap is developed by Javier Cordero, creator of NinjamZap. It adds synchronized H.264 video for NinjamZap rooms, video and audio quality settings, video kept in step with voice chat, and VST2 hosting through FST. That code is licensed under the GPL 3 or later.
The code inherited from JamTaba keeps its original terms: the upstream repository has no license file (issue #1210), and this fork doesn't add one. VST2 plugins are hosted through FST, a free implementation of the interface under the GPL. Details, third-party components and open questions are in LICENSES.md.
The commits on top of JamTaba are kept small so that they can be moved onto newer versions of it.
Tests for the video are in tests/ninjamzap.
The original JamTaba README follows.
JamTaba 2
JamTaba 2 is a software to play online music jam sessions. At moment you can use JamTaba to play with musicians around the world using ninjam servers.
JamTaba can be used as a standalone software, VST (Windows) or AU (Mac OSX) plugin. Using the standalone version you can use your camera, audio and MIDI devices and load VST/AU plugins inside JamTaba (JamTaba standalone is a VST/AU host). Using the VST/AU plugin you can use JamTaba in your preferred DAW and send your audio/video to JamTaba, and Jamtaba will stream these contents to ninjam servers. Off course JamTaba will receive and play the other musicians audio/video streams, so you can play with others and have some fun playing online!
More information and User's manual are here : https://github.com/elieserdejesus/JamTaba/wiki
At moment JamTaba standalone works for Windows (Windows XP is not supported since v. 2.1.0), Mac OSX (10.7+) and Linux. The VST plugin is available for windows only (32 and 64 bits) and an Audio Unit (AU) plugin is available for Mac OSX users.
JamTaba is builded using Qt framework. We are using Qt for GUI, threads, sockets, json, http requests, file handling, etc.
JamTaba is using some libraries: portaudio, rtmidi, minimp3, libvorbis and libogg. We are distributing pre compiled static libs just for convenience (see more details in the next sections), but feel free to compile the libs yourself!
On Ubuntu Linux, run the following command to install a missing dependency for Qt 5 Websockets and Qt 5 Widgets:
sudo apt install libqt5websockets5 libqt5widgets5
The library portaudio was pre compiled in windows using only the ASIO flags. So, if you don't have any ASIO driver installed JamTaba will emit an error message in initialization and fallback to an NullAudioDriver, and no sound will be produced. If you have no ASIO devices please install Asio4ALL.
- To avoid store big binay files in the GitHub repository the pre compiled libs are stored in a dropbox account. Please download this file!
- After download the zip file with the pre compiled static libraries please unpack this file inside a folder libs (create this folder). The folders layout will be:
[JamTaba source code folder in your hard disk]
|_ AU_SDK
|_ installers
|_ libs
|_ includes
|_ static
|_ PROJECTS
|_ src
|_ tests
|_ translations
|_ VST_SDK
- Download and install Qt. The Qt installer will install the Qt Framework and the QtCreator, the Qt IDE.
- Download VST SDK
- Unpack the VST SDK content inside a VST_SDK folder (you need create this folder) in JamTaba source code path. After this you have something like that:
[JamTaba source code folder in your hard disk]
|_ AU_SDK
|_ installers
|_ libs
|_ includes
|_ static
|_ PROJECTS
|_ src
|_ tests
|_ translations
|_ VST_SDK <- create this folder
|_ my_plugins
|_ VST2_SDK
|_ VST3_SDK
|_ copy_vst2_to_vst3_sdk.bat
|_ copy_vst2_to_vst3_sdk.sh
-
The QtCreator projects are in the folder PROJECTS. Try open the Standalone.pro in QtCreator to compile JamTaba Standalone.
-
Compile the project in QtCreator (the green button in left side)!
- To compile JamTaba Vst Plugin you need run all steps described in the section Compiling JamTaba Standalone, except the 2 last steps.
- In the last steps you need open the file VstPlugin.pro in QtCreator. If you try to compile this project you will got some errors, because the Vst Plugin can't be compiled using official Qt releases downloaded in Qt official site. These Qt releases are compiled/using shared libraries. You need a static compiled Qt to compile the Vst Plugin, and you need compile this special Qt version for your self. Check this site to see how compile Qt in a "static flavor".
- Inside the folder PROJECTS/VstPlugin you have a file Qt static compile flags.txt with some flags to configure Qt before compile and reduce the size of Qt static libs. These flags will speed up the compilation process too. In my machine (a common laptop with 4 cores) the compilation process lasted 15 minutes using these flags.
