2019-06-16 10:09:09 +02:00
|
|
|
|
2019-06-15 18:33:45 +02:00
|
|
|
|
2019-07-24 18:08:20 +02:00
|
|
|
[](https://travis-ci.org/corrados/jamulus)
|
2019-07-21 19:17:53 +02:00
|
|
|
|
2019-06-15 18:12:09 +02:00
|
|
|
Jamulus - Internet Jam Session Software
|
2019-06-15 18:26:13 +02:00
|
|
|
=======================================
|
2019-06-16 11:23:17 +02:00
|
|
|
<img align="left" src="src/res/homepage/mediawikisidebarlogo.png"/>
|
2019-06-15 18:12:09 +02:00
|
|
|
|
|
|
|
|
The Jamulus software enables musicians to perform real-time jam sessions over the internet.
|
|
|
|
|
There is one server running the Jamulus server software which collects the audio data from
|
|
|
|
|
each Jamulus client, mixes the audio data and sends the mix back to each client.
|
|
|
|
|
|
2019-06-15 18:26:13 +02:00
|
|
|
Jamulus is __Open Source software__ ([GPL, GNU General Public License](http://www.gnu.org/licenses/gpl-2.0.html))
|
|
|
|
|
and runs under __Windows__ ([ASIO](http://www.steinberg.net)),
|
2020-04-10 20:06:32 +02:00
|
|
|
__MacOS__ ([Core Audio](https://developer.apple.com/documentation/coreaudio)) and
|
2019-06-15 18:26:13 +02:00
|
|
|
__Linux__ ([Jack](http://jackaudio.org)).
|
2019-06-15 18:18:26 +02:00
|
|
|
It is based on the [Qt framework](https://www.qt.io) and uses the [OPUS](http://www.opus-codec.org) audio codec.
|
|
|
|
|
|
2020-03-29 22:19:49 +02:00
|
|
|
The project is hosted at [Sourceforge.net](http://sourceforge.net/projects/llcon).
|
2019-06-16 08:40:16 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Required Hardware Setup
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2019-06-15 18:26:13 +02:00
|
|
|
The required minimum internet connection speed is 200 kbps for the up- and downstream.
|
|
|
|
|
The ping time (i.e. round trip delay) from your computer to the server should not exceed 40 ms average.
|
2019-06-15 18:12:09 +02:00
|
|
|
|
2019-06-16 08:40:16 +02:00
|
|
|
For the Jamulus software to run stable it is recommended to use a PC with at least 1.5 GHz CPU frequency.
|
|
|
|
|
|
|
|
|
|
On a Windows operating system it is recommended to use a sound card with a native ASIO driver.
|
|
|
|
|
This ensures to get the lowest possible latencies.
|
2019-06-15 18:12:09 +02:00
|
|
|
|
|
|
|
|
|
2020-03-29 16:36:17 +02:00
|
|
|
Download and Installation
|
2020-04-10 20:06:32 +02:00
|
|
|
-------------------------
|
2019-06-15 18:33:45 +02:00
|
|
|
|
2020-03-29 16:36:17 +02:00
|
|
|
Download the latest version for [Windows, Macintosh or Linux here](https://sourceforge.net/projects/llcon/files/).
|
2019-06-15 18:33:45 +02:00
|
|
|
|
2020-04-10 20:06:32 +02:00
|
|
|
**Windows users**: The Jamulus client software requires an ASIO sound card driver to be available in the system.
|
|
|
|
|
If your sound card does not have native ASIO support, you can try out [this alternative](http://www.asio4all.org/)
|
2019-06-15 18:33:45 +02:00
|
|
|
|
|
|
|
|
|
2020-03-29 16:36:17 +02:00
|
|
|
Help
|
2020-04-10 20:06:32 +02:00
|
|
|
----
|
2019-06-16 10:19:14 +02:00
|
|
|
|
2020-03-29 16:36:17 +02:00
|
|
|
Official documentation for Jamulus is on the [Github wiki](https://github.com/corrados/jamulus/wiki)
|
|
|
|
|
|
|
|
|
|
See also the [discussion forums](https://sourceforge.net/p/llcon/discussion)
|
|
|
|
|
|
|
|
|
|
Bugs and feature requests can be [reported here](https://github.com/corrados/jamulus/issues)
|
2019-06-16 11:12:38 +02:00
|
|
|
|
2019-06-16 10:19:14 +02:00
|
|
|
|
2019-06-16 08:51:26 +02:00
|
|
|
Compilation and Development
|
|
|
|
|
---------------------------
|
|
|
|
|
|
2020-03-29 21:10:54 +02:00
|
|
|
See the these [compile Instructions](INSTALL.md)
|
2020-03-29 16:36:17 +02:00
|
|
|
|
2020-04-09 15:57:10 +02:00
|
|
|
For server instructions, see [server manual](src/res/homepage/servermanual.md)
|
2020-04-19 03:25:57 +02:00
|
|
|
and the [server documentation](https://github.com/corrados/jamulus/wiki/Running-a-Server).
|
2019-06-16 08:51:26 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Acknowledgments
|
|
|
|
|
---------------
|
2019-06-15 18:12:09 +02:00
|
|
|
|
|
|
|
|
This code contains open source code from different sources. The developer(s) want
|
|
|
|
|
to thank the developer of this code for making their efforts available under open
|
|
|
|
|
source:
|
|
|
|
|
|
2020-04-10 20:06:32 +02:00
|
|
|
- Qt cross-platform application framework: http://www.qt.io
|
2019-06-15 18:12:09 +02:00
|
|
|
|
|
|
|
|
- Opus Interactive Audio Codec: http://www.opus-codec.org
|
|
|
|
|
|
|
|
|
|
- Audio reverberation code: by Perry R. Cook and Gary P. Scavone, 1995 - 2004
|
|
|
|
|
(taken from "The Synthesis ToolKit in C++ (STK)"):
|
|
|
|
|
http://ccrma.stanford.edu/software/stk
|
|
|
|
|
|
2019-06-16 08:40:16 +02:00
|
|
|
- Some pixmaps are from the Open Clip Art Library (OCAL): http://openclipart.org
|
2019-06-15 18:12:09 +02:00
|
|
|
|
2020-04-10 20:06:32 +02:00
|
|
|
- Country flag icons from Mark James: http://www.famfamfam.com
|
|
|
|
|
|
|
|
|
|
We would also like to acknowledge the contributors listed in the
|
|
|
|
|
[Github Contributors list](https://github.com/corrados/jamulus/graphs/contributors).
|
