jamulus/README.md

84 lines
3.4 KiB
Markdown
Raw Normal View History

2019-06-16 10:09:09 +02:00
![Homepage picture](src/res/homepage/jamulusbannersmall.png)
2019-06-15 18:33:45 +02:00
2019-07-24 18:08:20 +02:00
[![Build Status](https://travis-ci.org/corrados/jamulus.svg?branch=master)](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)),
__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
![Sourceforge logo](http://sflogo.sourceforge.net/sflogo.php?group_id=158367&amp;type=5)
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
-------------------------
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
**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
----
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 10:19:14 +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)
and the [server documentation](https://github.com/corrados/jamulus/wiki/Running-a-Server).
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:
- 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
- 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).