diff --git a/1-de-index.html b/1-de-index.html index f3dbc8195..9695e0b1c 100644 --- a/1-de-index.html +++ b/1-de-index.html @@ -16,9 +16,9 @@

Was ist Jamulus?

- Jamulus ist eine Software mit der du online musizieren, mit deiner Band üben und mit deinen Freunden oder irgendjemandem, den du zufällig online findest, jammen kannst. Die Software ist kostenlos, läuft auf Windows-, macOS- oder Linux PCs und - funktioniert über eine normale Internetverbindung. Verbinde dich einfach mit einem Jamulus Server (von denen es weltweit Hunderte gibt) oder hoste deinen eigenen Server. Jamulus wird für eine hohe Klangqualität mit niedriger Latenz entwickelt, - sodass du auch aus der Ferne mit anderen gleichzeitig zusammenspielen kannst. Noch nicht überzeugt? Schau dir an, wie andere Menschen online Musik machen! + Jamulus ist eine Software mit der du online musizieren, üben oder einfach mit geringer Verzögerung Jammen kannst. Du kannst deinen Windows, Mac oder Linux PC nutzen und dich mit einem der vielen weltweit verstreuten Servern verbinden. + Jamulus ist kostenlos funktioniert über eine normale Internetverbindung. Verbinde dich einfach mit einem öffentlichen Jamulus Server oder hoste deinen eigenen privaten. Jamulus wird seit 2006 für eine hohe Klangqualität mit niedriger Latenz entwickelt, + damit jeder einfach online gleichzeitig musizieren kann. Noch nicht überzeugt? Schau dir an, wie andere Menschen online Musik machen!
@@ -41,15 +41,14 @@

Wer nutzt Jamulus?

Brauchst du Hilfe?

- Wirf einen Blick in die Jamulus Dokumentation. Vielleicht wird dein Problem auf der Fehlerbehebungsseite beschrieben! - Du kannst auch im Forum (Englisch) nach Hilfe fragen. + Wirf einen Blick in die Jamulus Dokumentation. Vielleicht wird dein Problem auf der Fehlerbehebungsseite beschrieben! + Du kannst auch im Forum (Englisch) nach Hilfe fragen.

-

Mithelfen

+

Willst du mithelfen?

- Ideen? Hast du einen Fehler gefunden? Willst du mithelfen? Da Jamulus Freie/Open Source Software ist, die unter der GPL Lizenz steht, kannst du aktiv mitgestalten! Das Projekt ist auf SourceForge und der - Quellcode auf GitHub! + Ideen? Hast du einen Fehler gefunden? Willst du bei der Übersetzung oder Weiterentwicklung mithelfen? Da Jamulus Freie/Open Source Software ist, die unter der GPL Lizenz steht, kannst du aktiv mitgestalten! Schau dir die Seite zum Mitgestalten an. Wir freuen uns auf dich!

diff --git a/1-es-index.html b/1-es-index.html index 77f55130c..820dc7177 100644 --- a/1-es-index.html +++ b/1-es-index.html @@ -17,7 +17,7 @@

¿Qué es Jamulus?

- Jamulus es para tocar, ensayar o simplemente hacer una jam session con amig@s, tu banda o con cualquiera que encuentres online. Utiliza tu ordenador Windows, macOS o Linux para conectarte a servidores de Jamulus en todo el mundo, gratis, con una conexión normal de banda ancha. O habilita tu propio servidor. Jamulus está diseñado para reproducir audio de alta calidad a baja latencia, haciendo que tocar remotamente manteniendo el tiempo sea fácil. Mira cómo lo hacen otras personas
@@ -32,18 +32,18 @@

¿Qué es Jamulus?

Jamulus en todo el mundo

- Por todo el mundo, Jamulus permite cantar a enormes coros, tocar a bandas de rock y junta a músicos clásicos y de folk. Se utiliza para clases a distancia en escuelas y universidades, en privado y en público. Incluso simplemente para hablar - todo en tiempo real a través de Internet, como si estuvieras allí en persona. + Por todo el mundo, Jamulus permite ensayar a enormes coros, tocar a bandas de rock y junta a músicos clásicos y de folk. Se utiliza para clases a distancia en escuelas y universidades, en privado y en público. Incluso simplemente para hablar - todo en tiempo real a través de Internet, como si estuvieras allí en persona.

¿Necesitas ayuda?

- Consulta la documentación. ¡Sobre todo presta atención a la sección de resolución de problemas! También puedes preguntar en los foros. + Consulta la documentación y presta atención a la sección de resolución de problemas. También puedes preguntar en los foros.

-

¡Contribuye!

+

¿Quieres involucrarte?

- ¿Ideas? ¿Has encontrado un fallo? ¿Quieres contribuir? Ya que Jamulus es de código libre y abierto publicado bajo la GPL ¡nos puedes ayudar!
- Echa un vistazo a nuestras directrices para contribuciones para ver cómo hacerlo. ¡Bienvenid@! + ¿Ideas? ¿Has encontrado un fallo? ¿Quieres contribuir con código o ayudar a traducir a tu idioma? Ya que Jamulus es de código libre y abierto publicado bajo la GPL ¡nos puedes ayudar!
+ Echa un vistazo a nuestras directrices para contribuciones para ver cómo hacerlo. ¡Cualquiera es bienvenid@!

diff --git a/1-index.html b/1-index.html index ad9ee2c55..dff6994ae 100644 --- a/1-index.html +++ b/1-index.html @@ -16,11 +16,7 @@

What is Jamulus?

- Jamulus is for playing, rehearsing, or just jamming with your friends, your band or just anyone you find online. Use your Windows, macOS or Linux machine to connect to Jamulus servers worldwide, for free over a normal broadband - connection. Or - host your own private server. Jamulus is designed for high quality, low-latency sound, making it easy to play together remotely and in time. Have a look at how people - do it! + Jamulus is software for playing music, rehearsing, or just jamming with anyone online with low latency. You can use your Windows, macOS or Linux machine to connect to Jamulus servers worldwide. Jamulus is free and you can just use your normal broadband connection. Simply connect to a public server or host your own private one. Jamulus has been in development since 2006 and is designed for high quality, low-latency sound, making it easy to play together remotely and in time. Have a look at how people do it!
@@ -34,7 +30,7 @@

What is Jamulus?

Jamulus worldwide

- All over the world Jamulus allows huge choirs to sing, loud rock bands to play, and brings folk and classical musicians together. It's being used for remote music lessons, + All over the world Jamulus allows huge choirs to rehearse, loud rock bands to play, and brings folk and classical musicians together. It's being used for remote music lessons, in schools and universities, in private and in public. Even just for the spoken word – all in real time on the Internet, as if you were there in person.

Help needed?

@@ -44,10 +40,10 @@

Help needed?

-

Contribute!

+

Want to get involved?

- Ideas? Found a bug? Want to contribute? Since Jamulus is free and open source software licensed under the GPL you can help us!
- Take a look at our contribution guidelines to find out how. You're welcome! + Ideas? Found a bug? Want to contribute some code or help translating into your language? Since Jamulus is free and open source software (FOSS) licensed under the GPL, you can help us!
+ Take a look at our contribution guidelines to find out how. Everybody is welcome!

diff --git a/_config.yml b/_config.yml index 76a1a3552..27b85a269 100644 --- a/_config.yml +++ b/_config.yml @@ -18,7 +18,7 @@ download_file_names: android: "jamulus_3.7.0_android.apk" githubrepoeditbase: "https://github.com/jamulussoftware/jamuluswebsite/edit/changes" -kbnewpage: 'https://github.com/jamulussoftware/jamuluswebsite/new/changes/_posts/?value=---%0Alayout%3A%20post%0Atitle%3A%20%22Your%20Title%22%0Alang%3A%20%22en%22%0Aauthor%3A%20%22YourName%22%0Aheading%3A%20%22Heading%22%0A---%0AName%20This%20File%20and%20edit%20the%20parameters%20above%21&message=New%20post' +kbnewpage: 'https://github.com/jamulussoftware/jamuluswebsite/new/changes/_posts/?value=---%0Alayout%3A%20post%0Atitle%3A%20%22Your%20Title%22%0Alang%3A%20%22en%22%0Aauthor%3A%20%22YourName%22%0Aheading%3A%20%22Heading%22%0A---%0AName%20this%20file%20and%20edit%20the%20parameters%20above%21&message=New%20post' exclude: ["README.md", "Gemfile.lock", "Gemfile", "CONTRIBUTING.md"] jekyll-minifier: remove_intertag_spaces: true diff --git a/_data/de/authors.yml b/_data/de/authors.yml new file mode 100644 index 000000000..19da538f0 --- /dev/null +++ b/_data/de/authors.yml @@ -0,0 +1,10 @@ +corrados: + name: Volker Fischer + url: https://github.com/corrados +niebert: + name: Engelbert Niehaus + url: https://github.com/niebert +ann0see: + url: https://github.com/ann0see +gilgongo: + url: https://github.com/gilgongo diff --git a/_data/de/general.yml b/_data/de/general.yml index 9e93816f6..badeb344d 100644 --- a/_data/de/general.yml +++ b/_data/de/general.yml @@ -10,4 +10,15 @@ nav: btnOpenNavigation: "Navigationsmenü öffnen" altJamulusIcon: "Jamulus Icon. Link zur Wiki Startseite" wiki: - titleAdd: "– Jamulus Wiki" + titleAdd: "– Jamulus Wiki" +kb: + titleAdd: "– Jamulus Knowledge Base" + by: "by" + kbintro: "Community Knowledge Base
Füge deinen eigenen Artikel hinzu!" + mainpage: "KB Übersicht" + newpage: "Neue Seite hinzufügen (über GitHub)" + readmore: "Mehr..." + navpages: "Weitere Seiten" + discuss: + title: "Kommentare" + linktitle: "Kommentieren" diff --git a/_data/de/navigation.yml b/_data/de/navigation.yml index 49544c25c..8b0d7e047 100644 --- a/_data/de/navigation.yml +++ b/_data/de/navigation.yml @@ -24,8 +24,9 @@ nav: url: /wiki/Command-Line-Options - page: Tipps & Tricks url: /wiki/Tips-Tricks-More - - page: Kompilieren - url: /wiki/Compiling + - page: Community Knowledge Base + url: /kb/index.html + selectOnLayout: "post" - page: Demos url: /wiki/Demos - page: Datenschutz diff --git a/_data/en/authors.yml b/_data/en/authors.yml new file mode 100644 index 000000000..19da538f0 --- /dev/null +++ b/_data/en/authors.yml @@ -0,0 +1,10 @@ +corrados: + name: Volker Fischer + url: https://github.com/corrados +niebert: + name: Engelbert Niehaus + url: https://github.com/niebert +ann0see: + url: https://github.com/ann0see +gilgongo: + url: https://github.com/gilgongo diff --git a/_data/en/general.yml b/_data/en/general.yml index 2f96a3de5..d87fb0c5c 100644 --- a/_data/en/general.yml +++ b/_data/en/general.yml @@ -1,5 +1,5 @@ footer: - copyright: Software by Volker Fischer and contributors + copyright: Software by Volker Fischer and contributors alt: github: "Jamulus GitHub Repo" facebook: "Jamulus Facebook Group" @@ -10,4 +10,15 @@ nav: btnOpenNavigation: "Open navigation" altJamulusIcon: "Jamulus Icon. Links to Wiki homepage" wiki: - titleAdd: "– Jamulus Wiki" + titleAdd: "– Jamulus Wiki" +kb: + titleAdd: "– Jamulus Knowledge Base" + by: "by" + kbintro: "Community knowledge base
Feel free to add your own article!" + mainpage: "KB overview" + newpage: "Add a new page via GitHub" + readmore: "Read more..." + navpages: "More pages" + discuss: + title: "Comments" + linktitle: "Discuss this content" diff --git a/_data/en/navigation.yml b/_data/en/navigation.yml index d3d25885c..8c875d423 100644 --- a/_data/en/navigation.yml +++ b/_data/en/navigation.yml @@ -24,6 +24,9 @@ nav: url: /wiki/Command-Line-Options - page: Tips & Tricks url: /wiki/Tips-Tricks-More + - page: Community Knowledge Base + url: /kb/index.html + selectOnLayout: "post" - page: Demos url: /wiki/Demos - page: Privacy Statement diff --git a/_data/es/general.yml b/_data/es/general.yml index 243207895..c1c918b60 100644 --- a/_data/es/general.yml +++ b/_data/es/general.yml @@ -1,9 +1,24 @@ footer: - copyright: Un software de Volker Fischer y contribuyentes + copyright: Un software de Volker Fischer y contribuyentes alt: - github: "Repositorio Jamulus en GitHub" - facebook: "Grupo de Facebook de Jamulus" - sourceforge: "Descargar Jamulus de SourceForge.net" -btnEditAlt: "Edita esta página" + github: "Repositorio Jamulus en GitHub" + facebook: "Grupo de Facebook de Jamulus" + sourceforge: "Descargar Jamulus de SourceForge.net" +btnEditAlt: "Edita esta página" +tNoJSEnabled: "Tu navegador tiene JavaScript deshabilitado. No pasa nada. Esta página está diseñada para ofrecer la funcionalidad básica sin JS. Habilitar JavaScript puede proporcionarte funcionalidades adicionales en esta página." +nav: + btnOpenNavigation: "Abrir navegación" + altJamulusIcon: "Icono Jamulus. Enlaces a la página de inicio de la Wiki" wiki: - titleAdd: "– Jamulus Wiki" + titleAdd: "– Jamulus Wiki" +kb: + titleAdd: "– Base de Consulta de Jamulus" + by: "by" + kbintro: "Base de consulta comunitaria
¡Añade tu propio artículo!" + mainpage: "Resumen BC" + newpage: "Añade una nueva página a través de GitHub" + readmore: "Leer más..." + navpages: "Más páginas" + discuss: + title: "Comentarios" + linktitle: "Hablar sobre este contenido" diff --git a/_data/es/navigation.yml b/_data/es/navigation.yml index 4d5f94b3f..3e16c7e8a 100644 --- a/_data/es/navigation.yml +++ b/_data/es/navigation.yml @@ -24,6 +24,9 @@ nav: url: /wiki/Command-Line-Options - page: Consejos y Trucos url: /wiki/Tips-Tricks-More + - page: Base de Consulta Comunitaria + url: /kb/index.html + selectOnLayout: "post" - page: Demos url: /wiki/Demos - page: Declaración de Privacidad diff --git a/_includes/wiki/de/footertext.md b/_includes/wiki/de/footertext.md index a964b2911..d01b5255f 100644 --- a/_includes/wiki/de/footertext.md +++ b/_includes/wiki/de/footertext.md @@ -1,5 +1,5 @@ -**Sommer 2020! Sag uns, was du über Jamulus denkst - [fülle unsere anonyme Umfrage aus (English)](https://forms.gle/hSSjsxjWj2Pnp5kr7)** +**Sag uns, was du über Jamulus denkst - [fülle unsere anonyme Umfrage aus (English)](https://forms.gle/hSSjsxjWj2Pnp5kr7)** _Dieses Wiki ist unter einer [Creative Commons Lizenz](https://creativecommons.org/licenses/by-sa/4.0/deed.de){: target="_blank" rel="noreferrer" } lizenziert. Willst du [mithelfen](Contribution)?_ diff --git a/_includes/wiki/en/footertext.md b/_includes/wiki/en/footertext.md index 92630a0db..f33023a1c 100644 --- a/_includes/wiki/en/footertext.md +++ b/_includes/wiki/en/footertext.md @@ -1,6 +1,6 @@ -**Summer 2020! Tell us about Jamulus - [take our anonymous survey!](https://forms.gle/hSSjsxjWj2Pnp5kr7)** +**Tell us about Jamulus - [take our anonymous survey!](https://forms.gle/hSSjsxjWj2Pnp5kr7)** -_This documentation is licensed under a [Creative Commons License](https://creativecommons.org/licenses/by-sa/4.0/deed.en){: target="_blank" rel="noreferrer" }. Want to [contribute](Contribution)?_ +_This documentation is licensed under a [Creative Commons Licence](https://creativecommons.org/licenses/by-sa/4.0/deed.en){: target="_blank" rel="noreferrer" }. Want to [get involved](Contribution)?_ diff --git a/_includes/wiki/es/footertext.md b/_includes/wiki/es/footertext.md index 350e7371f..f9a97b97c 100644 --- a/_includes/wiki/es/footertext.md +++ b/_includes/wiki/es/footertext.md @@ -1,6 +1,6 @@ -**¡Verano 2020! Cuéntanos algo sobre Jamulus - [completa esta encuesta anónima](https://forms.gle/hSSjsxjWj2Pnp5kr7) (en inglés)** +**Cuéntanos algo sobre Jamulus - [completa esta encuesta anónima](https://forms.gle/hSSjsxjWj2Pnp5kr7) (en inglés)** _Esta documentación se publica bajo una [Licencia Creative Commons](https://creativecommons.org/licenses/by-sa/4.0/deed.es){: target="_blank" rel="noreferrer" }. -¿Te gustaría [contribuir](Contribution)?_ +¿Te gustaría [involucrarte](Contribution)?_ diff --git a/_posts/2021-01-05-Jamulus-Sound-Devices.md b/_posts/2021-01-05-Jamulus-Sound-Devices.md index 01bf7bfd5..a10864029 100644 --- a/_posts/2021-01-05-Jamulus-Sound-Devices.md +++ b/_posts/2021-01-05-Jamulus-Sound-Devices.md @@ -13,7 +13,7 @@ _**Note**: If they work or not can depend on your operating system (Linux, MacOS ## Updating this page -You can update this page with the information you have. **Please indicate the platform(s) you are using!**. Just [open an issue with the sound device topic on the Jamulus documentation repo](https://github.com/jamulussoftware/jamuluswebsite/issues/new?template=newsounddevice.md) and fill the form. +You can update this page with the information you have. **Please indicate the platform(s) you are using!** Just [open an issue and give more information on your device](https://github.com/jamulussoftware/jamuluswebsite/issues/new). ## Audio devices known to work with Jamulus @@ -137,9 +137,9 @@ _**Note:** The Ammoon AGM04 appears to be a re-branded [ART USBMix4](https://art **macOS**: Works great. -**Linux**: Works great. +**Linux**: Works great. -Tested Behringer XENYX X1832 USB (USB audio) on Ubuntu 20.04 LTS which works fine. +Tested Behringer XENYX X1832 USB (USB audio) on Ubuntu 20.04 LTS which works fine. _More testing required._ *** diff --git a/assets/img/en-screenshots/asio-setup-button.png b/assets/img/en-screenshots/asio-setup-button.png new file mode 100644 index 000000000..95e883423 Binary files /dev/null and b/assets/img/en-screenshots/asio-setup-button.png differ diff --git a/assets/img/en-screenshots/audio-channels.png b/assets/img/en-screenshots/audio-channels.png new file mode 100644 index 000000000..1981e01d3 Binary files /dev/null and b/assets/img/en-screenshots/audio-channels.png differ diff --git a/assets/img/en-screenshots/audio-quality.png b/assets/img/en-screenshots/audio-quality.png new file mode 100644 index 000000000..db11b9ee0 Binary files /dev/null and b/assets/img/en-screenshots/audio-quality.png differ diff --git a/assets/img/en-screenshots/buffer-delay-2.png b/assets/img/en-screenshots/buffer-delay-2.png new file mode 100644 index 000000000..3cee1074a Binary files /dev/null and b/assets/img/en-screenshots/buffer-delay-2.png differ diff --git a/assets/img/en-screenshots/buffer-delay.png b/assets/img/en-screenshots/buffer-delay.png new file mode 100644 index 000000000..2f08e50fe Binary files /dev/null and b/assets/img/en-screenshots/buffer-delay.png differ diff --git a/assets/img/en-screenshots/chat-window.png b/assets/img/en-screenshots/chat-window.png new file mode 100644 index 000000000..4b3b7f8b5 Binary files /dev/null and b/assets/img/en-screenshots/chat-window.png differ diff --git a/assets/img/en-screenshots/connection-setup-window.png b/assets/img/en-screenshots/connection-setup-window.png new file mode 100644 index 000000000..f8850f094 Binary files /dev/null and b/assets/img/en-screenshots/connection-setup-window.png differ diff --git a/assets/img/en-screenshots/connection-status.png b/assets/img/en-screenshots/connection-status.png new file mode 100644 index 000000000..bcda8beb4 Binary files /dev/null and b/assets/img/en-screenshots/connection-status.png differ diff --git a/assets/img/en-screenshots/device-select-mac.png b/assets/img/en-screenshots/device-select-mac.png new file mode 100644 index 000000000..0ae84cfa6 Binary files /dev/null and b/assets/img/en-screenshots/device-select-mac.png differ diff --git a/assets/img/en-screenshots/device-select-windows.png b/assets/img/en-screenshots/device-select-windows.png new file mode 100644 index 000000000..b3957e380 Binary files /dev/null and b/assets/img/en-screenshots/device-select-windows.png differ diff --git a/assets/img/en-screenshots/diagram-overview.png b/assets/img/en-screenshots/diagram-overview.png new file mode 100644 index 000000000..b09f44fbb Binary files /dev/null and b/assets/img/en-screenshots/diagram-overview.png differ diff --git a/assets/img/en-screenshots/diagram-private-server.png b/assets/img/en-screenshots/diagram-private-server.png new file mode 100644 index 000000000..de6a53c57 Binary files /dev/null and b/assets/img/en-screenshots/diagram-private-server.png differ diff --git a/assets/img/en-screenshots/diagram-public-server.png b/assets/img/en-screenshots/diagram-public-server.png new file mode 100644 index 000000000..88679d19b Binary files /dev/null and b/assets/img/en-screenshots/diagram-public-server.png differ diff --git a/assets/img/en-screenshots/directory-custom.png b/assets/img/en-screenshots/directory-custom.png new file mode 100644 index 000000000..360bc5177 Binary files /dev/null and b/assets/img/en-screenshots/directory-custom.png differ diff --git a/assets/img/en-screenshots/fancy-skin.png b/assets/img/en-screenshots/fancy-skin.png new file mode 100644 index 000000000..96d3dd020 Binary files /dev/null and b/assets/img/en-screenshots/fancy-skin.png differ diff --git a/assets/img/en-screenshots/input-level.png b/assets/img/en-screenshots/input-level.png new file mode 100644 index 000000000..0fac889d5 Binary files /dev/null and b/assets/img/en-screenshots/input-level.png differ diff --git a/assets/img/en-screenshots/jitter-buffer.png b/assets/img/en-screenshots/jitter-buffer.png new file mode 100644 index 000000000..7c8681a76 Binary files /dev/null and b/assets/img/en-screenshots/jitter-buffer.png differ diff --git a/assets/img/en-screenshots/main-screen-default.png b/assets/img/en-screenshots/main-screen-default.png new file mode 100644 index 000000000..6ee8a10bc Binary files /dev/null and b/assets/img/en-screenshots/main-screen-default.png differ diff --git a/assets/img/en-screenshots/main-screen-large.png b/assets/img/en-screenshots/main-screen-large.png new file mode 100644 index 000000000..718299335 Binary files /dev/null and b/assets/img/en-screenshots/main-screen-large.png differ diff --git a/assets/img/en-screenshots/main-screen-medium.png b/assets/img/en-screenshots/main-screen-medium.png new file mode 100644 index 000000000..12be74a6d Binary files /dev/null and b/assets/img/en-screenshots/main-screen-medium.png differ diff --git a/assets/img/en-screenshots/main-screen-small.png b/assets/img/en-screenshots/main-screen-small.png new file mode 100644 index 000000000..2328aa82e Binary files /dev/null and b/assets/img/en-screenshots/main-screen-small.png differ diff --git a/assets/img/en-screenshots/mixer-channles.png b/assets/img/en-screenshots/mixer-channles.png new file mode 100644 index 000000000..8de577a93 Binary files /dev/null and b/assets/img/en-screenshots/mixer-channles.png differ diff --git a/assets/img/en-screenshots/new-client-level.png b/assets/img/en-screenshots/new-client-level.png new file mode 100644 index 000000000..6892c86b7 Binary files /dev/null and b/assets/img/en-screenshots/new-client-level.png differ diff --git a/assets/img/en-screenshots/pan-slider.png b/assets/img/en-screenshots/pan-slider.png new file mode 100644 index 000000000..f06b3bed8 Binary files /dev/null and b/assets/img/en-screenshots/pan-slider.png differ diff --git a/assets/img/en-screenshots/profile-tooltip.png b/assets/img/en-screenshots/profile-tooltip.png new file mode 100644 index 000000000..a1494ece5 Binary files /dev/null and b/assets/img/en-screenshots/profile-tooltip.png differ diff --git a/assets/img/en-screenshots/profile-window.png b/assets/img/en-screenshots/profile-window.png new file mode 100644 index 000000000..41be8afdc Binary files /dev/null and b/assets/img/en-screenshots/profile-window.png differ diff --git a/assets/img/en-screenshots/reverb.png b/assets/img/en-screenshots/reverb.png new file mode 100644 index 000000000..51307addd Binary files /dev/null and b/assets/img/en-screenshots/reverb.png differ diff --git a/assets/img/en-screenshots/server-window-options.png b/assets/img/en-screenshots/server-window-options.png new file mode 100644 index 000000000..1a87686bc Binary files /dev/null and b/assets/img/en-screenshots/server-window-options.png differ diff --git a/assets/img/en-screenshots/server-window-setup.png b/assets/img/en-screenshots/server-window-setup.png new file mode 100644 index 000000000..bc3b85e9b Binary files /dev/null and b/assets/img/en-screenshots/server-window-setup.png differ diff --git a/assets/img/en-screenshots/settings-window.png b/assets/img/en-screenshots/settings-window.png new file mode 100644 index 000000000..d25081d83 Binary files /dev/null and b/assets/img/en-screenshots/settings-window.png differ diff --git a/assets/img/en-screenshots/verification-mac.png b/assets/img/en-screenshots/verification-mac.png new file mode 100644 index 000000000..d999c74c3 Binary files /dev/null and b/assets/img/en-screenshots/verification-mac.png differ diff --git a/humans.txt b/humans.txt index 29626b0ff..5785a9744 100644 --- a/humans.txt +++ b/humans.txt @@ -2,11 +2,9 @@ Texts and Software: corrados Site: https://github.com/corrados/ -Texts and translation: gilgongo -Site: https://github.com/gilgongo +Texts and translation: gilgongo and contributors +HTML and CSS Coding: ann0see and contributors -HTML and CSS Coding: ann0see -Site: https://github.com/ann0see Images: geheimerEichkater Site: https://github.com/geheimerEichkater diff --git a/wiki/de/de-Adminstration.md b/wiki/de/de-Adminstration.md new file mode 100644 index 000000000..e5a4b2527 --- /dev/null +++ b/wiki/de/de-Adminstration.md @@ -0,0 +1,6 @@ +--- +layout: wiki +title: "Adminstration" +lang: "de" +permalink: "/wiki/Adminstration" +--- diff --git a/wiki/de/de-Central-Servers.md b/wiki/de/de-Central-Servers.md index 58d844f4c..ccdd94c92 100644 --- a/wiki/de/de-Central-Servers.md +++ b/wiki/de/de-Central-Servers.md @@ -5,20 +5,24 @@ lang: "de" permalink: "/wiki/Central-Servers" --- +{% include breadcrumb.html root="Mehr" branch1="Server einrichten" branch1-url="Running-a-Server" %} + # Öffentliche Zentrale Server -Um das Problem der Überschreitung des Serverlimits zu reduzieren, haben wir ab Mai 2020 genrebasierte zentrale Server eingeführt (mit einer derzeitigen Begrenzung auf jeweils 150 Server). +Da jeder Zentralserver ein Limit von 150 Servern hat, musst du einen Zentralserver aussuchen, auf dem du deinen Server registrieren willst. Suche dir ein Genre aus, wenn du möchtest, dass eher Musiker eines bestimmten Genres auf deinem Server spielen (Musiker können deinen Server in ihrer Genre Liste sehen). -Wenn du deinen Server im öffentlichen Modus startest, wird im Server angezeigt, ob dein Server erfolgreich registriert werden konnte, oder nicht. Wenn du deinen Server nicht stoppst, wird er immer wieder versuchen sich zu registrieren, bis ein freier Slot verfügbar ist. +Wenn du deinen Server im öffentlichen Modus startest, wird dir angezeigt, ob dein Server erfolgreich registriert werden konnte, oder nicht. Sollte das nicht der Fall sein du aber deinen Server nicht stoppst, wird er immer wieder versuchen sich zu registrieren, bis ein freier Slot verfügbar ist. ## Headless Server -Ab Jamulus v3.5.4 musst du den zentralen (Genre-)Server in der Kommandozeile manuell mit der Option `--centralserver` (`-e`) setzen. Das sind die offiziellen zentralen Server: +Setze den zentralen (Genre-)Server in der Kommandozeile mit der Option `--centralserver` (`-e`) wie folgt: | Genre | Server address | |-----------|------------------| -|**All/Any** |`jamulusallgenres.fischvolk.de:22224` | -|**Rock**|`jamulusrock.fischvolk.de:22424`| -|**Jazz**|`jamulusjazz.fischvolk.de:22324`| -|**Klassik/Folklore/Chor**|`jamulusclassical.fischvolk.de:22524`| -|Default _(veraltet seit Jamulus v3.5.4)_|`jamulus.fischvolk.de:22124`| +|**Alle Genres 1** |`anygenre1.jamulus.io:22124` | +|**Alle Genres 2** |`anygenre2.jamulus.io:22224`| +|**Alle Genres 3** |`anygenre3.jamulus.io:22624`| +|**Genre Rock** |`rock.jamulus.io:22424`| +|**Genre Jazz** |`jazz.jamulus.io:22324`| +|**Genre Klassik/Folk** |`classical.jamulus.io:22524`| +|**Genre Chor/Barbershop** |`choral.jamulus.io:22724`| diff --git a/wiki/de/de-Choosing-a-Server-Type.md b/wiki/de/de-Choosing-a-Server-Type.md index 911eeaf3e..121de69a3 100644 --- a/wiki/de/de-Choosing-a-Server-Type.md +++ b/wiki/de/de-Choosing-a-Server-Type.md @@ -5,6 +5,9 @@ lang: "de" permalink: "/wiki/Choosing-a-Server-Type" --- + +{% include breadcrumb.html root="Mehr" branch1="Server einrichten" branch1-url="Running-a-Server" %} + # Serverarten Du kannst einen Server in einem von drei „Modi“ betreiben (entweder bei dir zu Hause oder auf einem externen Server): @@ -53,6 +56,8 @@ Jeder Server kann sich an deinem zentralen Server registrieren, um in deiner Lis Der Server, der als zentraler Server konfiguriert werden soll, muss mit `--centralserver localhost` gestartet werden (d.h. der zentrale Server, an dem sich dieser Server anmeldet ist er selbst). -Wenn du steuern möchtest, welche Server sich an deinem zentralen Server registrieren können, kannst du eine Whitelist mit der Option `--listfilter` aktivieren. Weitere Informationen zu dieser Funktion findest du auf der Seite [Kommandozeilen-Optionen](Command-Line-Options). +#### Konfigurationsoptionen + +Wenn du steuern möchtest, welche Server sich an deinem zentralen Server registrieren können, kannst du eine Whitelist mit der Option `--listfilter` aktivieren. Weitere Informationen zu dieser und anderer Funktionen findest du auf der Seite [Kommandozeilen-Optionen](Command-Line-Options). -Siehe auch [Befehlszeilenoptionen](Command-Line-Options) für weitere Parameter, die Du einstellen kannst. +Wenn du einen öffentlichen Zentralserver hinter einer NAT/Firewall in einem privaten Netzwerk betreibst, nutze die `--serverpublicip` Option um die öffentliche IP der Server, die auf dem Zentralserver aufgelistet werden. Du musst dieses Argument setzen, damit sich Clients aus dem öffentlichen Internet mit den Servern hinter der NAT verbinden können. Server die diese Funktion nutzen benötigen trotzdem Port Forwarding in deinem Router/Firewall. diff --git a/wiki/de/de-Command-Line-Options.md b/wiki/de/de-Command-Line-Options.md index 32f650200..fb53621d6 100644 --- a/wiki/de/de-Command-Line-Options.md +++ b/wiki/de/de-Command-Line-Options.md @@ -9,7 +9,7 @@ permalink: "/wiki/Command-Line-Options" Obwohl die gebräuchlichsten Funktionen in Jamulus über die GUI eingestellt werden können, lässt sich Jamulus auch über die Kommandozeile steuern. Wie das genau funktioniert, hängt von deinem Betriebssystem ab. -Unter Windows kannst du die Rekorderfunktion `-R` z.B. wie folgt aktivieren: Klicke mit der rechten Maustaste auf die Jamulus Verknüpfung, dann auf „Eigenschaften“ und füge die entsprechende Option (in diesem Beispiel `-R`) nach Jamulus.exe hinzu: +Unter Windows kannst du die Aufnahmefunktion `-R` z.B. wie folgt aktivieren: Klicke mit der rechten Maustaste auf die Jamulus Verknüpfung, dann auf „Eigenschaften“ und füge die entsprechende Option (in diesem Beispiel `-R`) nach Jamulus.exe hinzu: ```shell "C:\Program Files (x86)\Jamulus\Jamulus.exe" -s -R "C:\Pfad\zu\deinen\Aufnahmen" @@ -32,17 +32,17 @@ Du kannst dir alle verfügbaren Optionen der aktuellen Jamulus Version über den | `-d` |`--discononquit` | Trenne alle Verbindungen mit allen Clients beim Beenden des Servers | (nur Server) | | `-e` |`--centralserver` | Mache diesen Server öffentlich verfügbar und setzt sein Genre. Schau dir auch die Option `-o` an | (nur Server) [Siehe hier](Choosing-a-Server-Type#1-öffentlich). | | `-f` |`--listfilter` | Setze Server auf die Whitelist, Format `IP Adresse 1[;IP Adresse 2]` | (nur Zentralserver) [Siehe hier](Choosing-a-Server-Type#3-zentral). | -| `-F` |`--fastupdate` | 64 samples frame size Modus. Reduziert Latenz wenn Clients mit der "Enable Small Network Buffers" Option verbunden sind. Benötigt schnelle CPU um Dropouts zu vermeiden, und mehr Bandbreite. | (nur Server) | +| `-F` |`--fastupdate` | 64 samples frame size Modus. Reduziert Latenz wenn Clients mit der "Aktiviere kleine Netzwerkpuffer" Option verbunden sind. Benötigt schnelle CPU um Dropouts zu vermeiden, und mehr Bandbreite. | (nur Server) | | `-h,-?` |`--help` | Dieser Hilfetext | (Client und Server) | -| `-i` |`--inifile` | Setze Pfad zur Initialisierungs Datei (überschreibt den Standard) | (Client (immer) und Server (mit GUI)) | +| `-i` |`--inifile` | Setze Pfad zur Einstellungsdatei (überschreibt den Standard) | (Client (immer) und Server (mit GUI)) | | `-j` |`--nojackconnect` | Deaktiviert automatische JACK Verbindung | (nur Client) | | `-l` |`--log` | Aktiviere Logging, gebe Pfad und Dateinamen an | (nur Server) | | `-m` |`--htmlstatus` | Aktiviere HTML Status Datei, gebe Pfad und Dateinamen an | (nur Server) | -| `-M` |`--mutestream` | Starte Jamulus im stummgeschalteten Modus | (nur Client) | +| `-M` |`--mutestream` | Starte Jamulus im stumm-geschalteten Modus | (nur Client) | | `-n` |`--nogui` | Deaktiviere GUI | (Client und Server) | | `-o` |`--serverinfo` | Serverstandort im Format:
`[Name];[Stadt];[Lokaler Wert]` (Siehe [Werte](https://doc.qt.io/qt-5/qlocale.html#Country-enum))| (nur öffentliche Server) | | `-p` |`--port` | Lokaler UDP Port. Standard ist 22124 | (nur Server) | -| `-R` |`--recording` | Pfad zu einem beschreibbaren Pfad wo die Aufgenommenen Dateien gespeichert werden (in Anführungszeichen wenn nötig). | (nur Server) Siehe Beschreibung im [Server Setup](Server-Win-Mac#recording). | +| `-R` |`--recording` | Pfad zu einem beschreibbaren Pfad wo die aufgenommenen Dateien gespeichert werden (in Anführungszeichen wenn nötig). | (nur Server) Siehe Beschreibung im [Server Setup](Server-Win-Mac#recording). | | | `--norecord` | Starte mit deaktivierten Recorder | (nur Server) | | `-s` |`--server` | Starte in Server Modus | (nur Server) [Siehe Notiz](Choosing-a-Server-Type) | | `-t` |`--notranslation` | Keine Übersetzungen | (Client und Server) | @@ -50,5 +50,6 @@ Du kannst dir alle verfügbaren Optionen der aktuellen Jamulus Version über den | `-u` |`--numchannels` | Maximale Anzahl an Nutzern. Standard ist 10, Maximum ist 50 | (nur Server) | | `-w` |`--welcomemessage` | Begrüßungsnachricht. Unterstützt HTML und inline CSS (in Anführungszeichen), oder Pfad zu einer Textdatei. | (nur Server) | | `-z` |`--startminimized` | Starte minimiert | (nur Server) | -| |`--ctrlmidich` | MIDI Controller Kanal und Offset, Format `channel[;offset]` | (nur Client) Siehe [Tipps & Tricks](Tips-Tricks-More#Using-ctrlmidich-for-MIDI-controllers) | -| |`--clientname` | Fenster Titel und Jack Client Name | (nur Client) | +| |`--ctrlmidich` | MIDI Controller Kanal, Offset und fortlaufende CC Zahlen (Kanäle). Format `channel[;f*][;p*][;s*][;m*]` | (nur Client) Siehe [Tipps & Tricks](Tips-Tricks-More#Using-ctrlmidich-for-MIDI-controllers) | +| |`--clientname` | Fenster Titel und JACK Client Name | (nur Client) | +| |`--serverpublicip` | Setze die öffentliche IP des Servers | (nur Server) [Mehr Informationen](Choosing-a-Server-Type) | diff --git a/wiki/de/de-Compiling.md b/wiki/de/de-Compiling.md index 31700b0f2..32f1cc7eb 100644 --- a/wiki/de/de-Compiling.md +++ b/wiki/de/de-Compiling.md @@ -17,7 +17,7 @@ Du musst Jamulus nicht für MacOS kompilieren, da wir offizielle Binärdateien z ### Anforderungen 1. Installiere XCode -1. Installiere QT wie folgt +1. Installiere Qt wie folgt ```shell brew install qt5 @@ -63,12 +63,35 @@ Erstellt die Binärdatei in `./Release/Jamulus.app` ## Windows Du brauchst Jamulus für Windows nicht zu kompilieren, da wir offizielle Binärdateien zur Verfügung stellen. Aber wenn du es aber trotzdem machen willst, folge den unten stehenden Anweisungen. -**benötigte Software**: [QT](https://www.qt.io/download), ein Compiler wie Visual Studio, ASIO Development SDK +### Benötigte Software +* Ein Compiler wie [Visual Studio](https://visualstudio.microsoft.com) (Du brauchst nur [Build Tools 2017 oder 2019](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16), aber du kannst auch die komplette IDE herunterladen und installieren [Visual Studio Download Seite](https://visualstudio.microsoft.com/downloads/)) +* [Qt](https://www.qt.io/download) + * Nutze die kostenlose Open Source Version (Lizenziert unter der GPLv2-Lizenz für Open Source Entwicklung + * Um herauszufinden, welche Qt-Version du brauchst, schau in der [qt-installer-windows.qs](https://github.com/jamulussoftware/jamulus/blob/master/windows/qt-installer-windows.qs) Datei nach: unter INSTALL_COMPONENTS siehst du z.B. `qt.qt5.[version]`, 5123 wäre Version 5.12.3. + * Wähle die Komponenten während der Installation aus: Öffne den Qt-Abschnitt, suche nach der passenden Version, z.B., **Qt 5.12.3**, und wähle die Compiler components für deinen Compiler, z.B., `MSVC 2017 32-bit/64-bit` für Visual Studio 2019, aus +* [ASIO SDK Dateien](https://new.steinberg.net/de/developers/) + + +### Downloade den Jamulus Quellcode +Lade den Quellcode z.B. mit git oder per [zip Download](https://github.com/jamulussoftware/jamulus/archive/master.zip) aus der [Jamulus Repo](https://github.com/jamulussoftware/jamulus) herunter. Stelle sicher, dass **keine** Leerzeichen im Pfad sind, in den du den `jamulus` Ordner verschiebst, da ansonsten der Jamulus Installer nicht korrekt erstellt werden kann. (Wenn du weißt, wie man diesen Fehler einfach lösen kann, schreib einfach im [issue #864](https://github.com/jamulussoftware/jamulus/issues/864) auf der Jamulus Repository). + +### Mit Installer kompilieren + +Die meisten Nutzer werden diese Methode nutzen wollen. + +1. Öffne PowerShell +1. Navigiere in den `jamulus` Ordner +1. Um unsignierte Scripts ausführen zu können, klicke mit der rechten Maustaste auf das `windows\deploy_windows.ps1` Skript, wähle Eigenschaften aus und erlaube dem Script, dass es ausgeführt werden darf. Du kannst auch `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser` in PowerShell ausführen. (Du kannst das nach dem Ausführen des Scripts auch rückgängig machen. Mehr Informationen findest du auf der [Microsoft PowerShell Dokumentationsseite](https://docs.microsoft.com/de-de/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.1)). +1. Setze die $QtCompile32 und $QtCompile64 Variablen. +1. Führe das Script in PowerShell aus `.\windows\deploy_windows.ps1 C:\Qt\QtVersion`. +1. Jetzt kannst du den Jamulus-Installer im `.\deploy` Ordner finden. + +### Nur kompilieren + +1. Erstelle einen Ordner im `\windows` Ordner mit dem Namen ASIOSDK2. +1. Lade die [ASIOSDK](https://www.steinberg.net/asiosdk) herunter, öffne den Ordner auf der ersten Ebene in der .zip Datei und kopiere den Inhalt nach `[\pfad\zum\jamulus\code]\windows\ASIOSDK2`, sodass z.B. `[\pfad\zum\jamulus\code]\windows\ASIOSDK2\common` existiert. +1. Öffne Jamulus.pro im Qt Creator, konfiguriere das Projekt mit dem Default kit, dann klicke auf Compile & run -- Lade den Jamulus-Quellcode z.B. per git oder per Zip-Download aus dem Jamulus Repo herunter -- Downloade und kopiere die Dateien der [ASIOSDK](https://www.steinberg.net/de/company/developer.html) in ein Verzeichnis `[\pfad\zum\jamulus\quellcode]\windows`, damit u.A. das - Verzeichnis `[\pfad\zum\jamulus\quellcode]\windows\ASIOSDK2\common` existiert -- Öffne Jamulus.pro im Qt Creator und kompiliere das Programm ## Allgemeine Anmerkungen diff --git a/wiki/de/de-Contribution.md b/wiki/de/de-Contribution.md index 93dbe8c1e..eb185fc85 100644 --- a/wiki/de/de-Contribution.md +++ b/wiki/de/de-Contribution.md @@ -8,16 +8,29 @@ permalink: "/wiki/Contribution" # Bei Jamulus mithelfen ## Jamulus Software -* Wenn du Code beisteuern willst, poste deine Idee im [developer forum](https://sourceforge.net/p/llcon/discussion/developerforum/)(Englisch), damit wir deine Idee erst diskutieren können. Danach kannst du einen Pull Request eröffnen. Lies dir am Besten erst einmal das [manifesto for contributions](https://github.com/corrados/jamulus/issues/596) von Volker Fischer (Hauptentwickler) durch. +* Wenn du Code beisteuern willst oder einen Feature Request hast, [eröffne ein Issue auf GitHub](https://github.com/jamulussoftware/jamulus/issues/) (bevorzugt) oder [poste deine Idee im Forum](https://github.com/jamulussoftware/jamulus/discussions), damit wir deine Idee erst diskutieren können. Danach kannst du einen Pull Request eröffnen. Lies dir am Besten erst einmal das [manifesto for contributions](https://github.com/jamulussoftware/jamulus/discussions/915) von Volker Fischer (Hauptentwickler) und die [CONTRIBUTING Datei](https://github.com/jamulussoftware/jamulus/blob/master/CONTRIBUTING.md) durch. Mehr (englische) Informationen findest du im [Jamulus GitHub repo](https://github.com/corrados/jamulus). ## Jamulus Website * Wenn du einen Fehler, oder eine veraltete Information (egal in welcher Sprache) findest, bitte öffne einen [GitHub Issue auf Englisch hier](https://github.com/jamulussoftware/jamuluswebsite/issues). -* Wenn dir irgendeine Information fehlt oder ein Eintrag verbessert werden sollte, poste deine Idee (auf Englisch) [im entsprechenden Forum](https://sourceforge.net/p/llcon/discussion/), damit wir es mit dir diskutieren können. +* Wenn dir irgendeine Information fehlt oder ein Eintrag verbessert werden sollte, poste deine Idee (auf Englisch) [im Forum](https://github.com/jamulussoftware/jamulus/discussions), damit wir es mit dir diskutieren können. -Pull Requests für die Website sollten einen Titel, der diesem Schema folgt, haben: +Schau dir die [CONTRIBUTING-Datei](https://github.com/jamulussoftware/jamuluswebsite/blob/changes/CONTRIBUTING.md) für die Website und das [Website GitHub repo](https://github.com/jamulussoftware/jamuluswebsite) für weitere Informationen an. -`[Sprachcode (z.B. de)] {Kurzbeschreibung deiner Änderungen}` -Mehr Infos gibt's im [Website GitHub repo](https://github.com/jamulussoftware/jamuluswebsite). +### Ich kenne GitHub nicht. Was muss ich wissen? + +**Der folgende Inhalt bezieht sich nur auf die Dokumentation auf jamulus.io, nicht auf die Jamulus Software!** + +Wenn du dich mit Pull Requests, Commits, etc. nicht auskennst, eröffne einfach ein „Issue“. Wir werden uns dann um deine Änderungen kümmern. Wenn du die Änderungen selbst durchführen willst und einen Pull Request öffnest, folge dieser Anleitung: + +1. Forke das Repo (es gibt einen Fork-Button oben rechts auf der GitHub-Seite) +2. Entscheide, in welchen Zweig („Branch“) du deine Änderungen commitest, also wo du deine Änderung anwenden willst. (Faustregel: alles, was eventuell übersetzt werden muss, sollte in den `changes` Branch gehen, Tippfehler sollten in den `release` Branch gehen; mehr Informationen findest du in der [CONTRIBUTING Datei](https://github.com/jamulussoftware/jamuluswebsite/blob/changes/CONTRIBUTING.md)). Erstelle auf deinem Fork einen neuen Branch aus dem Branch, den du gewählt hast +3. Verändere was du verändern möchtest +4. Wenn du die Änderungen lokal gemacht hast, pushe den neuen Branch in dein Repository +5. Eröffne einen Pull Request, beschreibe kurz was du geändert hast und verlinke den Issue, das du geöffnet hast +6. Warte auf ein Review und ein Merge + +**Hinweis (für git):** *Merge deine Veränderungen nicht in deinen lokalen `changes` Branch*, sondern halte ihn nur durch einen Pull vom entfernten Jamulus Website Repository synchron. Erstelle einen neuen Branch für deine vorgeschlagenen Änderungen. +Wenn der `changes` Branch geändert wird, bevor du deine Veränderungen einreichst, halte den lokalen `changes` Branch durch Pull vom offiziellen Zweig synchron, führe den lokalen `changes` Zweig in deinen Arbeitszweig zusammen (merge), löse Konflikte auf, pushe deine Änderungen und erstelle den Pull Request. diff --git a/wiki/de/de-Getting-Started.md b/wiki/de/de-Getting-Started.md index d7099661d..88a414539 100644 --- a/wiki/de/de-Getting-Started.md +++ b/wiki/de/de-Getting-Started.md @@ -25,7 +25,7 @@ Obwohl du auch das eingebaute Mikrofon und damit die Soundkarte deines Computers ### 3. Verbinde dich mit Servern mit niedrigem Ping -Der Ping (Zeit, die ein Signal von deinem PC zum Jamulus Server und zurück benötigt) sollte so gering wie möglich sein. Verbinde dich immer mit den Servern mit den niedrigsten Ping-Zeiten. 15ms oder weniger sind perfekt. +Der Ping (Zeit, die ein Signal von deinem PC zum Jamulus Server und zurück benötigt) sollte so gering wie möglich sein. Verbinde dich immer mit den Servern mit den niedrigsten Ping-Zeiten. 15 ms oder weniger sind perfekt. Die wichtigsten Faktoren kennst du jetzt! Los geht's: @@ -33,13 +33,16 @@ Die wichtigsten Faktoren kennst du jetzt! Los geht's: Installation auf Windows Installation auf macOS Installation auf Linux + Installation auf Android (PoC)

[Jamulus OS!](https://sourceforge.net/projects/jamulus-os/files/JamulusOS/){: target="_blank" rel="noopener noreferrer"} Auf fast jedem PC (nur 64-Bit-Systeme) kannst du Jamulus mit einem USB-Stick starten! [Jamulus OS!](https://sourceforge.net/projects/jamulus-os/files/JamulusOS/) prüft deine Hardware automatisch und richtet sie ein. ## Audiohardware -Schau dir die [Liste von getesteter Hardware](Sound-Devices) und das [Hardware Setup](Hardware-Setup) an. +Dein Gerät muss eine Abtastrate (Sample Rate) von **48kHz** (DVD-Qualität) unterstützen. Auch sollte es möglich sein, dass es den Ton deines Computers ausgeben kann. Unter Windows sollte das Gerät einen herstellereigenen [ASIO](https://de.wikipedia.org/wiki/Audio_Stream_Input/Output) Treiber unterstützen. + +Du kannst auch in die [Liste der von der Community getesteten Geräte schauen](/kb/2021/01/05/Jamulus-Sound-Devices.html). ## Weitere Anleitungen @@ -51,7 +54,7 @@ Schau dir die [Liste von getesteter Hardware](Sound-Devices) und das [Hardware S Oder anders ausgedrückt, höre **nicht** auf dein direktes Signal. -Auch wenn du eine gute Internetverbindung hast, ist es besser (um den Rhythmus halten zu können), wenn du dich auf das Signal vom Server und nicht auf dein Livesignal konzentrierst. _(Um Zweifel auszuschließen: das hat nichts mit den „Mute“-Reglern in Jamulus zu tun.)_ +Auch wenn du eine gute Internetverbindung hast, ist es besser (um den Rhythmus halten zu können), wenn du dich auf das Signal vom Server und nicht auf dein Live-Signal konzentrierst. _(Um Zweifel auszuschließen: das hat nichts mit den „Mute“-Reglern in Jamulus zu tun.)_ Weitere Informationen darüber, wie du vermeiden kannst, auf dich selbst zu hören (und Hilfe bei anderen Problemen), findest du auf der [Fehlerbehebung FAQ](Client-Troubleshooting) Seite. (_momentan in Arbeit_) @@ -60,8 +63,8 @@ Weitere Informationen darüber, wie du vermeiden kannst, auf dich selbst zu hör **Millionen von Menschen benutzen Jamulus um mit anderen Menschen auf der ganzen Welt in Echtzeit zu spielen, zu singen und Musik zu unterrichten. Das funktioniert ganz einfach:** ![Overview](https://user-images.githubusercontent.com/4561747/79309764-bd387280-7ef2-11ea-9d81-1e81302525e6.png) -_Jamulus arbeitet nach dem Client-Server-Prinzip. Das Audiosignal von allen Musikern wird an einen Server geschickt, dort gemischt und verarbeitet. Danach wird das Audio an jeden Client gesendet. Wenn ein Server öffentlich gemacht und auf einem zentralen Server registriert wird, werden seine Informationen an alle Clients gesendet._ +_Jamulus arbeitet nach dem Client-Server Prinzip. Das Audiosignal von allen Musikern wird an einen Server geschickt, dort gemischt und verarbeitet. Danach wird das Audiosignal an jeden Client gesendet. Wenn ein Server öffentlich gemacht und auf einem zentralen Server registriert wird, werden seine Informationen an alle Clients gesendet._ ## Fußnoten -[^1]: Empfohlen werden mindestens 10MBit/s Download und 1MBit/s Upload ([vollständige Details hier](Network-Requirements){: target="_blank" rel="noopener noreferrer"}). Wenn du keine LAN Buchse mehr an deinem Laptop hast, kannst du einen USB zu LAN-Adapter versuchen. -[^2]: Die Zeitverzögerung von Bluetooth-Kopfhörern ist normalerweise zu hoch. Deshalb solltest du einen kabelgebundenen Kopfhörer nutzen. Besonders beim Singen oder Spielen akustischer Instrumente sind Kopfhörer auch eine gute Hilfe um sicherzustellen, dass du mit anderen im Takt bleibst (siehe [diesen Hinweis](Getting-Started#schwierigkeiten-probleme-kannst-du-den-rhythmus-nicht-einhalten)). +[^1]: Empfohlen werden mindestens 10 Mbit/s Download und 1 Mbit/s Upload ([vollständige Details hier](Network-Requirements){: target="_blank" rel="noopener noreferrer"}). Wenn du keine LAN Buchse mehr an deinem Laptop hast, kannst du einen USB zu LAN-Adapter versuchen. +[^2]: Die Zeitverzögerung von Bluetooth Kopfhörern ist normalerweise zu hoch. Deshalb solltest du einen kabelgebundenen Kopfhörer nutzen. Besonders beim Singen oder Spielen akustischer Instrumente sind Kopfhörer auch eine gute Hilfe um sicherzustellen, dass du mit anderen im Takt bleibst (siehe [diesen Hinweis](Getting-Started#schwierigkeiten-probleme-kannst-du-den-rhythmus-nicht-einhalten)). diff --git a/wiki/de/de-Installation-for-Android.md b/wiki/de/de-Installation-for-Android.md new file mode 100644 index 000000000..5f4b546d4 --- /dev/null +++ b/wiki/de/de-Installation-for-Android.md @@ -0,0 +1,33 @@ +--- +layout: wiki +title: "Installation auf Android" +lang: "de" +permalink: "/wiki/Installation-for-Android" +--- + +# Installation for Android + +Wenn du die [Erste Schritte](Getting-Started) Seite noch nicht gelesen hast, solltest du das nachholen. + +## Was du über Android wissen solltest + +Obwohl du Jamulus auf Android Geräten installieren kannst (und du eventuell Ton hören kannst), raten wir davon ab. Die Tonqualität v.A. über WLAN ist schlecht und die Latenz hoch. Wenn du keinen PC hast, kannst du z.B. einen [Raspberry Pi](https://www.raspberrypi.org/){: target="_blank" rel="noopener noreferrer" } kaufen. Das ist ein günstiger, kleiner Computer, auf dem Jamulus sehr gut läuft. Android Support ist nur ein Proof of Concept! + +## Installation des Android PoC + +Wenn du Jamulus für Android wirklich testen möchtest: + +1. Erlaube die Installation von Apps aus unbekannten Quellen (z.B. unter Einstellungen>Sicherheit. Achtung: wie das funktioniert, hängt von deinem Gerät und der Android Version ab.) +1. [Downloade und installiere Jamulus]({{ site.download_root_link }}{{ site.download_file_names.android }}){: .button} +1. Jetzt solltest du Jamulus auf deinem Android Gerät starten können. + +## Feedback und Entwicklung + +Wir freuen uns über jedes Feedback von Android Nutzern und Entwicklern. Schau einfach im [Jamulus GitHub Repo](https://github.com/jamulussoftware/jamulus/). + +*** + +## Alles installiert? +Jamulus wurde installiert und kann jetzt benutzt werden. Wenn du willst, kannst du jetzt auf die folgende Seite gehen: + +[Nach der Installation](Onboarding){: .button} diff --git a/wiki/de/de-Installation-for-Linux.md b/wiki/de/de-Installation-for-Linux.md index 9ef5a8b45..728d2d06c 100644 --- a/wiki/de/de-Installation-for-Linux.md +++ b/wiki/de/de-Installation-for-Linux.md @@ -4,22 +4,43 @@ title: "Installation auf Linux" lang: "de" permalink: "/wiki/Installation-for-Linux" --- +{% include breadcrumb.html root="Jamulus nutzen" branch1="Erste Schritte" branch1-url="Getting-Started" %} # Installation auf Linux Wenn du die [Erste Schritte](Getting-Started) Seite noch nicht gelesen hast, solltest du das nachholen. -Obwohl wir momentan keine offiziellen Pakete anbieten, könnte es sein, dass du Jamulus über den Paketmanager deiner Distribution installieren kannst. +Obwohl wir momentan keine offiziellen Pakete für jede Linux Distribution anbieten, könnte es sein, dass du Jamulus über den Paketmanager deiner Distribution installieren kannst. Schau einfach in dieser Tabelle nach: [![Packaging status](https://repology.org/badge/vertical-allrepos/jamulus.svg)](https://repology.org/project/jamulus/versions) -Eine Liste inoffizieller [Pakete für verschiedene Distributionen findest du hier](https://github.com/corrados/jamulus/issues/223#issue-619038918){: target="_blank" rel="noopener noreferrer"}. Wenn du Jamulus nicht in den Paketquellen deiner Distro finden kannst, musst du Jamulus kompillieren. Das ist nicht schwer: +Eine Liste inoffizieller [Pakete für verschiedene Distributionen findest du hier](https://github.com/jamulussoftware/jamulus/discussions/914). + +### Flatpak + +Jamulus existiert als [Flatpak](https://flatpak.org/) auf [Flathub here](https://flathub.org/apps/details/io.jamulus.Jamulus). Um das Jamulus Flatpak zu nutzen musst du pipewire konfigurieren. + +### Debian and Ubuntu +Jamulus kann aus den [buster-backports](https://packages.debian.org/de/buster-backports/jamulus) oder - wenn du amd64 **Debian**/**Ubuntu** installiert hast - als .deb Datei installiert werden: + +1. Downloade die [neuste .deb Datei]({{ site.download_root_link }}{{ site.download_file_names.deb-gui }}) +1. Update apt: `sudo apt-get update` +1. Installiere das Paket: `sudo apt install /path/to/{{ site.download_file_names.deb-gui }}`. +1. Da Jamulus den JACK Server benötigt, musst du ihn auch installieren. Wir empfehlen, dass du `QjackCtl` zur Konfiguration von JACK benutzt. Installiere das Programm mit `sudo apt-get install qjackctl` + +Jetzt kannst du dir die Sektion "[Richte deine Soundkarte ein](#richte-deine-soundkarte-ein)" ansehen. + +**Beachte:** Dank [mirabilos](https://github.com/mirabilos) ist Jamulus (mit GUI) in den [Debian Bullseye (testing)](https://packages.debian.org/bullseye/jamulus) Paketquellen. Wenn du schon Bullseye nutzt, kannst du Jamulus via `sudo apt-get install jamulus` installieren. + +--- + +Wenn du Jamulus nicht in den Paketquellen deiner Distro finden kannst, musst du Jamulus kompillieren. Das ist nicht schwer: ## Jamulus Sourcecode herunterladen 1. Öffne ein Terminalfenster (Kommandozeile: `Strg+Alt+T` auf Ubuntu und verwandten Distributionen) 1. Lade den Sourcecode für die neueste Version herunter und entpacke diesen: ```shell -wget https://github.com/corrados/jamulus/archive/latest.tar.gz +wget https://github.com/jamulussoftware/jamulus/archive/latest.tar.gz tar -xvf latest.tar.gz ``` @@ -64,29 +85,28 @@ make clean make sudo make install ``` +**Beachte**: Die kompilierte Version von Jamulus wird nach `/usr/local/bin` kopiert. + +Du kannst jetzt den Quellcode-Ordner löschen. ## Richte deine Soundkarte ein ### Konfiguriere Jack mit QjackCtl -Jamulus Clients brauchen [JACK](https://jackaudio.org/){: target="_blank" rel="noopener noreferrer"}. Du musst JACK aber zuerst einrichten. Am Besten machst du das mit `QjackCtl`. +Jamulus Clients brauchen [JACK](https://jackaudio.org/). Du musst JACK aber zuerst einrichten. Am Besten machst du das mit `QjackCtl`. 1. Öffne die Kommandozeile z.B. mit STRG-ALT-T 1. Führe `qjackctl` aus und warte, bis sich das **Jack Audio Connection Kit** öffnet. -2. Konfiguriere dein Audiointerface wie folgt (die genauen Einstellungen für Jack hängen von den Funktionen deiner Soundkarte ab): +2. Konfiguriere dein Audiointerface wie folgt (die genauen Einstellungen für JACK hängen von den Funktionen deiner Soundkarte ab): - Wähle dein Audio **Interface** aus (es können mehrere in der Liste sichtbar sein) - Setzte die **Sample Rate auf 48000** - Setze die **Frames/Period Einstellung erst einmal auf 128** und Periods/Buffer zunächst auf 2 -Starte Jack neu, um alle neuen Einstellungen zu übernehmen. +Starte JACK neu, um alle neuen Einstellungen zu übernehmen. ### Jamulus starten -1. Öffne Jamulus z.B. mit der Kommandozeile. Wenn du sie benutzt, führe den Befehl `Jamulus` (mit einem großen 'J') aus, um den Jamulus Client zu starten +Öffne Jamulus z.B. mit der Kommandozeile. Wenn du sie benutzt, führe den Befehl `jamulus`, oder wenn du Jamulus selbst kompiliert hast `Jamulus` (mit einem großen 'J') aus, um den Jamulus Client zu starten -Jamulus installiert sich nach `/usr/local/bin`. - -Du kannst das Sourcecodeverzeichnis, in dem du kompiliert hast, jetzt löschen. - -Wenn du Soundprobleme (kurze Unterbrechungen (Dropouts) o.Ä.) hast (insbesondere XRUNs, die von Jack/QJackCtl gemeldet werden), versuche größere Werte (z.B. 256 frames oder 3 periods) in Schritt 3 von oben zu setzen. Niedrigere Einstellungen (z.B. 64 frames) bieten zwar eine geringere Latenz, aber möglicherweise mehr Soundprobleme. +Wenn du Soundprobleme (kurze Unterbrechungen (Dropouts) o.Ä.) hast (insbesondere XRUNs, die von Jack/QjackCtl gemeldet werden), versuche größere Werte (z.B. 256 Frames oder 3 Perioden) zu setzen. Niedrigere Einstellungen (z.B. 64 Frames) bieten zwar eine geringere Latenz, aber möglicherweise mehr Soundprobleme. Siehe auch die [Fehlerbehebungsseite](Client-Troubleshooting). ## Alles installiert? @@ -94,11 +114,9 @@ Jamulus wurde installiert und kann jetzt benutzt werden. Wenn du willst, kannst [Nach der Installation](Onboarding){: .button} -Ausführliche Informationen zur Benutzung von Jamulus findest du im [Jamulus Help Manual](https://github.com/corrados/jamulus/blob/master/src/res/homepage/manual.md). - -## Um deine Installation auf eine neue Version zu aktualisieren +## Installation auf eine neue Version zu aktualisieren -Lade die neuen Quellen gemäß [Jamulus Sourcecode herunterladen](Installation-for-Linux#jamulus-sourcecode-herunterladen) herunter und wiederhole nur die [Kompilierungsanleitung](Installation-for-Linux#kompiliere-jamulus) wie für eine neue Installation von oben. +Lade die neuen Quellen gemäß [Jamulus Sourcecode herunterladen](Installation-for-Linux#jamulus-sourcecode-herunterladen) herunter und wiederhole nur die [Kompilierungsanleitung](Installation-for-Linux#kompiliere-jamulus) wie für eine neue Installation von oben oder nutze ein neues .deb Paket, wenn du das genutzt hast. ## Hinweise für Geeks @@ -108,6 +126,6 @@ Lade die neuen Quellen gemäß [Jamulus Sourcecode herunterladen](Installation-f * Um diese Datei zu benutzen, konfiguriere die Software mit `qmake "CONFIG+=noupcasename" Jamulus.pro`, um sicherzustellen, dass der Ausgabezielname dieser Software **j**amulus statt **J**amulus ist. -* Benutzer vom Raspberry Pi: Vielleicht möchtest du den Client auf einer anderen Maschine kompilieren und die Binärdatei auf einem anderen Raspberry Pi laufen lassen. In diesem Fall brauchst du nur die Bibliotheken für einen [headless server](Server-Linux#running-a-headless-server), aber _mit_ den Jack-Sound-Paketen. Schaut dir insbesondere die Fußnote für den headless-Build an. +* Benutzer vom Raspberry Pi: Vielleicht möchtest du den Client auf einer anderen Maschine kompilieren und die Binärdatei auf einem anderen Raspberry Pi laufen lassen. In diesem Fall brauchst du nur die Bibliotheken für einen [headless server](Server-Linux#running-a-headless-server), aber _mit_ den JACK-Sound-Paketen. Schaut dir insbesondere die Fußnote für den headless-Build an. * Ab Version 3.5.3 ist Jamulus nicht mehr mit Qt4 kompatibel. diff --git a/wiki/de/de-Installation-for-Macintosh.md b/wiki/de/de-Installation-for-Macintosh.md index 4ba512664..34b0a7489 100644 --- a/wiki/de/de-Installation-for-Macintosh.md +++ b/wiki/de/de-Installation-for-Macintosh.md @@ -5,18 +5,19 @@ lang: "de" permalink: "/wiki/Installation-for-Macintosh" --- +{% include breadcrumb.html root="Jamulus Nutzen" branch1="Erste Schritte" branch1-url="Getting-Started" %} + # Installation auf macOS Wenn du die [Erste Schritte](Getting-Started) Seite noch nicht gelesen hast, solltest du das nachholen. -1. [Downloade Jamulus](https://sourceforge.net/projects/llcon/files/latest/download){: target="_blank" rel="noopener noreferrer" .button} -1. Wenn du eine zip Datei heruntergeladen hast (nur selten der Fall): **Entpacke die heruntergeladene .zip Datei.** Doppelklicke die .zip Datei. Ein neuer Ordner mit dem selben Namen wird erstellt. Dieser Ordner enthält die Lizenz und eine `.dmg` Datei, die Jamulus enthält. -1. **Doppelklicke auf die `.dmg` Datei** um sie zu öffnen und stimme der Lizenz zu. Nach kurzer Zeit solltest du zwei Icons in einem Fenster sehen (Jamulus client und server) -1. **Klicke und ziehe (drag and drop) beide Icons in den Programme (Applications) Ordner** um Jamulus zu installieren. +1. [Downloade Jamulus]({{ site.download_root_link }}{{ site.download_file_names.mac }}){: .button}\\ +**Alternativ-Download:** [SourceForge](https://sourceforge.net/projects/llcon/files/latest/download) +1. **Installiere Jamulus**: Öffne die `.dmg` Datei, stimme der Lizenz zu, klicke und ziehe (drag and drop) beide Icons in den Programme (Applications) Ordner. Danach kannst du das Fenster schließen. 1. **Starte Jamulus**. Jamulus kann jetzt wie jede andere App gestartet werden. Wenn du eine Meldung, die besagt, dass Jamulus nicht geöffnet werden kann, da der Entwickler nicht überprüft werden kann, erscheint, lese den nächsten Abschnitt. _Du kannst den Ordner, der die .dmg Datei enthält im Downloads löschen und den virtuellen "Jamulus" Datenträger auf deinem Schreibtisch auswerfen. Beides wird nicht mehr gebraucht._ -Du kannst Jamulus auch selbst [kompilieren](Compiling), wenn du das willst. +*** ## Jamulus kann nicht geöffnet werden, da es von einem nicht verifizierten Entwickler stammt @@ -24,10 +25,13 @@ Du kannst Jamulus auch selbst [kompilieren](Compiling), wenn du das willst. Wenn du Jamulus zum ersten Mal öffnen willst, wirst du wahrscheinlich eine Meldung sehen, dass Jamulus nicht geöffnet werden kann, da der Entwickler unbekannt sei. Das liegt daran, dass wir momentan Jamulus nicht signieren (das kostet eine Stange Geld). -Um Jamulus trotzdem öffnen zu können, navigiere mit dem Finder in den Programme (Applications) Ordner, Doppelklicke auf Jamulus, warte die Meldung ab, klicke mit gedrückter ctrl/strg Taste (oder einem Rechtsklick) auf Jamulus und wähle dann „Öffnen“ oben im Menü aus. +Um Jamulus trotzdem öffnen zu können +1. Navigiere mit dem Finder in den Programme (Applications) Ordner +1. Doppelklicke auf Jamulus und warte die Meldung ab +1. Klicke mit gedrückter Ctrl/Strg-Taste (oder einem Rechtsklick) auf Jamulus und wähle dann „Öffnen“ oben im Menü aus. Jetzt siehst du eine leicht veränderte Version der gleichen Meldung, die jetzt durch einen Klick auf „Öffnen“ Jamulus öffnen kann. Diese Warnung wird nur einmal angezeigt – Danach kann Jamulus ganz normal z.B. über das Launchpad geöffnet werden. -Für weitere Informationen über diese Meldung siehe [diese Apple Support-Seite](https://support.apple.com/de-de/guide/mac-help/mh40616/mac){: target="_blank" rel="noopener noreferrer"}. +Für weitere Informationen über diese Meldung siehe [diese Apple Support-Seite](https://support.apple.com/de-de/guide/mac-help/mh40616/mac). ## Alles installiert? Jamulus wurde installiert und kann jetzt benutzt werden. Wenn du willst, kannst du jetzt auf die folgende Seite gehen: diff --git a/wiki/de/de-Installation-for-Windows.md b/wiki/de/de-Installation-for-Windows.md index 75528d78c..4704ba05d 100644 --- a/wiki/de/de-Installation-for-Windows.md +++ b/wiki/de/de-Installation-for-Windows.md @@ -5,48 +5,68 @@ lang: "de" permalink: "/wiki/Installation-for-Windows" --- +{% include breadcrumb.html root="Jamulus Nutzen" branch1="Erste Schritte" branch1-url="Getting-Started" %} + # Installation auf Windows Wenn du die [Erste Schritte](Getting-Started) Seite noch nicht gelesen hast, solltest du das nachholen. -1. **Downloade und installiere einen ASIO-Treiber**. Wir empfehlen, eine Soundkarte/Interface mit einem nativen, herstellereigenen ASIO-Treiber zu verwenden. Wenn kein nativer ASIO-Treiber vorhanden ist (v.A. bei integrierten Soundkarten), installiere [ASIO4ALL](http://www.asio4all.org){: target="_blank" rel="noopener noreferrer"} vor der Installation von Jamulus. -1. [Downloade und installiere Jamulus](https://sourceforge.net/projects/llcon/files/latest/download){: target="_blank" rel="noopener noreferrer"}. Wenn du eine Warnung bekommst, klicke auf „Mehr Infos“ und „Trotzdem ausführen“, um Jamulus zu installieren. Du siehst diese Meldung, da wir momentan nicht für ein Software Zertifikat für Jamulus zahlen. -1. Starte Jamulus. Jetzt kannst du Jamulus wie jedes andere Programm öffnen. -1. **Richte deine Soundkarte ein**. Wenn du Jamulus installiert hast, musst du deine Audio-Hardware einrichten. Wenn du ASIO4All nutzt, schau dir die [Einrichtung](#asio4all-einrichten) an (scrolle etwas nach unten) sonst kannst du gleich deine Audio-Hardware einrichten. Siehe [Hardware-Setup](Hardware-Setup). - -Wenn du willst, kannst du Jamulus auch selbst [kompilieren](Compiling). +1. **Downloade und installiere einen ASIO-Treiber**. Wir empfehlen, eine Soundkarte/Interface mit einem nativen, herstellereigenen ASIO-Treiber zu verwenden. Wenn kein nativer ASIO-Treiber vorhanden ist (v.A. bei integrierten Soundkarten), brauchst du einen generischen Treiber wie ASIO4ALL. Mehr Informationen findest du im [ASIO](#asio) Abschnitt unten auf dieser Seite. +1. [Downloade Jamulus]({{ site.download_root_link }}{{ site.download_file_names.windows }}){: .button}\\ +**Alternativ-Download:** [SourceForge](https://sourceforge.net/projects/llcon/files/latest/download) +1. **Installiere Jamulus**: Doppelklicke auf Installer, um die Installation zu starten. Wenn du eine Warnung von SmartScreen bekommst, klicke auf „Mehr Infos“ und „Trotzdem ausführen“, um Jamulus zu installieren. (Wenn du eine neue Version von Jamulus heruntergeladen hast und auch einer der Ersten warst, wird Jamulus noch nicht auf der SmartScreen-Whitelist sein. Du erhältst diese Meldung, da wir momentan nicht für ein Software Zertifikat für Jamulus zahlen.) +1. **Starte Jamulus.** Jetzt kannst du Jamulus wie jedes andere Programm öffnen. +1. **Richte deine Soundkarte ein**. Wenn du Jamulus installiert hast, musst du deine Audio-Hardware einrichten. Falls du ASIO4ALL nutzt, schau dir die [Einrichtung](#asio4all-einrichten) und/oder das [Hardware-Setup](Hardware-Setup) an. *** +## ASIO + +Jamulus nutzt [ASIO](https://de.wikipedia.org/wiki/Audio_Stream_Input/Output), um eine geringe Audioverzögerung zu ermöglichen. + +* Wenn du eine externe Soundkarte/Interface besitzt, nutze den offiziellen ASIO-Treiber (normalerweise bieten sie die beste Qualität). +* Wenn du keine externe Soundkarte besitzt, wirst du wahrscheinlich keinen ASIO-Treiber haben. Deshalb musst du einen generischen Treiber, wie ASIO4ALL nutzen: + +Du kannst zwei Versionen von ASIO4ALL testen. ASIO4ALL v2.14 nutzt einen Workaround für einen Bug, der eventuell Probleme mit anderen Funktionen auslöst. + +[ASIO4ALL v2.14 Download](https://github.com/jamulussoftware/assets/raw/main/ASIO4ALL/v2.14/ASIO4ALL_2_14_English.exe){: .button target="_blank" rel="noopener noreferrer"} + +[ASIO4ALL v2.13 Download](https://github.com/jamulussoftware/assets/raw/main/ASIO4ALL/v2.13/ASIO4ALL_2_13_English.exe){: .button target="_blank" rel="noopener noreferrer"} + +[ASIO4ALL Website](https://www.asio4all.org/){: target="_blank" rel="noopener noreferrer"} + +## ASIO4ALL einrichten +*Du solltest ASIO4ALL nur dann nutzen, wenn deine Soundkarte keinen nativen, vom Hersteller der Soundkarte entwickelten ASIO-Treiber anbietet, da native ASIO-Treiber eine bessere Latenz haben könnten.* -## ASIO4All einrichten -*Fast alle integrierten Soundkarten benötigen diesen Treiber. Du solltest ASIO4All nur dann nutzen, wenn deine Soundkarte keinen nativen, vom Hersteller der Soundkarte entwickelten ASIO Treiber anbietet, da native ASIO Treiber eine bessere Latenz haben könnten.* +Wenn du ASIO4ALL nutzt, musst du möglicherweise ein bisschen herumprobieren, da jeder PC immer etwas anders ist. -Wenn du ASIO4All nutzt, musst du möglicherweise ein bisschen herumprobieren, bis du deine individuell richtige Konfiguration eingestellt hast. Jeder PC ist etwas anders. Am Besten verbindest du dich mit einem Server und richtest dann gleichzeitig ASIO4All ein. Das erleichtert dir das Setup, da du dann mit deinem Instrument oder deiner Stimme testen kannst, ob alles richtig eingestellt ist. +**Tipp:** Richte deine Soundkarte ein, wenn du [mit einem Server verbunden](Onboarding#2-verbindung-mit-einem-server-herstellen) bist. Das erleichtert dir das Setup, da du dann mit deinem Instrument oder deiner Stimme testen kannst, ob alles richtig eingestellt ist; aber lies erst einmal weiter. -Bevor du Jamulus startest solltest du: +Bevor du Jamulus startest: -1. **Alle anderen Programme schließen** (besonders die, die (wie z.B. dein Browser/Media Player) auf deine Soundkarte zugreifen könnten), weil Jamulus exklusiven Zugriff auf die Soundkarte benötigt -1. Sicherstellen, dass nur die **richtigen Ein-/Ausgänge** in ASIO4All **aktiv sind**. Alle anderen sollten ausgeschaltet sein. Wie das geht, siehst du hier: +1. **Schließe alle anderen Programme** (besonders die, die (wie z.B. dein Browser/Media Player) auf deine Soundkarte zugreifen könnten), weil Jamulus exklusiven Zugriff auf die Soundkarte benötigt. Andere Programme werden keinen Ton ausgeben/aufnehmen können, wenn Jamulus mit ASIO4ALL läuft. +1. Wenn das Audio nicht sofort funktioniert, stelle sicher, dass die **richtigen Ein-/Ausgänge** in ASIO4ALL **aktiv sind**. Alle anderen sollten ausgeschaltet sein. Wie das geht, siehst du hier: -### ASIO4All Ein/Ausgänge einrichten (Anleitung) +### ASIO4ALL Ein/Ausgänge einrichten (Anleitung) 1. Jamulus Einstellungen öffnen (linke Spalte in Jamulus) -1. Klick auf _„ASIO-Einstellungen“_ +1. Klick auf _„ASIO Geräte Einstellungen“_ 1. Aktiviere die _erweiterte Ansicht_ in ASIO4ALL (klicke auf das Werkzeug-Icon unten rechts) 1. Aktiviere nur die Soundkarte, die du nutzen willst, indem du auf den Knopf direkt neben dem Namen der Soundkarte klickst -1. Öffne deine Soundkarte, um die Ein/Ausgänge anzuzeigen -1. Aktiviere die richtigen Ein/Ausgänge in der Liste unter deiner Soundkarte und deaktiviere alle anderen Ein/Ausgänge +1. Öffne deine Soundkarte über das Plus-Icon neben der Soundkarte, um die Ein/Ausgänge anzuzeigen +1. Aktiviere die richtigen Ein/Ausgänge in der Liste unter deiner Soundkarte und deaktiviere alle anderen Ein/Ausgänge. Du kannst über den Ein/Ausgängen hovern (mit dem Mauszeiger auf über dem Ein/Ausgang ruhen) ob sie die richtige Sample Rate für Jamulus unterstützen (48kHz; DVD-Qualität) -**Tipp:** Viele interne Soundkarten heißen Realtek High Definition Audio, Conexant oder ähnlich. +**Tipps:** +1. Viele interne Soundkarten heißen Realtek High Definition Audio, Conexant oder ähnlich. +1. Kopfhörer und Lautsprecher werden oft als „Output“ und Mikrofone als „Input“ oder „Capture“ bezeichnet. +1. Stereo Mix ist normalerweise nicht der Ein-/Ausgang, den du brauchst. Wenn du diesen Ein-/Ausgang siehst, solltest du ihn ausschalten. -Bezüglich der Ein/Ausgänge: Kopfhörer und Lautsprecher werden oft als „Output“ und Mikrofone als „Input“ oder „Capture“ bezeichnet. Stereo Mix ist normalerweise nicht der Ein/Ausgang, den du brauchst, deshalb – wenn du diesen Ein/Ausgang siehst – solltest du ihn ausschalten. +### Probleme mit dem ASIO4ALL Setup? -### Probleme mit dem ASIO4All Setup? +Wenn Nichts zu funktionieren scheint, versuche zuerst Jamulus und/oder deinen PC **neuzustarten**, damit Hintergrundprozesse, die auf die Soundkarte zugreifen könnten, geschlossen werden. -Wenn Nichts zu funktionieren scheint, versuche zuerst Jamulus und/oder deinen PC **neuzustarten**. Danach versuche **die Ein-/Ausgänge nochmal neu einzurichten**. Aktivierte und zugängliche Ein-/Ausgänge zeigen ein leuchtendes An/Aus- und ein Play-Symbol. Wenn du ein rotes Kreuz oder ein gelbes Symbol siehst, musst du eventuell andere Anwendungen, wie deinen Browser, Zoom, ... schließen oder deinen PC neu starten. -Wirf einen Blick auf [dieses Video](https://youtu.be/_GzOsitVgLI){: target="_blank" rel="noopener noreferrer"} von @trombonepizza, das ausführlichere Informationen zur Einrichtung von ASIO4All gibt (English). +Wirf einen Blick auf [dieses Video](https://youtu.be/_GzOsitVgLI){: target="_blank" rel="noopener noreferrer"} von [trombonepizza](https://github.com/trombonepizza), das ausführlichere Informationen zur Einrichtung von ASIO4ALL gibt (English). -Offizielle und ausführliche Infos zur Konfiguration von ASIO4All sind auch in den [FAQs auf der ASIO4All Website](http://www.asio4all.org/faq.html){: target="_blank" rel="noopener noreferrer"}, sowie im ASIO4ALL Handbuch dokumentiert. Diese findest du höchstwahrscheinlich auf deinem Desktop oder in dem Ordner, in dem das ASIO4ALL-Binary installiert ist (normalerweise `C:\Program Files (x86)\ASIO4ALL v2\`). +Offizielle und ausführliche Infos zur Konfiguration von ASIO4ALL sind auch in den [FAQs auf der ASIO4ALL Website](https://www.asio4all.org/index.php/help/faq/){: target="_blank" rel="noopener noreferrer"}, sowie im ASIO4ALL Handbuch dokumentiert. Diese findest du höchstwahrscheinlich auf deinem Desktop oder in dem Ordner, in dem das ASIO4ALL-Binary installiert ist (normalerweise `C:\Program Files (x86)\ASIO4ALL v2\`). ## Alles installiert? Jamulus wurde installiert und kann jetzt benutzt werden. Wenn du willst, kannst du jetzt auf die folgende Seite gehen: diff --git a/wiki/de/de-Onboarding.md b/wiki/de/de-Onboarding.md index 9411f9ec9..a9b524829 100644 --- a/wiki/de/de-Onboarding.md +++ b/wiki/de/de-Onboarding.md @@ -5,7 +5,7 @@ lang: "de" permalink: "/wiki/Onboarding" --- # Nach der Installation -Schauen wir uns mal an, wie Jamulus aussieht und was du nach der Installation tun solltest. +Schauen wir uns mal an, was du nach der Installation tun solltest. ## Erster Start Bevor du Jamulus startest, solltest du: 1. Erst einmal **alle anderen Programme schließen**. Es ist besser „von Null“ zu starten. @@ -13,7 +13,15 @@ Bevor du Jamulus startest, solltest du: ... damit dein Computer *so wenig, wie möglich zu tun hat* und damit *kein anderes Programm* versucht auf deine Soundkarte zuzugreifen. -Du kannst dir das [Hardware Setup](Hardware-Setup) anschauen, um mehr über die Einrichtung deiner Audiohardware zu erfahren. Wenn du Hilfe mit dem Setup von ASIO4All auf Windows brauchst, schau dir die [ASIO4All Einrichtung auf der Installationsseite für Windows](Installation-for-Windows#asio4all-einrichten) an. + +## Audio einrichten + +Wenn du dein Audio noch nicht eingerichtet hast, stecke deine Hardware in deinen PC (wenn nötig), öffne die Einstellungen und wähle das Ein/Ausgangsgerät aus. + +* Wenn du Hilfe mit dem Setup von ASIO4ALL auf Windows brauchst, schau dir die [ASIO4ALL Einrichtung auf der Installationsseite für Windows](Installation-for-Windows#asio4all-einrichten) an. +* macOS Nutzer müssen nur ihre Ein-/Ausgänge in den Jamulus Einstellungen auswählen + +Du kannst dir das [Hardware Setup](Hardware-Setup) anschauen, um mehr über die Einrichtung deiner Audiohardware zu erfahren. ### Jamulus Hauptansicht Sobald du Jamulus öffnest, wirst du ein Fenster, das in etwa wie folgt aussieht, sehen: @@ -29,7 +37,11 @@ Jetzt wird sich ein Fenster öffnen, das so aussieht: Trage zumindest deinen Namen bzw. Alias im Feld „Alias/Name“ ein. Dann kannst du das Fenster schließen. ### 2. Verbindung mit einem Server herstellen -Jetzt kann's losgehen. Klicke auf den „Verbinden“ Knopf in der Jamulus Hauptansicht um dich mit einem Server zu verbinden. In dem sich nun öffnenden Fenster kannst du Server, die *nach ihrem Genre sortiert* sind, sehen. Um von einem Genre zu einem anderen zu wechseln, wähle eine andere Liste in der oberen linken Ecke aus. Nachdem du das Genre und einen Server ausgewählt hast, kannst du dich mit einem Server verbinden, indem du ihn auswählst und auf den „Verbinden“ Knopf klickst. Solltest du hier Probleme haben, liegt das sehr wahrscheinlich entweder daran, dass du deine Audiohardware falsch eingerichtet hast oder an Problemen mit deiner Internetverbindung. Vielleicht findest du Hilfe auf der [Troubleshooting Seite](Client-Troubleshooting). +Klicke auf den „Verbinden“ Knopf in der Jamulus Hauptansicht, um dich mit einem Server zu verbinden. Du wirst dieses Fenster sehen: + +![Connection Setup](https://user-images.githubusercontent.com/20726856/102825226-a1b92c00-43de-11eb-9aa9-21d7a8576f5c.png) + +Das Fenster zeigt Server, die *nach ihrem Genre sortiert* sind. Um von einem Genre zu einem anderen zu wechseln, wähle eine andere Liste in der oberen linken Ecke aus. Nachdem du das Genre und einen Server ausgewählt hast, verbinde dich mit einem Server, indem du ihn auswählst und auf den „Verbinden“ Knopf klickst. Solltest du hier Probleme haben, liegt das sehr wahrscheinlich entweder daran, dass du deine Audiohardware falsch eingerichtet hast oder es Probleme mit deiner Internetverbindung gibt. Vielleicht findest du Hilfe auf der [Troubleshooting Seite](Client-Troubleshooting). ### Der erste Jam Gratulation! Du kannst jetzt mit Jamulus jammen. Die Lautstärkenregler, die du rechts sehen kannst, sind dein persönlicher Mix. Alles was du hier veränderst, wird das, was du hörst verändern, aber keinen Einfluss auf andere haben. Wenn du einen Regler nach unten bewegst, wird diese Person leiser, wenn du ihn nach oben bewegst, wird die Person lauter. @@ -42,15 +54,15 @@ Der Knopf „Einstellungen“ öffnet (natürlich) das Jamulus Einstellungsfenst Wenn du mehr über die Nutzung von Jamulus lesen willst, kannst du ins [Software Handbuch](Software-Manual) schauen. ## Erweitert - +Natürlich kannst du sehr viel mehr mit Jamulus tun. Du könntest z.B. einen privaten Server aufsetzen, Online-Konzerte durchführen,... Guck dich einfach auf dieser Website um! Die Community veröffentlicht Anleitungen, Tipps und Tricks in der [Knowledge base](/kb/). ## Hilfe und Community Wenn du Hilfe brauchst oder wenn du bei der Entwicklung von Jamulus mithelfen willst, schau mal unter den folgenden Links nach: ### Foren -Hilfe und generelle Diskussionen über Jamulus finden im [Forum auf SourceForge](https://sourceforge.net/p/llcon/discussion/) (Englisch) statt. +Hilfe und generelle Diskussionen über Jamulus finden im [Forum auf GitHub](https://github.com/jamulussoftware/jamulus/discussions) (Englisch) statt. ### Entwicklung -Um Jamulus mitzugestalten und bei der Entwicklung mitzuhelfen, kannst du dich im [Jamulus GitHub repository](https://github.com/corrados/jamulus/) umschauen. Lese am Besten die CONTRIBUTING Datei. +Um Jamulus mitzugestalten und bei der Entwicklung mitzuhelfen, kannst du dich im [Jamulus GitHub Repository](https://github.com/jamulussoftware/jamulus/) umschauen. Lese am Besten die `CONTRIBUTING.md` Datei. diff --git a/wiki/de/de-Running-a-Server.md b/wiki/de/de-Running-a-Server.md index 1642cca3f..6774c8119 100644 --- a/wiki/de/de-Running-a-Server.md +++ b/wiki/de/de-Running-a-Server.md @@ -35,11 +35,11 @@ Viele Leute denken, dass der Server Probleme macht, obwohl es eigentlich Problem Wenn du planst, regelmäßig mit den gleichen Leuten zu spielen, solltest du zunächst sicherzustellen, dass jedes Mitglied der Gruppe für die korrekte Verwendung von Jamulus eingerichtet ist. Finde dazu einen öffentlichen Server mit einer geringen Ping-Zeit für alle (20 ms oder weniger), lasse jeden eine Verbindung zu diesem Server herstellen und arbeite daran, alle individuellen Probleme zu beheben (stelle sicher, dass sie [Regel Nr. 1](Getting-Started#schwierigkeiten-probleme-kannst-du-den-rhythmus-nicht-einhalten) befolgen). Verwende die oben genannte Solotechnik, um zu verhindern, dass du unterbrochen wirst. -Sobald alle Probleme mit den Musikern auf diese Weise gelöst sind, kannst du testen, ob du deinen eigenen Server entweder zu Hause oder auf einem Cloud-Host wie Amazon hosten willst, der evtl. besseren Latenzzeiten hat. Siehe [diesen Leitfaden](https://www.facebook.com/notes/jamulus-online-musicianssingers-jamming/howto-idiots-guide-to-installing-jamulus-server-on-amazon-aws-lightsail-ubuntu-i/507719749802976/) zur Verwendung von AWS Lightsail von [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a) (_Facebook_) +Sobald alle Probleme mit den Musikern auf diese Weise gelöst sind, kannst du testen, ob du deinen eigenen Server entweder zu Hause oder auf einem Cloud-Host wie Amazon hosten willst, der evtl. besseren Latenzzeiten hat. Schau dir [diesen Leitfaden](https://www.facebook.com/notes/jamulus-worldjam/howto-idiots-guide-to-installing-or-upgrading-a-jamulus-server-on-amazon-aws-lig/818091045662521/) von [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a) (_Facebook_) zur Verwendung von AWS Lightsail an. ### Bandbreite – hast du genug? -Ein typischer Jam mit 4 Personen könnte grob 200Kbps * 4 = 800Kbs (0.8Mbps) Upload und Download benötigen. Eine typische Breitbandverbindung mit 10MBit/s Download und 1MBit/s Upload, **wird sehr wahrscheinlich ab dem fünften Musiker zu gering sein**, insbesondere wenn andere Musiker Einstellungen wählen, die viel Bandbreite benötigen. Hier kannst du testen, [wie viel Bandbreite dein Anschluss bietet](https://fast.com). [Mehr über die benötigte Bandbreite](Network-Requirements) bei verschiedenen Qualitätseinstellungen. +Ein typischer Jam mit 4 Personen könnte grob 200Kbit/s * 4 = 800Kbit/s (0,8 Mbit/s) Upload und Download benötigen. Eine typische Breitbandverbindung mit 10 Mbit/s Download und 1 Mbit/s Upload, **wird sehr wahrscheinlich ab dem fünften Musiker zu gering sein**, insbesondere wenn andere Musiker Einstellungen wählen, die viel Bandbreite benötigen. Hier kannst du testen, [wie viel Bandbreite dein Anschluss bietet](https://fast.com). [Mehr über die benötigte Bandbreite](Network-Requirements) bei verschiedenen Qualitätseinstellungen. ### Allgemein @@ -59,10 +59,11 @@ Ein typischer Jam mit 4 Personen könnte grob 200Kbps * 4 = 800Kbs (0.8Mbps) Upl -Serverbetreiber könnten [diese nützlichen Tools](https://github.com/corrados/jamulus/tree/master/tools) aus dem Jamulus-Repository nützlich finden. Klone dazu das Git-Repo und rufe `git submodule update --init` auf). +Wenn du den Jamulus Server auf einem Raspberry Pi einrichten möchtest, sieh dir die [Anleitung für Raspberry Pi](/kb/2020/03/28/Server-Rpi.html) von fredsiva an. + +Serverbetreiber könnten [diese nützlichen Tools](https://github.com/jamulussoftware/jamulus/tree/master/tools) aus dem Jamulus-Repository hilfreich finden. Klone dazu das Git-Repo und rufe `git submodule update --init` auf). ## Probleme? diff --git a/wiki/en/en-Adminstration.md b/wiki/en/en-Adminstration.md new file mode 100644 index 000000000..329b62a7b --- /dev/null +++ b/wiki/en/en-Adminstration.md @@ -0,0 +1,8 @@ +--- +layout: wiki +title: "Adminstration" +lang: "en" +permalink: "/wiki/Adminstration" +--- + + diff --git a/wiki/en/en-Central-Servers.md b/wiki/en/en-Central-Servers.md index 678c47c8c..2ea66d0ad 100644 --- a/wiki/en/en-Central-Servers.md +++ b/wiki/en/en-Central-Servers.md @@ -5,20 +5,26 @@ lang: "en" permalink: "/wiki/Central-Servers" --- +{% include breadcrumb.html root="More" branch1="Running a Server" branch1-url="Running-a-Server" %} + # Public Server Registration -As of May 2020, in order to minimise the problem of exceeding the server limit, we have created genre-based Central Servers (each with a current limit of 150 servers). +Because there is a limit of 150 servers per central server, you need to select which central server you want to advertise your server on. Select a genre if you intend to limit players to that style (players can then see your server in their genre list). + +When you start a public server, you will see a message saying whether your server has been successfully listed or not. If not, and you leave your server running, it will keep trying to register until a free slot becomes available. -When you start a public server, you will see a message saying whether your server has been successfully listed or not. If you leave your server running, it will re-try its attempts to register until a free slot becomes available. ## Headless servers -As of Jamulus v3.5.4, you will need to set central (genre) server manually using the `--centralserver` (`-e`) option as follows: +Set central (genre) server using the `--centralserver` (`-e`) option as follows: + | Genre | Server address | |-----------|------------------| -|**All/Any** |`jamulusallgenres.fischvolk.de:22224` | -|**Rock**|`jamulusrock.fischvolk.de:22424`| -|**Jazz**|`jamulusjazz.fischvolk.de:22324`| -|**Classical/Folk/Choir**|`jamulusclassical.fischvolk.de:22524`| -|Default _(deprecated as of Jamulus v3.5.4)_|`jamulus.fischvolk.de:22124`| +|**Any Genre 1** |`anygenre1.jamulus.io:22124`| +|**Any Genre 2** |`anygenre2.jamulus.io:22224`| +|**Any Genre 3** |`anygenre3.jamulus.io:22624`| +|**Genre Rock** |`rock.jamulus.io:22424`| +|**Genre Jazz** |`jazz.jamulus.io:22324`| +|**Genre Classical/Folk** |`classical.jamulus.io:22524`| +|**Genre Choral/Barbershop** |`choral.jamulus.io:22724`| diff --git a/wiki/en/en-Choosing-a-Server-Type.md b/wiki/en/en-Choosing-a-Server-Type.md index eb883e812..be890de0f 100644 --- a/wiki/en/en-Choosing-a-Server-Type.md +++ b/wiki/en/en-Choosing-a-Server-Type.md @@ -5,6 +5,8 @@ lang: "en" permalink: "/wiki/Choosing-a-Server-Type" --- +{% include breadcrumb.html root="More" branch1="Running a Server" branch1-url="Running-a-Server" %} + # Server Types You can run your server in one of three "modes" (either at home or on a 3rd party host): @@ -53,6 +55,8 @@ Normal server operators can also register with your custom central server so the To run a server as a central server, it should be configured with `--centralserver localhost` (that is, specify itself as the central server to query). -If you want to control which servers can register with your central server, you can enable a whitelist with the `--listfilter` command line option. See the [command line options page](Command-Line-Options) for further information about this feature. +#### Configuration points to note -See also [Command Line Options](Command-Line-Options) for other parameters you can set. +If you want to control which servers can register with your Central Server, you can enable a whitelist with the `--listfilter` command line option. See the [command line options page](Command-Line-Options) for further information about this feature and other parameters you can set. + +When running a public Central Server behind a NAT firewall on a private network, use the `--serverpublicip` option to specify the public IP address of the server(s) being listed by your Central Server. This is necessary to allow clients on the public Internet to connect to them via NAT. Note that for the servers using this option, you will still need proper port forwarding in your router/firewall. diff --git a/wiki/en/en-Client-Troubleshooting.md b/wiki/en/en-Client-Troubleshooting.md index c6cbab212..7d0d187a2 100644 --- a/wiki/en/en-Client-Troubleshooting.md +++ b/wiki/en/en-Client-Troubleshooting.md @@ -8,9 +8,9 @@ permalink: "/wiki/Client-Troubleshooting" # Troubleshooting ### Don’t hear any sound/Others don’t hear you? -Start with the simple stuff: make sure your instrument/microphone and headphones are connected to the correct sockets. Make sure no other applications like your browser, video conferencing tool etc. is also using your soundcard. You should shut those down when using Jamulus. If that all looks OK and the problem persists, it's likely there's an issue with your sound device settings. This will depend on your particular setup (platform, hardware, software and drivers), so it's best to ask on [the forums](https://sourceforge.net/p/llcon/discussion/software/) for guidance. +Start with the simple stuff: make sure your instrument/microphone and headphones are connected to the correct sockets. Make sure no other applications like your browser, video conferencing tool etc. is also using your sound card. You should shut those down when using Jamulus. If that all looks OK and the problem persists, it's likely there's an issue with your sound device settings. This will depend on your particular setup (platform, hardware, software and drivers), so it's best to ask on [the forums](https://github.com/jamulussoftware/jamulus/discussions) for guidance. -**Windows users (ASIO4All)**: If you’re using the ASIO4All driver have a look at the [ASIO4All setup section](Installation-for-Windows#setting-up-asio4all) +**Windows users (ASIO4ALL)**: If you’re using the ASIO4ALL driver have a look at the [ASIO4LL setup section](Installation-for-Windows#setting-up-asio4all) ### You all sound OK, but it's difficult to keep together @@ -18,15 +18,16 @@ Start with the simple stuff: make sure your instrument/microphone and headphones You can test whether you are hearing your signal correctly by doing the following: -1. Get your audio into your computer. -1. Use an audio recording application (such as [Audacity](https://www.audacityteam.org/)) on your computer to record that input and check it's OK. -1. Make sure that if you mute your audio input inside the recording application, you can't hear yourself. -1. Close the recording application and run Jamulus. You should still not hear yourself. -1. Connect to a server and play something. Now you should hear yourself with the delay from the server. +1. Run Jamulus and connect to a server with a long ping time (greater than 200ms) +2. Clap your hands once (or play one short note on an instrument). You should hear the sound from the Jamulus server come back, but significantly delayed. +3. Click the "Mute" button under your Jamulus name/slider in the main Jamulus mixer window (**NOT** the "Mute Myself" button on the left). +4. Clap your hands again. -**If you are still having problems**, try asking on the [hardware forum](https://sourceforge.net/p/llcon/discussion/hardware/). Exactly how you avoid listening to your direct signal will depend on your individual setup - your sound interface, mixing desk, headphone connection point, etc. For example, some audio interfaces have "monitor" buttons (turn these off), or similar options. +If you hear two claps after step 2, or any claps after step 4, then you are **not** obeying Rule Number One - you have your local audio enabled and should disable it. -Be aware that while listening to the server's signal will ensure you will be in sync with other musicians, you may also experience problems if your overall latency (indicated by the "Delay" light in Jamulus) is not green or at least yellow most of the time. Consult the [software manual](Software-Manual) to understand how to adjust your setup to help with this. +Exactly how you avoid listening to your direct signal will depend on your individual setup - your sound interface, mixing desk, headphone connection point, etc. For example, some audio interfaces have "monitor" buttons (turn these off), or similar options. **If you are still having problems**, try asking on the [forum](https://github.com/jamulussoftware/jamulus/discussions). + +Be aware that while listening to the server's signal will ensure you will be in sync with other musicians, you may also experience problems if your overall latency (indicated by the "Delay" light in Jamulus) is not green or at least yellow most of the time. Consult the [software manual](/wiki/Software-Manual) to understand how to adjust your setup to help with this. ### Can't work out your mic settings? @@ -50,7 +51,7 @@ You can set your "New Client Level" to a low value (e.g. 10), or set the musicia ### Can't see the server you want to join? -First check that you have the right genre server selected in your Connect Setup window. But sometimes network issues mean your client won't list all the available servers. If you know the name of the server you want to join, you can [look up its IP address here](http://explorer.jamulus.io/). Enter the IP address in the "Server Name/Address" field in the Connect Setup window to connect to it. +First check that you have the right genre server selected in your Connection Setup window. Sometimes network issues mean your client won't list all the available servers. If you know the name of the server you want to join, you can [look up its IP address here](https://explorer.jamulus.io/). Enter the IP address in the "Server Name/Address" field in the Connect Setup window to connect to it. ### Not seeing a list of servers at all? @@ -72,4 +73,4 @@ Maybe you did not answer "Yes" to the `"Jamulus wants to access your microphone" *** -For anything else, please search or post on the [Discussion Forums](https://sourceforge.net/p/llcon/discussion/software/) +For anything else, please search or post on the [Discussion Forums](https://github.com/jamulussoftware/jamulus/discussions) diff --git a/wiki/en/en-Command-Line-Options.md b/wiki/en/en-Command-Line-Options.md index 0feeaef27..f6f626bd2 100644 --- a/wiki/en/en-Command-Line-Options.md +++ b/wiki/en/en-Command-Line-Options.md @@ -31,7 +31,7 @@ You can see all possible options your version supports by starting Jamulus with | `-c` |`--connect` | Connect to given server address on startup, format `address[:port]` | (client only) | | `-d` |`--discononquit` | Disconnect all clients on quit | (server only) | | `-e` |`--centralserver` | Makes the server public and sets its genre. See also `-o`| (server only) [See list](Central-Servers). | -| `-f` |`--listfilter` | Whitelist servers registering on the serverlist, format `ip address 1[;ip address 2]` | (central server only) [See note](Choosing-a-Server-Type#3-central). | +| `-f` |`--listfilter` | Whitelist servers registering on the server list, format `ip address 1[;ip address 2]` | (central server only) [See note](Choosing-a-Server-Type#3-central). | | `-F` |`--fastupdate` | 64 samples frame size mode. Reduces latency if clients connect with "Enable Small Network Buffers" option. Requires faster CPU to avoid dropouts, and more bandwidth to enabled clients. | (server only) | | `-h,-?` |`--help` | This help text | (client and server) | | `-i` |`--inifile` | Set location of initialization file (overrides default) | (client (always) and server (with GUI)) | @@ -42,7 +42,7 @@ You can see all possible options your version supports by starting Jamulus with | `-n` |`--nogui` | Disable GUI | (client and server) | | `-o` |`--serverinfo` | Server location details in the format:
`[name];[city];[locale value]` (see [values](https://doc.qt.io/qt-5/qlocale.html#Country-enum))| (public servers only) | | `-p` |`--port` | Local UDP port number. Default is 22124 | (server only) | -| `-R` |`--recording` | Include a writable path where the files should be stored (in quotes if needed). | (server only) See description in [Server Setup](Server-Win-Mac#recording). | +| `-R` |`--recording` | Include a writeable path where the files should be stored (in quotes if needed). | (server only) See description in [Server Setup](Server-Win-Mac#recording). | | | `--norecord` | Start recorder with recording disabled | (server only) | | `-s` |`--server` | Start in server mode | (server only) [See note](Choosing-a-Server-Type) | | `-t` |`--notranslation` | Disable translations | (client and server) | @@ -50,5 +50,6 @@ You can see all possible options your version supports by starting Jamulus with | `-u` |`--numchannels` | Maximum number of users. Default is 10, maximum is 50 | (server only) | | `-w` |`--welcomemessage` | Supports HTML and inline CSS formatting (in enclosing quotes), or set path to text file. | (server only) | | `-z` |`--startminimized` | Start minimized | (server only) | -| |`--ctrlmidich` | MIDI controller channel to listen on and control number offset, format: `channel[;offset]` | (client only) see [Tips & Tricks](Tips-Tricks-More#Using-ctrlmidich-for-MIDI-controllers) | -| |`--clientname` | Window title and jack client name | (client only) | +| |`--ctrlmidich` | MIDI controller channel to listen on, control number offset and consecutive CC numbers (channels). Format: `channel[;f*][;p*][;s*][;m*]` | (client only) see [Tips & Tricks](Tips-Tricks-More#Using-ctrlmidich-for-MIDI-controllers) | +| |`--clientname` | Window title and JACK client name | (client only) | +| |`--serverpublicip` | Supply the server's public IP address | (server only) [See note](Choosing-a-Server-Type) | diff --git a/wiki/en/en-Compiling.md b/wiki/en/en-Compiling.md index 970491827..5b01e2025 100644 --- a/wiki/en/en-Compiling.md +++ b/wiki/en/en-Compiling.md @@ -16,7 +16,7 @@ You don't need to compile Jamulus for macOS since we provide official binaries, ### Requirements 1. Install XCode -1. Install QT as follow +1. Install Qt as follows ```shell brew install qt5 @@ -62,12 +62,34 @@ Will build the file and make it available in `./Release/Jamulus.app` ## Windows You don't need to compile Jamulus for Windows since we provide official binaries, but if you really want to, follow the instructions below. -**Required software**: [QT](https://www.qt.io/download), a compiler like Visual Studio, ASIO development files +### Required Software +* A compiler like [Visual Studio](https://visualstudio.microsoft.com) (You only need [Build Tools 2017 or 2019](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16) but can also choose to download and install the full IDE from the [Visual Studio download page](https://visualstudio.microsoft.com/downloads/)) +* [Qt](https://www.qt.io/download) + * Use the free GPLv2 license for Open Source development + * To determine the Qt version you need, check [qt-installer-windows.qs](https://github.com/jamulussoftware/jamulus/blob/master/windows/qt-installer-windows.qs): under INSTALL_COMPONENTS you will see `qt.qt5.[version]`, e.g., 5123 means version 5.12.3. + * Select Components during installation: Expand the Qt section, find the matching version, e.g., **Qt 5.12.3**, and add the compiler components for your compiler, e.g., `MSVC 2017 32-bit/64-bit` for Visual Studio 2019 +* [ASIO development files](https://www.steinberg.net/en/company/developer.html) -- get the Jamulus source code e.g. via git or via zip download from the Jamulus Repo -- get and copy the [ASIOSDK](https://www.steinberg.net/en/company/developers.html) development files in `[\path\to\jamulus\source]\windows` directory so that, e.g., the - directory `[\path\to\jamulus\source]\ASIOSDK2\common` exists -- open Jamulus.pro in Qt Creator then compile & run + +### Download Jamulus source code +Get the Jamulus source code e.g. via git or [zip download](https://github.com/jamulussoftware/jamulus/archive/master.zip) from the [Jamulus repo](https://github.com/jamulussoftware/jamulus). Make sure that there are **no** spaces in the directory you move the `jamulus` directory to since it might break the Jamulus installer (if you know how to fix this issue, please comment on [issue #864](https://github.com/jamulussoftware/jamulus/issues/864) on the Jamulus repo to tell us how). + +### Compiling and building installer + +Most users will probably want to use this method: + +1. Open PowerShell +1. Navigate to the `jamulus` directory +1. To allow unsigned scripts, right-click on the `windows\deploy_windows.ps1` script, select properties and allow the execution of this script. You can also run `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`. (You can revert this after having run this script. For more information see the [Microsoft PowerShell documentation page](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy)). +1. Edit the $QtCompile32 and $QtCompile64 variables. +1. Run the Jamulus compilation and installer script in PowerShell: `.\windows\deploy_windows.ps1 C:\Qt\QtVersion`. +1. You can now find the Jamulus installer in the `.\deploy` directory. + +### Compiling only + +1. Create a folder under `\windows` called ASIOSDK2 +1. Download the [ASIOSDK](https://www.steinberg.net/asiosdk), open the top level folder in the .zip file and copy the contents into `[\path\to\jamulus\source]\windows\ASIOSDK2` so that, e.g., the folder `[\path\to\jamulus\source]\windows\ASIOSDK2\common` exists +1. Open Jamulus.pro in Qt Creator, configure the project with a default kit, then compile & run ## General notes diff --git a/wiki/en/en-Contribution.md b/wiki/en/en-Contribution.md index e77369647..7dcd12014 100644 --- a/wiki/en/en-Contribution.md +++ b/wiki/en/en-Contribution.md @@ -8,18 +8,31 @@ permalink: "/wiki/Contribution" # Contributing to the Jamulus Project ## Jamulus Software -* If you want to contribute code, post your idea on [the developer forum](https://sourceforge.net/p/llcon/discussion/developerforum/) first so that it can be discussed before making a pull request (be sure to read main dev's [Volker's manifesto for contributions](https://github.com/corrados/jamulus/issues/596)) -See the [Jamulus GitHub repo](https://github.com/corrados/jamulus) for further information. +If you want to contribute code or have a feature request, [open an issue on GitHub](https://github.com/jamulussoftware/jamulus/issues/) (preferred) or [post your idea on the forum](https://github.com/jamulussoftware/jamulus/discussions) if you don't have a GitHub account. This allows us to discuss the changes before e.g. making a pull request (be sure to read main dev's [Volker's manifesto for contributions on GitHub](https://github.com/jamulussoftware/jamulus/discussions/915) and the [CONTRIBUTING file](https://github.com/jamulussoftware/jamulus/blob/master/CONTRIBUTING.md)) + +See the [Jamulus GitHub repo](https://github.com/jamulussoftware/jamulus) for further information. ## Jamulus Website -* If you find a mistake, typo or something out of date (in any language) on the website, you can [raise it as an issue here](https://github.com/jamulussoftware/jamuluswebsite/issues). +* If you find a mistake, typo or something out of date (in any language) on the website, you can [open an issue on GitHub](https://github.com/jamulussoftware/jamuluswebsite/issues). + +* If you think some documentation or information is missing or can be improved, post about that on [the discussion forum](https://github.com/jamulussoftware/jamuluswebsite/discussions) so that it can be discussed first. + +Have a look at the [CONTRIBUTING file](https://github.com/jamulussoftware/jamuluswebsite/blob/changes/CONTRIBUTING.md) for the website and the [Website GitHub repo](https://github.com/jamulussoftware/jamuluswebsite) for further information. + +### I'm not familiar with GitHub. What do I need to know? -* If you think some documentation or information is missing or can be improved, post about that on [the relevant discussion forum](https://sourceforge.net/p/llcon/discussion/) so that it can be discussed first. +**The following content is for the documentation on jamulus.io only, not for the Jamulus software!** -Pull requests for the website should look like this: +If you aren't comfortable with Pull Requests, commits, etc. just open an issue. We will then take care of your changes. If you want to do the changes on your own and open a Pull Request, follow these instructions: -`[language code (e.g. en)] {short description of your changes}` +1. Fork the repo (there's a fork button on the top right of the GitHub page) +2. Decide which branch you have to commit your changes to (rule of thumb: everything which might need translation should go to the `changes` branch, typos should go to the `release` branch; more information can be found in the [CONTRIBUTING file](https://github.com/jamulussoftware/jamuluswebsite/blob/changes/CONTRIBUTING.md)). Create a new branch from the up-to-date branch you chose +3. Make your changes +4. If you did the changes offline, push the new branch to your repository +5. Submit your Pull Request, give a short description of your changes and link the issue you opened +6. Wait for a review and a merge -See the [Website GitHub repo](https://github.com/jamulussoftware/jamuluswebsite) for further information. +**Hint (for git):** *Do not merge your work* into your local `changes` branch, only keep it in sync by pooling from the remote Jamulus website repository. Create a new branch for your proposed changes. +If the `changes` branch is modified before submitting your request, keep the local `changes` branch in sync by pooling from the official one, merge the local changes branch into your working branch, resolve conflicts, push your changes and create the Pull Request. diff --git a/wiki/en/en-Demos.md b/wiki/en/en-Demos.md index 93decd18f..b45b28cf4 100644 --- a/wiki/en/en-Demos.md +++ b/wiki/en/en-Demos.md @@ -5,7 +5,6 @@ lang: "en" permalink: "/wiki/Demos" --- - # Examples of Jamulus in Use **Feel free to add your own!** diff --git a/wiki/en/en-Getting-Started.md b/wiki/en/en-Getting-Started.md index c3eb77b3b..5180088b4 100644 --- a/wiki/en/en-Getting-Started.md +++ b/wiki/en/en-Getting-Started.md @@ -11,21 +11,21 @@ permalink: "/wiki/Getting-Started" 1. **A computer** running either **Windows 10**, **macOS** (**MacOS X** El Capitan v10.11 or higher), or **Linux**. 1. **A wired internet connection** (don't use Wi-Fi, it will cause sound problems). Most broadband connections will be fine[^1]. -1. **Wired headphones - not speakers** to prevent echo or feedback and to minimize delay[^2]. +1. **Wired headphones - not speakers** to prevent echo or feedback and to minimise delay[^2]. ## Maximise quality, minimise delay -### 1. Minimize internet traffic and close all programs on your PC +### 1. Minimise internet traffic and close all programs on your PC Try to make sure nothing on your machine or your network (like a video stream) is competing against Jamulus when you are using it. ### 2. Use an audio interface/external microphone, not your internal sound card -We strongly recommend – although you could start without it – to use an audio interface (a box you plug a microphone/instrument into and connect to your PC e.g. via USB) to enjoy higher quality sound with low latency in Jamulus. You can also use a USB microphone. See [recommended hardware](#recommended-hardware). +We strongly recommend – although you could start without it – using an audio interface (a box you plug a microphone/instrument into and connect to your PC e.g. via USB) to enjoy higher quality sound with low latency in Jamulus. You can also use a USB microphone. See [recommended hardware](#recommended-hardware). ### 3. Connect to the servers with the lowest ping times -Servers shown on the list with 15ms or below will give you the best chance of having a good time (although there's other things that affect performance too). Anything higher and you're taking your chances. +Servers shown on the list with 15 ms or below will give you the best chance of having a good time (although there are other things that affect performance too). Anything higher and you're taking your chances. Now that you have the basics down, let's go: @@ -33,13 +33,16 @@ Now that you have the basics down, let's go: Install on Windows Install on macOS For Linux users + Install on Android (PoC)
Also - [Jamulus OS!](https://sourceforge.net/projects/jamulus-os/files/JamulusOS/) Run Jamulus on any computer using a USB stick (64-bit systems only). Checks your hardware and sets you up like a boss straight out of the box! ## Recommended hardware -See [the list of known good hardware](Sound-Devices) and [Hardware Setup](Hardware-Setup). +In general, your device must support a sample rate of **48kHz** (DVD quality) and should allow you to listen to the computer's audio signal. On Windows it's recommended to choose a device with a native [ASIO](https://en.wikipedia.org/wiki/Audio_Stream_Input/Output) driver. + +See [the community list of known good hardware](/kb/2021/01/05/Jamulus-Sound-Devices.html). ## Other guides * [This excellent guide](https://www.facebook.com/notes/jamulus-online-musicianssingers-jamming/idiots-guide-to-jamulus-app/510044532903831/){: target="_blank" rel="noopener noreferrer"} by [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a){: target="_blank" rel="noopener noreferrer"} (_Facebook_) might also be worth a view. @@ -59,8 +62,8 @@ Further information about how to avoid listening to yourself (and help with othe **Here's how millions of people are using Jamulus to play, sing and teach music with other people in real time, all over the world:** ![Overview](https://user-images.githubusercontent.com/4561747/79309764-bd387280-7ef2-11ea-9d81-1e81302525e6.png) -_Jamulus works on the client server principle. Everybody’s audio is sent to a server, mixed and processed there. Afterwards the audio is sent to every client. If a server is made public and registered on a central server, its information will be broadcasted to all clients._ +_Jamulus works on the client-server principle. Everybody’s audio is sent to a server, mixed and processed there. Afterwards, the audio is sent back to each client. If a server is made public and registered on a central server, its information will be broadcast to all clients._ ## Footnotes -[^1]: [Full details here](Network-Requirements){: target="_blank" rel="noopener noreferrer"}. If you have 10Mbits down and 1Mbps up, you're unlikely to run into bandwidth-related issues. -[^2]: Bluetooth headphones usually have too much latency. That's one reason why wired headphones are required. Particularity if singing or playing acoustic instruments to make sure you keep in time with others only use headphones (see the [note on this](Getting-Started#having-trouble-cant-keep-in-time) for further information). +[^1]: [Full details here](Network-Requirements){: target="_blank" rel="noopener noreferrer"}. If you have 10 Mbit/s down and 1 Mbit/s up, you're unlikely to run into bandwidth-related issues. +[^2]: Bluetooth headphones usually have too much latency. That's one reason why wired headphones are required. Particularly if singing or playing acoustic instruments, to make sure you keep in time with others, only use headphones (see the [note on this](Getting-Started#having-trouble-cant-keep-in-time) for further information). diff --git a/wiki/en/en-Hardware-Setup.md b/wiki/en/en-Hardware-Setup.md index 155449aad..aecd42239 100644 --- a/wiki/en/en-Hardware-Setup.md +++ b/wiki/en/en-Hardware-Setup.md @@ -5,6 +5,7 @@ lang: "en" permalink: "/wiki/Hardware-Setup" --- +{% include breadcrumb.html root="Using Jamulus" branch1="Getting Started" branch1-url="Getting-Started" %} # Hardware Setup @@ -16,7 +17,7 @@ permalink: "/wiki/Hardware-Setup" ## Example Setups -Setting up hardware usually burns down to 4 points, although each setup is different. +Setting up hardware usually boils down to 4 points, although each setup is different. 1. Plug the interface into a USB port on your computer 2. Close all programs and start Jamulus (don't forget to choose the right inputs in Jamulus's settings) @@ -24,18 +25,18 @@ Setting up hardware usually burns down to 4 points, although each setup is diffe 4. Connect to a Jamulus server and have fun! -## Windows: Audio interface connection - ASIO4All +## Windows: Audio interface connection - ASIO4ALL -This is an example Windows client installation with audio device [Behringer U-CONTROL UCA202](https://www.amazon.com/Behringer-U-Phono-UFO202-Audiophile-Interface/dp/B002GHBYZ0){: target="_blank" rel="noopener noreferrer"}. +This is an example Windows client installation with the [Behringer U-CONTROL UCA202](https://www.amazon.com/Behringer-U-Phono-UFO202-Audiophile-Interface/dp/B002GHBYZ0) audio device. The following instructions might be similar with other audio devices. _**The exact method of connecting your instrument will of course vary depending on your hardware.**_ #### 1. Plug the interface into a USB port on your computer -In the future, always use the same USB port for the audio device. +In future, always use the same USB port for the audio device. -**Windows users**: If not already done: download and install the [free ASIO sound driver (ASIO4All)](https://www.asio4all.org){: target="_blank" rel="noopener noreferrer"}. Some people have also reported success using [this ASIO native driver](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip){: target="_blank" rel="noopener noreferrer"} __currently not available__, although it's not listed on Behringer's product pages as of April 2020. +**Windows users**: If not already done: download and install the [free ASIO sound driver (ASIO4ALL)](https://www.asio4all.org){: target="_blank" rel="noopener noreferrer"}. Some people have also reported success using [this ASIO native driver](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip){: target="_blank" rel="noopener noreferrer"} __currently not available__, although it's not listed on Behringer's product pages as of April 2020. #### 2. Start Jamulus @@ -46,36 +47,35 @@ Make sure you have switched off the monitor button on your Behringer U-CONTROL U #### 3. Plug in your instrument and headphones -Connect your instrument to the input plugs of the Behringer U-CONTROL UCA202. Plug in your headphones into the Behringer U-CONTROL UCA202. +Connect your instrument to the input socket of the Behringer U-CONTROL UCA202. Plug your headphones into the Behringer U-CONTROL UCA202. #### 4. Connect to a Jamulus server. You're done! Have fun! - -## Linux: Audio interface connection with QJackCtrl +## Linux: Audio interface connection with QjackCtl Refer to the Linux [client install guide](Installation-for-Linux#configure-jack-with-qjackctl). ## Linux: Low Latency Kernels for Jamulus -You might want to install [Ubuntu Studio](https://ubuntustudio.org/){: target="_blank" rel="noopener noreferrer"} it adds a second options in your boot menu for a low-latency kernel. The key of successful jamming is "low latency" between servers and connected Jamulus clients. If the underlying Linux system is started with a low-latency then it has a positive impact on latency for your Jamulus Sessions. +You might want to install [Ubuntu Studio](https://ubuntustudio.org/). It adds a second option in your boot menu for a low-latency kernel. The key to successful jamming is "low latency" between servers and connected Jamulus clients. If the underlying Linux system is started with a low-latency kernel then it has a positive impact on latency for your Jamulus sessions. ## Points to note about inputs -- If you want to connect 2 or more sources (eg voice + synth + guitar), it is important to note that Jamulus currently handles only input 2 channels (L/R). So the hardware being used must provide a mixed-down stereo output to Jamulus. -- Audio interfaces generally output a mixed signal on their analog output, but separate signals (1 per source) on their digital output (USB/Firewire/Thunderbolt). -- Mixers generally only output mixed-down signals on their analog output. -- Mixers with USB/Firewire/Thunderbolt generally output mixed-down signal on their **analog** output AND separate signals only (no mixed-down signal) on their **digital** output. -- A few Mixers with USB/Firewire/Thunderbolt will either send **only** a mixed down signal to the **digital** output (small/budget mixers), or else also ADD a stereo mix-down signal to the separate signals on the digital output. +- If you want to connect 2 or more sources (e.g. voice + synth + guitar), it is important to note that Jamulus currently handles only 2 input channels (L/R). So the hardware being used must provide a mixed-down stereo output to Jamulus. Alternatively, run two instances of Jamulus, if your hardware supports it, or use virtual audio inputs to Jamulus for each hardware input. +- Audio interfaces generally output a mixed signal on their analogue output, but separate signals (1 per source) on their digital output (USB/FireWire/Thunderbolt). +- Mixers generally only output mixed-down signals on their analogue output. +- Mixers with USB/FireWire/Thunderbolt generally output a mixed-down signal on their **analogue** output AND separate signals only (no mixed-down signal) on their **digital** output. +- A few Mixers with USB/FireWire/Thunderbolt will either send **only** a mixed-down signal to the **digital** output (small/budget mixers), or else also ADD a stereo mixed-down signal to the separate signals on the digital output. _(Thanks to [pcar75](https://github.com/pcar75) for this information)_ ## Other examples -**This video documents a [live jam session](https://youtu.be/c8838jS2g3U).** I am using a Lexicon Omega USB audio card on a 2009 Mac Mini. My bandmates all use Windows 10 and have Behringer audio cards, e.g. the Behringer Xenyx 1204USB. My internet connection is 10 Mbps down / 1 Mbps upstream via DSL. +**This video documents a [live jam session](https://youtu.be/c8838jS2g3U).** I am using a Lexicon Omega USB audio card on a 2009 Mac Mini. My bandmates all use Windows 10 and have Behringer audio cards, e.g. the Behringer Xenyx 1204USB. My internet connection is 10 Mbit/s down / 1 Mbit/s upstream via DSL. -**Jamulus user [Andrew Evans](https://sourceforge.net/u/belvario/profile/)**: With bandmates all within one city (but spanning 2 ISPs) and achieving consistent 20ms ping time, running the server on a separate dedicated Windows machine and a client on a Macbook Pro. Remote players on Macbook Air. Everyone on wired Ethernet connections to their home router/gateways. We used WhatsApp video to see each other (with audio muted - it's funny to see how far behind the Whatsapp audio lags from Jamulus though!) +**Jamulus user [Andrew Evans](https://sourceforge.net/u/belvario/profile/)**: With bandmates all within one city (but spanning 2 ISPs) and achieving a consistent 20 ms ping time, running the server on a separate dedicated Windows machine and a client on a MacBook Pro. Remote players on MacBook Air. Everyone on wired Ethernet connections to their home router/gateways. We used WhatsApp video to see each other (with audio muted - it's funny to see how far behind the WhatsApp audio lags from Jamulus though!) ## Having problems? diff --git a/wiki/en/en-Installation-for-Android.md b/wiki/en/en-Installation-for-Android.md new file mode 100644 index 000000000..fc1ec247b --- /dev/null +++ b/wiki/en/en-Installation-for-Android.md @@ -0,0 +1,33 @@ +--- +layout: wiki +title: "Installation for Android" +lang: "en" +permalink: "/wiki/Installation-for-Android" +--- + +# Installation for Android + +Make sure you've already read the [Getting Started](Getting-Started) page. + +## Things to note about Android + +Although you **can** install Jamulus on Android devices (and hear sound), we strongly recommend **not** doing so. Sound quality - especially over WiFi - is usually bad and latency is high. If you have don't own a PC, we suggest you to buy a [Raspberry Pi](https://www.raspberrypi.org/){: target="_blank" rel="noopener noreferrer" } which is an inexpensive and small device that performs very well with Jamulus. Android support is just a proof of concept. + +## Install the Android PoC + +If you do want to try Jamulus on Android: + +1. Allow the installation of apps from unknown sources (look in Settings>Security. Note: The exact way to do this depends on your device and OS-version) +1. [Download and install Jamulus]({{ site.download_root_link }}{{ site.download_file_names.android }}){: .button} +1. You should now be able to run Jamulus on your Android device + +## Feedback and development + +We are very happy to get feedback from Android users and developers. Just head over to the [Jamulus GitHub repo](https://github.com/jamulussoftware/jamulus/). + +*** + +## All installed? +Jamulus has been installed and can be used now. You can now take a look at the + +[Jamulus Onboarding page](Onboarding){: .button} diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index f9c6dde6f..29bba4702 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -5,30 +5,55 @@ lang: "en" permalink: "/wiki/Installation-for-Linux" --- +{% include breadcrumb.html root="Using Jamulus" branch1="Getting Started" branch1-url="Getting-Started" %} + # Installation for Linux Make sure you read the [Getting Started](Getting-Started) page. ## Jamulus packages -Although we don't provide official packages, you might find Jamulus in the package manager of your distro. Have a look at this table: +Although we don't provide official packages for every Linux distribution, you might find Jamulus in the package manager of your distro. Have a look at this table: [![Packaging status](https://repology.org/badge/vertical-allrepos/jamulus.svg)](https://repology.org/project/jamulus/versions) -There is also list of unofficial [packages for different distributions here](https://github.com/corrados/jamulus/issues/223){: target="_blank" rel="noopener noreferrer"}. If you don't find it in your package manager, you need to compile Jamulus from source. That's quite easy: -## Get Jamulus sources +There is also list of unofficial [packages for different distributions here](https://github.com/jamulussoftware/jamulus/discussions/914). + +### Flatpak + +Jamulus is available as a [Flatpak](https://flatpak.org/) from [Flathub here](https://flathub.org/apps/details/io.jamulus.Jamulus). You will need to setup pipewire in order to use the Jamulus flatpak. + +### Debian and Ubuntu +You can install Jamulus from [buster-backports](https://packages.debian.org/de/buster-backports/jamulus) or - if you're on amd64 **Debian**/**Ubuntu** - you may try the compiled .deb packages from GitHub Actions: -1. Open up a terminal window (command line - `CTRL+ALT+t` on Ubuntu and related distros) +1. Download the [latest .deb file]({{ site.download_root_link }}{{ site.download_file_names.deb-gui }}) +1. Update apt: `sudo apt-get update` +1. Install the package: `sudo apt install /path/to/{{ site.download_file_names.deb-gui }}`. +1. Since Jamulus needs the JACK server, you have to install it too. We recommend to use `QjackCtl` to configure JACK. You can install it via `sudo apt-get install qjackctl` + +Afterwards you should look at the "[Set up your sound card](#set-up-your-sound-card)" step on this page. + +**Note:** Jamulus (with GUI) is also [included in Debian Bullseye (testing)](https://packages.debian.org/bullseye/jamulus) thanks to [mirabilos](https://github.com/mirabilos). If you already use Bullseye, just install Jamulus via `sudo apt-get install jamulus`. + +--- + +If you can't use one of the above options, you need to compile Jamulus from source: + +## Compile from source + +### Get Jamulus sources + +1. Open up a terminal window (command line - `CTRL+ALT+T` on Ubuntu and related distros) 1. Download and unzip the sources for the latest release: ```shell -wget https://github.com/corrados/jamulus/archive/latest.tar.gz +wget https://github.com/jamulussoftware/jamulus/archive/latest.tar.gz tar -xvf latest.tar.gz ``` -## Install dependencies +### Install dependencies -First, update your package list (e.g. on Debian based distributions with `sudo apt-get update`). +First, update your package list (e.g. on Debian-based distributions with `sudo apt-get update`). On **Ubuntu-based** distributions 18.04+, **Debian** 9+ or 10 and Raspberry Pi Raspbian Buster release or later: @@ -42,17 +67,17 @@ On **Fedora**: sudo dnf install qt5-qtdeclarative-devel jack-audio-connection-kit-dbus libQt5Concurrent5 jack-audio-connection-kit-devel ``` -### Qjackctl: Optional, but recommended +### QjackCtl: Optional, but recommended -[QjackCtl](https://qjackctl.sourceforge.io) is a utility to help you set up the Jack audio server (installed as part of the dependencies above). Install it via e.g. +[QjackCtl](https://qjackctl.sourceforge.io) is a utility to help you set up the JACK audio server (installed as part of the dependencies above). Install it via e.g. ```shell sudo apt-get install qjackctl ``` -You may also wish to consider using a [low-latency kernel](https://help.ubuntu.com/community/UbuntuStudio/RealTimeKernel) (eg. for Ubuntu 18.04: `sudo apt-get install linux-lowlatency-hwe-18.04`). +You may also wish to consider using a [low-latency kernel](https://help.ubuntu.com/community/UbuntuStudio/RealTimeKernel) (e.g. for Ubuntu 18.04: `sudo apt-get install linux-lowlatency-hwe-18.04`). -## Compile this bad boy +### Compile this bad boy Now `cd` into the jamulus sources directory you downloaded: @@ -67,29 +92,31 @@ make clean make sudo make install ``` +**Note:** The compiled version of Jamulus puts itself into `/usr/local/bin`. +You can now delete the sources directory you compiled from. + +--- ## Set up your sound card -### Configure Jack with QJackCtl -Jamulus clients need [Jack](https://jackaudio.org/){: target="_blank" rel="noopener noreferrer"} to run, but you need to configure that first. The recommended method is to use `QjackCtl`. +### Configure JACK with QjackCtl +Jamulus clients need [JACK](https://jackaudio.org/) to run, but you need to configure that first. The recommended method is to use `QjackCtl`. 1. Open the command shell e.g. with Ctrl-Alt-T and -1. Execute the command `qjackctl` you will see the **Jack Audio Connection Kit** -2. Configure your audio interface as follows (the exact settings for Jack will depend on what your audio interface/sound card is capable of): +1. Execute the command `qjackctl`. You will see the **Qt JACK Control utility main page** +2. Configure your audio interface as follows (the exact settings for JACK will depend on what your audio interface/sound card is capable of): - Set the audio **Interface** to the one you want (there may be several in the list) - Set the **Sample Rate to 48000** - Set the **Frames/Period to 128** and Periods/Buffer at 2 at first -Restart Jack to take any new settings +Restart JACK for the new settings to take effect ### Start Jamulus -Open Jamulus e.g. via your command shell. If you use the shell, execute the command `Jamulus` (with a capital 'J') which starts the Jamulus Client - -Jamulus puts itself into `/usr/local/bin`. You can now delete the sources directory you compiled from. +From the command line, execute the command `jamulus`, or if you compiled from source `Jamulus` with a (with a capital 'J'). This will start the Jamulus Client. -If you get problems with sound breaking up (in particular XRUN errors reported by Jack/QJackCtl) try setting bigger values (e.g. 256 frames or 3 periods) in step 3 above. Lower ones (e.g. 64 frames) could bring better performance but maybe more sound problems. See the [troubleshooting page](Client-Troubleshooting) otherwise. +If you get problems with sound breaking up (in particular XRUN errors reported by JACK/QjackCtl) try setting bigger values (e.g. 256 frames or 3 periods). Lower ones (e.g. 64 frames) could bring better performance but maybe more sound problems. See the [troubleshooting page](Client-Troubleshooting) otherwise. ## All installed? @@ -99,16 +126,16 @@ Jamulus has been installed and can be used now. You can now take a look at the ## To update your installation to a new release -Download the new sources as per [Get Jamulus](Installation-for-Linux#get-jamulus-sources) and repeat just the [compilation instructions](Installation-for-Linux#compile-this-bad-boy) as if for a new installation above. +Download the new sources as per [Get Jamulus](Installation-for-Linux#get-jamulus-sources) and repeat just the [compilation instructions](Installation-for-Linux#compile-this-bad-boy) as if for a new installation above or use the new .deb package if you used it. ## Notes for geeks -* The "make clean" is essential to remove the automatically generated Qt files which are present in the .tar.gz file and may not match the Qt version you are using. +* The "make clean" command is essential to remove the automatically generated Qt files which are present in the .tar.gz file and may not match the Qt version you are using. -* To use an external shared OPUS library instead of the built-in use qmake `"CONFIG+=opus_shared_lib" Jamulus.pro`. +* To use an external shared OPUS library instead of the built-in one use qmake `"CONFIG+=opus_shared_lib" Jamulus.pro`. * To use this file configure the software with `qmake "CONFIG+=noupcasename" Jamulus.pro` to make sure the output target name of this software is **j**amulus instead of **J**amulus. -* Users of Raspberry Pi: You may want to compile the client on another machine and run the binary on the Raspberry Pi. In which case, the only libraries you need to run it are those for a [headless server](Server-Linux#running-a-headless-server) build, but _with_ the Jack sound packages. Especially have a look at the footnote for the headless build. +* Users of Raspberry Pi: You may want to compile the client on another machine and run the binary on the Raspberry Pi. In which case the only libraries you need to run it are those for a [headless server](Server-Linux#running-a-headless-server) build, but _with_ the JACK sound packages. In particular, have a look at the footnote for the headless build. * As of version 3.5.3, Jamulus is no longer compatible with Qt4. diff --git a/wiki/en/en-Installation-for-Macintosh.md b/wiki/en/en-Installation-for-Macintosh.md index a5d19db0c..c22f0227e 100644 --- a/wiki/en/en-Installation-for-Macintosh.md +++ b/wiki/en/en-Installation-for-Macintosh.md @@ -5,19 +5,20 @@ lang: "en" permalink: "/wiki/Installation-for-Macintosh" --- +{% include breadcrumb.html root="Using Jamulus" branch1="Getting Started" branch1-url="Getting-Started" %} + # Installation for macOS Make sure you've already read the [Getting Started](Getting-Started) page. -1. [Download Jamulus](https://sourceforge.net/projects/llcon/files/latest/download){: target="_blank" rel="noopener noreferrer" .button} -1. **Extract the downloaded .zip file.** Double-click on the .zip file, which will create a new folder with the same name. The folder contains the license file and a `.dmg` file containing the application. -1. **Double-click the `.dmg` file** to open it. It will unpack and you will see two files (Jamulus client and server). Agree to the license. -1. **Drag and drop both icons into your Applications folder** to install Jamulus. +1. [Download Jamulus]({{ site.download_root_link }}{{ site.download_file_names.mac }}){: .button}\\ +**Mirror 2:** [SourceForge](https://sourceforge.net/projects/llcon/files/latest/download) +1. **Install Jamulus**: Open the downloaded `.dmg` file, agree to the license, *drag and drop* the two icons you see in the window (Jamulus client and server) into your *Applications folder*. After that, you can close this window. 1. **Run Jamulus**. Now you should be able to use Jamulus just like any other application. If you see a message which tells you that Jamulus can't be opened because the developer can't be verified, read on and have a look at the following section. _You can remove the folder in the Downloads directory containing the `.dmg` and eject the "Jamulus" drive on your desktop. They are no longer needed._ -You can also [compile your own binary](Compiling) if you feel so inclined. +*** ## "Jamulus" can't be opened because the developer cannot be verified @@ -25,13 +26,16 @@ You can also [compile your own binary](Compiling) if you feel so inclined. The first time you try to double-click Jamulus to run it, you will probably see a message saying it cannot be opened. We don't code-sign Jamulus yet (it's quite expensive). -To open Jamulus, navigate to the Applications folder via Finder click on Jamulus, right-click (or control-click), and select "Open" from the top of the menu. +To open Jamulus +1. Navigate to the Applications folder via Finder +1. Double-click on Jamulus and wait for the above-mentioned message +1. Close this message by clicking on "Cancel" +1. Now control-click (or right-click) on Jamulus, and select "Open" from the top of the menu. You will then get a slightly different version of the same message, which allows you to click "Open" and go ahead with running it. You will not be shown this warning again - just double-click it to run after that. -For further information about this warning see [this Apple Support Page](https://support.apple.com/en-gb/guide/mac-help/mh40616/mac){: target="_blank" rel="noopener noreferrer"}. +For further information about this warning see [this Apple Support Page](https://support.apple.com/en-gb/guide/mac-help/mh40616/mac). ## All installed? Jamulus has been installed and can be used now. You can now take a look at the [Jamulus Onboarding page](Onboarding){: .button} - diff --git a/wiki/en/en-Installation-for-Windows.md b/wiki/en/en-Installation-for-Windows.md index bf0e4cfd2..eaef5575e 100644 --- a/wiki/en/en-Installation-for-Windows.md +++ b/wiki/en/en-Installation-for-Windows.md @@ -5,45 +5,68 @@ lang: "en" permalink: "/wiki/Installation-for-Windows" --- +{% include breadcrumb.html root="Using Jamulus" branch1="Getting Started" branch1-url="Getting-Started" %} + # Installation for Windows Make sure you read the [Getting Started](Getting-Started) page. -1. **Download and install an ASIO Driver**. It is recommended to use a sound card/interface with a native ASIO driver. If you don't have one (especially internal sound cards), install [this free ASIO driver (ASIO4All)](http://www.asio4all.org){: target="_blank" rel="noopener noreferrer"} before installing Jamulus. -1. [Download and install Jamulus](https://sourceforge.net/projects/llcon/files/latest/download){: target="_blank" rel="noopener noreferrer"}. If you get a warning notice from SmartScreen, click on "More info" and "Run anyway" to install Jamulus. This is needed since we don't pay for code signing yet. +1. **Download and install an ASIO Driver**. It is recommended to use a sound card/interface with a native ASIO driver. If you don't have an external sound card, you probably need to install a generic driver like ASIO4ALL. For more information scroll down to the [ASIO](#asio) section. +1. [Download Jamulus]({{ site.download_root_link }}{{ site.download_file_names.windows }}){: .button}\\ +**Mirror 2:** [SourceForge](https://sourceforge.net/projects/llcon/files/latest/download) +1. **Install Jamulus**: Double click the installer to launch it. If you get a warning notice from SmartScreen, click on "More info" and "Run anyway" to install Jamulus. (If you grabbed a new version of Jamulus and are one of the first people who downloaded it, Jamulus won't be whitelisted by SmartScreen yet. We don't pay for code signing.) 1. **Run Jamulus**. Now you should be able to use Jamulus just like any other application. -1. **Setup your sound card**. When you're done, you need to setup your audio hardware. Have a look at how to setup ASIO4All if you you're using that ([scroll down](#setting-up-asio4all)), and afterwards at [Hardware Setup](Hardware-Setup). - -You can also [compile your own binary](Compiling) if you feel so inclined. +1. **Set up your sound card**. When you're done, you need to set up your audio hardware. Have a look at how to set up ASIO4ALL if you're using that and/or [Hardware Setup](Hardware-Setup). *** + ## ASIO -### Setting up ASIO4All -*Most internal soundcards need this driver. ASIO4All is not recommended if your audio interface provides its own ASIO driver, since that might have better latency.* +Jamulus uses [ASIO](https://en.wikipedia.org/wiki/Audio_Stream_Input/Output) to provide the lowest latency. +* If you own an external sound card/audio interface, use its official ASIO driver (they usually provide the best quality). +* If you don't have an external sound card, you will probably not have an ASIO driver. Therefore, you will need to install a generic one like ASIO4ALL: + +You can try two versions of ASIO4ALL. ASIO4ALL v2.14 includes a workaround for a bug which might break other functionality. + +[ASIO4ALL v2.14 Download](https://github.com/jamulussoftware/assets/raw/main/ASIO4ALL/v2.14/ASIO4ALL_2_14_English.exe){: .button target="_blank" rel="noopener noreferrer"} + +[ASIO4ALL v2.13 Download](https://github.com/jamulussoftware/assets/raw/main/ASIO4ALL/v2.13/ASIO4ALL_2_13_English.exe){: .button target="_blank" rel="noopener noreferrer"} + +[ASIO4ALL website](https://www.asio4all.org/){: target="_blank" rel="noopener noreferrer"} + + +### Setting up ASIO4ALL +*ASIO4ALL is not recommended if your sound card/audio interface provides its own ASIO driver, since that might have better latency.* + +For ASIO4ALL, you may need to experiment a bit to find the right configuration since every computer is a bit different. + +**Tip:** Set up your sound card while you're [connected to a server](Onboarding#2-connecting-to-a-server) to hear your instrument or voice and check if everything is correctly set up; but first read on. -For ASIO4All ([download](http://www.asio4all.org){: target="_blank" rel="noopener noreferrer"}), you may need to experiment a bit to find the right configuration since every computer is a bit different. Setup your soundcard while you're connected to a server to hear your instrument or voice and check if everything is correctly setup. Before you start with Jamulus: -1. **Close all applications** (especially those which could access your soundcard like your browser/media player) since Jamulus needs exclusive access to your sound card. -1. If the audio doesn’t work out of the box, make sure that only the **correct inputs/outputs** in ASIO4All **are switched on**. Everything else should be switched off. This can be done as follows: +1. **Close all applications** (especially those which could access your sound card like your browser/media player) since Jamulus needs exclusive access to your sound card. Other programs will not be able to use audio if ASIO4ALL and Jamulus are running. +1. If the Jamulus audio doesn’t work out of the box, make sure that only the **correct inputs/outputs** in ASIO4ALL **are switched on**. Everything else should be switched off. This can be done as follows: -### How to setup ASIO4All inputs (Guide) +### How to set up ASIO4ALL inputs (Guide) 1. Open Jamulus's settings -1. Go to _"ASIO Settings"_ -1. Enable _advanced view_ in ASIO4All (click the tool icon on the bottom right) -1. Enable only the soundcard you want to use by clicking on the button next to its name -1. Open your soundcard inputs by clicking the _plus icon_ next to this soundcard -1. Now enable the correct inputs/outputs in the list under your soundcard and disable everything else +1. Go to _"ASIO Device Settings"_ (column on the left; directly under the selection of the driver) +1. Enable _advanced view_ in ASIO4ALL (click the tool icon on the bottom right) +1. Enable only the sound card you want to use by clicking on the button next to its name +1. Open your sound card inputs/outputs by clicking the _plus icon_ next to this sound card +1. Now enable the correct inputs/outputs in the list under your sound card and disable everything else. You can hover over the inputs/outputs to see which of both they are and if they support the required sample rate for Jamulus of 48kHz (DVD quality). + +**Hints:** +1. Many internal sound cards are named Realtek High Definition Audio, Conexant or similar. +1. Headphones and speakers are often labelled as output and microphones as inputs or capture. +1. Stereo Mix is usually not the input/output you're looking for and therefore you should switch it off if you see it. -**Hint:** Many internal sound cards are named Realtek High Definition Audio, Conexant or similar. Concerning the inputs/outputs: Headphones and speakers are often labelled as output and microphones as inputs or capture. Stereo Mix is usually not the input/output you search for, therefore you can switch it off, if you see it. +### Having trouble setting up ASIO4ALL? -### Having trouble with ASIO4All setup? +If nothing works, first restart Jamulus and/or your PC to close background processes that may be accessing your sound card. -If nothing works, first of all try to **restart Jamulus and/or your PC**. -Afterwards try to **setup the inputs/outputs again**. Enabled and accessible inputs/outputs show a lit up on/off button and a play button. If you see a red cross or a yellow symbol, you might need to close other applications like your browser, Zoom, ... +Afterwards, *set up the inputs/outputs again*. Enabled and accessible input/outputs show as lit up power buttons and play buttons. If instead you see a red cross or yellow symbol, close other applications that may be accessing your sound card (e.g. browser, Zoom, etc). -Have a look at [this video](https://youtu.be/_GzOsitVgLI){: target="_blank" rel="noopener noreferrer"} from @trombonepizza which gives more detailed setup information on ASIO4All. +Have a look at [this video](https://youtu.be/_GzOsitVgLI) by [trombonepizza](https://github.com/trombonepizza) which gives more detailed setup information on ASIO4ALL. -Official and more detailed information about how to configure ASIO4All is documented in the official [ASIO4All FAQs on the ASIO4All website](http://www.asio4all.org/faq.html){: target="_blank" rel="noopener noreferrer"} and in the ASIO4All manual. This can most likely be found on your desktop or in the folder where the ASIO4All binary is installed (usually `C:\Program Files (x86)\ASIO4ALL v2\`). +Official and further information about how to configure ASIO4ALL is documented in the official [ASIO4ALL FAQs on the ASIO4ALL website](https://www.asio4all.org/index.php/help/faq/){: target="_blank" rel="noopener noreferrer"} and in the ASIO4ALL manual which can be found on your desktop or in the folder where the ASIO4ALL binary is installed (usually `C:\Program Files (x86)\ASIO4ALL v2\`)). ## All installed? diff --git a/wiki/en/en-Linux-Install-Script.md b/wiki/en/en-Linux-Install-Script.md index 2bae49110..23c37954b 100644 --- a/wiki/en/en-Linux-Install-Script.md +++ b/wiki/en/en-Linux-Install-Script.md @@ -1,142 +1,8 @@ --- -layout: wiki -title: "Jamulus Tips & Tricks - Linux Bash Installation Script" +layout: redirect +redirect: "/kb/2020/09/20/Linux-Install-Script.html" lang: "en" permalink: "/wiki/Linux-Client-Install-Script" ---- - - -# Linux Bash Script for Download and Compile - -If you plan to be installing Jamulus on many Linux machines, you may want to try this script. - -The following example was tested on Linux Mint and combins all the commands above into one script for Ubuntu/Linux Mint. To incorporate the different command for different Linux distributions variables define the distribution and the release for which the installation script should be performed. Example focuses on Ubuntu with release 18.04 as example. So the suggested script name for the release is e.g. `install4ubuntu18_4.sh`. The script commands are generic so that the installation could also be modified so that they work on other linux distributions. - -### Installation dependent on Linux Distribution -The following script call different installation commands dependent on the Linux distribution. -The variable `DISTRO` defines which commands are executed. Set the variable dependent on your Linux distribution you are using. -* `DISTRO="Ubuntu` for a Ubuntu or Linux Mint -* `DISTRO="Debian` for a Debian or Raspian Linux -* `DISTRO="Fedora` for a Fedora Linux -Furthermore if the installation is dependent of the release the variable `LINVERSION` is introduced but is currently not used. In the Ubuntu if statement there is an example how version dependent installation calls can be performed. -```bash -if [ "$LINVERSION" = "18.4" ] -then - echo "Perform Installation Specifics for $DISTRO Version $DISTRO" -fi -``` -The variable `LINVERSION` is currently not used in the following script but it is just a demo how to use the version specific installation commands. - -### Adaptation of the Installation Script -If you want to create an installation script for Debian just copy the script `install4ubuntu18_4.sh` to `install4debian10_6.sh` and modify the distro variables to -```bash -#!/bin/sh -# set DISTRO either to "Ubuntu", "Debian" or "Fedora" -DISTRO="Debian" -LINVERSION="10.6" -``` -After that test the installation on Debian and modify the commands so that the installation script works on Debian. Please share working installation scripts in this Wiki. The maintainer of this repository might add a folder in this repository `/install_scripts` for working installation scripts. Create a pull request for new installation scripts or create an issue with a request to add a documented and tested installation script to this repository. - -### The Installation Script -Copy the following installation script into a file and save it to the filename `install4ubuntu18_4.sh`. After saving the file e.g. in your `Download` directory change to the directory and call the following script with `sh install4ubuntu18_4.sh`. -```bash -#!/bin/sh -# set DISTRO either to "Ubuntu", "Debian" or "Fedora" -DISTRO="Ubuntu" -LINVERSION="18.04" - -# Get Jamulus Release Name with "curl" and "grep" -R=`curl -s https://api.github.com/repos/corrados/jamulus/releases/latest | grep -oP '"tag_name": "\K(.*)(?=")'` -echo "Jamulus Installation Script for $DISTRO $LINVERSION" -echo "Release: $R" -INSTALLJAMULUS="no" -while true; do - read -p "Do you wish to install Jamulus on $DISTRO $LINVERSION? (y/n) " yn - case $yn in - [Yy]* ) - echo "Start Installation $DISTRO $LINVERSION" - echo "(1) Fetch Release $R from GitHub" - wget https://github.com/corrados/jamulus/archive/$R.tar.gz - echo "(2) Extract Source Code for Jamulus Release $R from GitHub" - tar -xvf $R.tar.gz - echo "(3) Delete ${R}.tar.gz from GitHub" - rm $R.tar.gz - echo "(4) Update Repository" - sudo apt-get update - INSTALLJAMULUS="yes" - break;; - [Nn]* ) - echo "Cancelled Jamulus Installation on $DISTRO $LINVERSION" - exit;; - * ) echo "Please answer yes or no.";; - esac -done - -# echo "Check Variable: $INSTALLJAMULUS" - -if [ "$INSTALLJAMULUS" = "yes" ]; then - echo "(5) Install Build Essentials for $DISTRO" - - if [ "$DISTRO" = "Ubuntu" ] - then - echo "Installation for $DISTRO" - sudo apt-get install cmake qmake gcc g++ - sudo apt-get install build-essential qt5-qmake qtdeclarative5-dev qt5-default qttools5-dev-tools libjack-jackd2-dev - sudo apt-get install qjackctl - if [ "$LINVERSION" = "18.4" ] - then - echo "Perform Installation Specifics for $DISTRO Version $DISTRO" - fi - - elif [ "$DISTRO" = "Debian" ] - then - sudo apt-get install build-essential qtdeclarative5-dev qt5-default qttools5-dev-tools libjack-jackd2-dev - sudo apt-get install qjackctl - elif [ "$DISTRO" = "Fedora" ] - then - sudo dnf install qt5-qtdeclarative-devel jack-audio-connection-kit-dbus jack-audio-connection-kit-devel - sudo dnf install qjackctl - fi - - echo "(6) Compile Jamulus $R" - echo "Change to Directory jamulus-$R" - cd "jamulus-$R" - # ls - qmake Jamulus.pro - make clean - make - sudo make install - echo "Compilation DONE" - cd .. - echo "(6) Delete the Source Files after Installation" - rm -R "jamulus-$R" - -else - - echo "Installation cancelled" - -fi - -``` - - -## Possible Improvements of the Installation Script for Jamulus -The script can ask in the very beginning for which linux distribution the installation script should be called. -This can be tested with the command `lsb_release` - -With the `lsb_release` command the command returns the distribution specific information about a Linux distro. -With a `grep` command with regular expression the variable `DISTRO` and `LINVERSION`. -E.g. the Ubuntu based systems return with the command the following information. -```bash -$ lsb_release -a -No LSB modules are available. -Distributor ID: Ubuntu -Description: Ubuntu 11.04 -Release: 11.04 -Codename: natty -``` - -The challenge is, that `lsb_release` command must be available on Linux system. On CentOS/Fedora based systems `lsb_release` command is only available, if the `lsb` core packages are installed. So the automated Linux version detected might no work. - -So reading the `DISTRO` and `LINVERION` with the `read` command might be the better distribution dependent improvement than an automated setting with `lsb_release`. +category: "hidden" +--- diff --git a/wiki/en/en-Multiple-Audio-Interfaces.md b/wiki/en/en-Multiple-Audio-Interfaces.md index 3e25bf45f..725dd5038 100644 --- a/wiki/en/en-Multiple-Audio-Interfaces.md +++ b/wiki/en/en-Multiple-Audio-Interfaces.md @@ -1,58 +1,7 @@ --- -layout: wiki -title: "Using Multiple Audio Interfaces" +layout: redirect +redirect: "/kb/2020/11/24/Multiple-Audio-Interfaces.html" lang: "en" permalink: "/wiki/Running-Jamulus-with-Multiple-Audio-Interfaces" +category: "hidden" --- - - -# Using Multiple Audio Interfaces - -It is possible to run Jamulus with multiple Audio Interfaces on all three operating systems. Useful when we need to output an instrument through external audio card for minimal latency and computer microphone for communication. Other use cases may apply. - - -### Windows - -Under Windows, the best option to run multiple interfaces through Jamulus at the same time is by using a combination of JACK Audio Connection Kit with VoiceMeeter. It can be accomplished with just VoiceMeeter, but I've found that it introduces some undesirable latency and it wasn't supporting 64 frame buffer size correctly as it was producing some noises through my headphones. - -**Requirements:** -* [JACK for Windows](https://jackaudio.org/downloads/); -* [Voicemeeter](https://www.vb-audio.com/Voicemeeter/banana.htm) (any version will do). - -**Steps:** -1. [Install and configure JACK on Windows](https://jackaudio.org/faq/jack_on_windows.html) - Make sure you select your best audio interface in the configuration steps, also add `-r 48000 -p ` to ensure JACK is outputting audio in the required sample rate for Jamulus (48.000Hz). If your frame buffer size is too low for your hardware, you'll need to change it to a higher value; -2. Install and open Voicemeeter; -3. Open configured Jack PortAudio shortcut, Jack Control and Jamulus software; -4. On Voicemeeter, go to HARDWARE OUT and on A1 dropdown list, select JackRouter. On Hardware Input 1 select your computer microphone. You can make your computer microphone have the lowest latency possible by going into _Menu > System Settings/Options..._ and enabling _WDM Input Exclusive Mode_ (if you experience crackling noises while speaking, disable this) and changing the _Engine Mode_ to _Swift_; -5. Make sure the Hardware Input where you selected your microphone is sending sound through A1 by enabling the corresponding button next to the fader; -6. On Jamulus, under Settings, select JackRouter as your Soundcard Device; -7. On Jack Control, if you click the _Connect_ button, you should now see three devices: portaudio (your external audio interface), voicemeeter and jamulus. If Jamulus doesn't appear, try connecting and disconnecting from any server to enable it; -8. To test things out, on Jack Control, connect portaudio and voicemeeter output ports to jamulus input ports, then connect jamulus output ports to portaudio input ports (assuming you'll be using your external audio interface to listen, otherwise you can use voicemeeter to redirect the sound to another device, which I will not cover on this guide). Connect to a server on Jamulus and test it out by speaking into the microphone and playing your instrument. If everything went well you should hear yourself; -9. To make JACK connections permanent, on Jack Control, open the _Patchbay_, add all inputs and outputs available (Add... > Select each Client > Click Add Plug until there's none left) and make the connections you wish to make permanent. This usually goes like connecting both _system_ and _voicemeeter_ outputs into _jamulus_ input, and _jamulus_ output into _system_ input. Once done, save the Patchbay definition and _Activate_ it. Now every time you start jamulus and connect to a server, the connections on JACK should automatically be done. - -**Bonus:** - -* The Microphone can be muted and it's volume adjusted on VoiceMeeter. Be sure to play with the _VOICE_ graph too (equalization), I find that my voice sounds better if I move it halfway into _Lo_; -* If you're using VoiceMeeter Banana or Potato, you can apply Gate to your microphone (useful to cut undesirable noises when you're not speaking); -* If you set your default playback device under Windows to one of VoiceMeeter's virtual inputs, you can route audio from your computer into JackRouter (and consequently, into Jamulus) by enabling the _A1_ button on the relevant input under _Virtual Inputs_. This is useful if you wish to play some audio through Jamulus (backing tracks, youtube, recordings, etc...) - - -### macOS - -[Aggregate devices](https://support.apple.com/en-us/HT202000) lets you do this. Just make sure your Jamulus version is 3.5.3 or higher. - - -### Linux - -On Linux, it is possible to route additional devices to Jack by using alsa_in. - -**Requirements:** - -* QJackCtl -* alsa - -**Steps:** -1. Follow [this tutorial](https://www.penguinproducer.com/Blog/2011/11/using-multiple-devices-with-jack/) to route the desired interface into Jack by using alsa_in. -2. Jamulus should automatically route the JACK configured interface, adjustments can be made through the _Connect_ button. -3. Connect the device configured on step 1 into jamulus input. -4. Use Patchbay as described on Windows section to make connections permanent. diff --git a/wiki/en/en-Network-Requirements.md b/wiki/en/en-Network-Requirements.md index f5fc506dc..8e9dcc539 100644 --- a/wiki/en/en-Network-Requirements.md +++ b/wiki/en/en-Network-Requirements.md @@ -1,37 +1,38 @@ --- layout: wiki -title: "Quality, Delay and Network Bandwidth" +title: "Quality, Delay and Bandwidth" lang: "en" permalink: "/wiki/Network-Requirements" --- +{% include breadcrumb.html root="More" branch1="Running a Server" branch1-url="Running-a-Server" %} + # Network Requirements ## Audio bandwidth -The audio settings have an impact on the required network bandwidth. The below table summarizes the network requirements with respect to the configuration of: -* channels : stereo/mono -* quality : high/medium/low -* audio buffer duration : 2.67ms, 5.33ms, 10.67ms, 21.33ms +The audio settings have an impact on the required network bandwidth. The table below summarises network requirements with respect to the configuration of: +* Channels : stereo/mono +* Quality : high/medium/low +* Audio buffer duration : 2.67 ms, 5.33 ms, 10.67 ms, 21.33 ms With the following units * ms : milliseconds -* Kbps : Kilo-bits per seconds (Reminder : 1Mbps = 1024Kbps, 1KByte = 8Kbits) -* Mbps : Mega-bits per seconds +* Kbit/s : Kilo-bits per second (Reminder : 1 Mbit/s = 1024 Kbit/s, 1 KByte/s = 8 Kbit/s) +* Mbit/s : Mega-bits per second -| Channels | Quality | Bandwidth (for buffer : 2.67ms) | Bandwidth (for buffer : 5.33ms) | Bandwidth (for buffer : 10.67ms) | Bandwidth (for buffer : 21.33ms) | +| Channels | Quality | Bandwidth (for buffer : 2.67 ms) | Bandwidth (for buffer : 5.33 ms) | Bandwidth (for buffer : 10.67 ms) | Bandwidth (for buffer : 21.33 ms) | | --------- | ------ | -------- | -------- | -------- | -------- | -| Stereo | High | 894 Kbps | 657 Kbps | 541 Kbps | 483 Kbps | -| Stereo | Medium | 672 Kbps | 444 Kbps | 328 Kbps | 270 Kbps | -| Stereo | Low | 606 Kbps | 372 Kbps | 256 Kbps | 198 Kbps | -| Mono | High | 672 Kbps | 444 Kbps | 328 Kbps | 270 Kbps | -| Mono | Medium | 594 Kbps | 366 Kbps | 250 Kbps | 192 Kbps | -| Mono | Low | 534 Kbps | 306 Kbps | 190 Kbps | 132 Kbps | +| Stereo | High | 894 Kbit/s | 657 Kbit/s | 541 Kbit/s | 483 Kbit/s | +| Stereo | Medium | 672 Kbit/s | 444 Kbit/s | 328 Kbit/s | 270 Kbit/s | +| Stereo | Low | 606 Kbit/s | 372 Kbit/s | 256 Kbit/s | 198 Kbit/s | +| Mono | High | 672 Kbit/s | 444 Kbit/s | 328 Kbit/s | 270 Kbit/s | +| Mono | Medium | 594 Kbit/s | 366 Kbit/s | 250 Kbit/s | 192 Kbit/s | +| Mono | Low | 534 Kbit/s | 306 Kbit/s | 190 Kbit/s | 132 Kbit/s | ## Network bandwidth There is one upstream (musician sending to the server) and one downstream (server sending back the mix to the musician) ![image](https://user-images.githubusercontent.com/9976944/79274940-999b0b00-7ea5-11ea-85be-3ded5ee198d5.png) -Note also that mean ADSL2 transfer rate is 10 Mbits/second for downstream and 1 Mbit/second for upstream. The actual performance depends on distance to the provider, which may [theoretically range from 24Mb/s at 0.3km to 1.5Mb/s at 5.2km](https://en.wikipedia.org/wiki/Asymmetric_digital_subscriber_line) for download rate. - +Note also that mean ADSL2 transfer rate is 10 Mbit/s for downstream and 1 Mbit/s for upstream. The actual performance depends on distance to the provider, which may [theoretically range from 24 Mbit/s at 0.3 km to 1.5 Mbit/s at 5.2 km](https://en.wikipedia.org/wiki/Asymmetric_digital_subscriber_line) for download rate. diff --git a/wiki/en/en-Onboarding.md b/wiki/en/en-Onboarding.md index d20f3c197..e43175e25 100644 --- a/wiki/en/en-Onboarding.md +++ b/wiki/en/en-Onboarding.md @@ -5,15 +5,21 @@ lang: "en" permalink: "/wiki/Onboarding" --- # Jamulus onboarding -Let's have a look at what Jamulus looks like and what you should do after having installed the software. +Let's have a look at what you should do after having installed the software. ## First start Before you start Jamulus: 1. For now, **close all other applications**. It's best to start from zero at first. -2. **Connect everything** (Ethernet cable, audio gear, etc.) +1. **Connect everything** (Ethernet cable, audio gear, etc.) ... to *minimise load* on your computer and to ensure that *no other application* tries to use your sound card. -You can have a look at [Hardware Setup](Hardware-Setup) for more information on what to do with your equipment. If you need help setting up ASIO4All on Windows, have a look at the [ASIO4All Setup guide on the Windows installation page](Installation-for-Windows#setting-up-asio4all). +### Setting up your audio +If you haven't done this already, please do so by plugging in your hardware (if you need to), opening Jamulus's settings and selecting your input/output devices. + +* If you need help setting up ASIO4ALL on Windows, have a look at the [ASIO4ALL Setup guide on the Windows installation page](Installation-for-Windows#setting-up-asio4all). +* macOS users just need to select their input/output devices in Jamulus's settings. + +You can also have a look at [Hardware Setup](Hardware-Setup) for more information on what to do with your equipment. ### Jamulus main window When you open Jamulus, you will see a window which looks like this: @@ -21,7 +27,7 @@ When you open Jamulus, you will see a window which looks like this: ![Jamulus main window](https://user-images.githubusercontent.com/20726856/100796017-4cfa4500-3420-11eb-9d35-aa206d392a5a.png) ### 1. Setting up a profile -To let others know who you are, you should set up your *profile*. To do so, click on "View" (bar on the top)>"My Profile..." +To let others know who you are, you should set up your *profile*. To do so, click on "View" (bar on the top) > "My Profile..." Now you will see this: ![Musician Profile](https://user-images.githubusercontent.com/20726856/100796411-e590c500-3420-11eb-9b62-e50d02cb009b.png) @@ -29,7 +35,12 @@ Now you will see this: Fill in at least "Alias/Name" to set your name and close the window. ### 2. Connecting to a server -Now you are set up, you can use the "Connect" button in the Jamulus main window to join a server. A window will now open in which you can find *servers grouped by genre*. To select another genre, select one from the list in the top left. After having selected a genre and server, join a server by clicking on "Connect". If you have problems here, they are most likely due to wrongly configured audio gear or network issues. Have a look at the [Troubleshooting page](Client-Troubleshooting). +Now you are set up, you can use the "Connect" button in the Jamulus main window to join a server. A window will now open: + +![Connection Setup](https://user-images.githubusercontent.com/20726856/102825226-a1b92c00-43de-11eb-9aa9-21d7a8576f5c.png) + +This window shows *servers grouped by genre*. To select another genre, select one from the list in the top left. After having selected a genre and server, join a server by clicking on "Connect". If you have problems here, they are most likely due to wrongly configured audio gear or network issues. Have a look at the [Troubleshooting page](Client-Troubleshooting). + ### The first Jam Congrats! You can now start jamming with Jamulus. The sliders you see on the right are your own personal mix. Everything you change here will change what you hear, but won't affect others. If you move a slider down, that user will be quieter, if you move it up, that user will be louder for you. @@ -42,15 +53,17 @@ While we're already here: "Settings" opens – of course – the settings window More information about using Jamulus can be found in the [Software Manual](Software-Manual). ## Advanced - + Of course, you can do a lot more with Jamulus (like setting up a private server, doing online concerts,...). Have a look at the navigation on this website. Furthermore, the community publishes guides, tips, tricks in the [knowledge base](/kb/). ## Help and Community If you need help or want to contribute to the Jamulus Project, you can have a look at the following links: ### Discussion Forums -For help, chat, and general discussions about Jamulus: Have a look at the [forums on SourceForge](https://sourceforge.net/p/llcon/discussion/). +For help, chat, and general discussions about Jamulus: Have a look at the [forums on GitHub](https://github.com/jamulussoftware/jamulus/discussions). ### Development and contribution -If you want to contribute to the Jamulus Software, have a look at the [Jamulus GitHub repository](https://github.com/corrados/jamulus/) and read the contributing file there. + +If you want to contribute to the Jamulus Software, have a look at the [Jamulus GitHub repository](https://github.com/jamulussoftware/jamulus/) and read the `CONTRIBUTING.md` file there. + diff --git a/wiki/en/en-Privacy-Statement.md b/wiki/en/en-Privacy-Statement.md index a9178ca17..e5ea4bb41 100644 --- a/wiki/en/en-Privacy-Statement.md +++ b/wiki/en/en-Privacy-Statement.md @@ -16,15 +16,15 @@ We do not set tracking cookies, although SourceForge might do so. If you do not When you connect to a public or private Jamulus server, whatever you put in My Profile (in Settings) will be shown to others on that server while you are connected to it. The server does not otherwise store or record your Profile information and the server operator has no access to it unless they are also connected as a client. -When you connect to a public server, your profile is also available to third parties from the Central Server to which that server is registered. This is can be for informational purposes about the status of the public Jamulus network (for example, [here](http://explorer.jamulus.io/)), but may not be limited to that. Profile information is not otherwise logged or stored by the Jamulus server you are connected to, or by the Jamulus Central Server, but may be stored or processed by third parties. +When you connect to a public server, your profile is also available to third parties from the Central Server to which that server is registered. This is can be for informational purposes about the status of the public Jamulus network (for example, [here](https://explorer.jamulus.io/)), but may not be limited to that. Profile information is not otherwise logged or stored by the Jamulus server you are connected to, or by the Jamulus Central Server, but may be stored or processed by third parties. ### Use of IP Addresses When you connect to a public or private server, the server operator can see your IP address while you are connected. If the server operator has enabled logging (which is off by default) your IP address will also be logged and stored in the server's log file. -As a server operator, when you register a public server with a Central Server, your IP address is sent to CloudFlare (1.1.1.1) in order to identify your public IP address. The IP addresses of all public servers registered with the Central Server can also be seen by third parties for informational or other purposes (for example [here](http://explorer.jamulus.io/)). Your public IP address is otherwise not logged or stored by Jamulus, but may be stored or processed by third parties. +As a server operator, when you register a public server with a Central Server, your IP address is sent to CloudFlare (1.1.1.1) in order to identify your public IP address. The IP addresses of all public servers registered with the Central Server can also be seen by third parties for informational or other purposes (for example [here](https://explorer.jamulus.io/)). Your public IP address is otherwise not logged or stored by Jamulus, but may be stored or processed by third parties. -_Users concerned by the use of CloudFlare's network can [re-compile](Compiling) the Jamulus source code to use an alternative for WELL_KNOWN_HOST/ WELL_KNOWN_PORT in [global.h](https://github.com/corrados/jamulus/blob/master/src/global.h#L111)_ +_Users concerned by the use of CloudFlare's network can [re-compile](Compiling) the Jamulus source code to use an alternative for WELL_KNOWN_HOST/ WELL_KNOWN_PORT in [global.h](https://github.com/jamulussoftware/jamulus/blob/master/src/global.h#L111)_ ### Audio Recordings diff --git a/wiki/en/en-Running-a-Private-Server.md b/wiki/en/en-Running-a-Private-Server.md index 8f898ffa0..735a2cc35 100644 --- a/wiki/en/en-Running-a-Private-Server.md +++ b/wiki/en/en-Running-a-Private-Server.md @@ -5,17 +5,19 @@ lang: "en" permalink: "/wiki/Running-a-Private-Server" --- +{% include breadcrumb.html root="Using Jamulus" branch1="Running a Server" branch1-url="Running-a-Server" %} + # Running a Private Server **_Please ensure you have read the [server overview](Running-a-Server)_** -This guide assumes you will be running a private server on your home network, but some of the issues here may also apply to those running on cloud hosts (e.g. Amazon EC2). +This guide assumes you will be running a private server on your home network, but some of the issues here may also apply to those running on cloud hosts (e.g. Amazon EC2). It is highly recommended to test your server in **public mode first** so as to narrow down any subsequent problems in private mode. ## Operating a private server behind a home network router ### Port forwarding -To run a private server, you need to setup port forwarding on your router. _(If you are curious about why you need to do this for private but not public servers, see [this footnote](#footnote-for-geeks).)_ +To run a private server, you need to set up port forwarding on your router. _(If you are curious about why you need to do this for private but not public servers, see [this footnote](#footnote-for-geeks).)_ Normally, people from outside your home network cannot see things inside it. So if you want to operate a Jamulus server at home, you need to open a hole in your router to let Jamulus clients connect to it. @@ -33,7 +35,7 @@ Once you have your router set up, you can get your external (WAN) IP address e.g * You do not need to open a port range as shown in the example above as long as you want to start only one instance of the Jamulus server on the same machine. -* If using a different port than the default port (22124) you have to enter the port number after the server name or IP address separated by a colon in the Jamulus client (e. g. jamulus.dyndns.org:22120). +* If using a different port than the default port (22124) you have to enter the port number after the server name or IP address separated by a colon in the Jamulus client (e.g. jamulus.example.org:22120). * See also this excellent [guide to running a private server](https://www.facebook.com/notes/jamulus-online-musicianssingers-jamming/how-to-create-a-private-server-for-band-rehearsals/508642543044030/) by [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a) on Facebook. diff --git a/wiki/en/en-Running-a-Server.md b/wiki/en/en-Running-a-Server.md index 1bff40cdf..6efa3d7b6 100644 --- a/wiki/en/en-Running-a-Server.md +++ b/wiki/en/en-Running-a-Server.md @@ -33,17 +33,17 @@ If you really want to run a server, it's **very important** that you read and un Many people attribute problems to the server that are in fact problems with the _client_. Much depends on the clients' [hardware](Hardware-Setup), the networks that _they_ are on, and whether they are sticking to [Rule Number One](Getting-Started#having-trouble-cant-keep-in-time). There is therefore no guarantee that you will achieve lower latency or better overall performance by having your own server. -If you plan to be playing regularly with the same people, **you are strongly advised** to first make sure that each member of the group is set up to use Jamulus properly. Do this by finding a public server with a reasonable ping time for all of you (20ms or less perhaps), all connect to that and work to fix any individual issues (verifying that they can [follow Rule Number One](Getting-Started#having-trouble-cant-keep-in-time) in particular). Use the solo technique above to prevent being interrupted if needed. +If you plan to be playing regularly with the same people, **you are strongly advised** to first make sure that each member of the group is set up to use Jamulus properly. Do this by finding a public server with a reasonable ping time for all of you (20 ms or less perhaps), all connect to that and work to fix any individual issues (verifying that they can [follow Rule Number One](Getting-Started#having-trouble-cant-keep-in-time) in particular). Use the solo technique above to prevent being interrupted if needed. -Once any issues with musicians have been solved in this way, you can then investigate hosting your own server either at home or on a cloud host such as Amazon, which may result in better latency than servers run at home. For example, [see this guide](https://www.facebook.com/notes/jamulus-online-musicianssingers-jamming/howto-idiots-guide-to-installing-jamulus-server-on-amazon-aws-lightsail-ubuntu-i/507719749802976/) to using AWS Lightsail by Jamulus user [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a) (_Facebook_) +Once any issues with musicians have been solved in this way, you can then investigate hosting your own server either at home or on a cloud host such as Amazon, which may result in better latency than servers run at home. For example, [see this guide](https://www.facebook.com/notes/jamulus-worldjam/howto-idiots-guide-to-installing-or-upgrading-a-jamulus-server-on-amazon-aws-lig/818091045662521/) for using AWS Lightsail, by Jamulus user [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a) (_Facebook_) ### Bandwidth – do you have enough? -A typical jam might have 4 people, for which you would need 200Kbps * 4 = 800Kbs (0.8Mbps) up and down. So if you have a 10Mbits down and 1Mbps up broadband connection, **you may start running out of bandwidth if a fifth player joins**, particularly if other musicians choose settings that increase their usage. You may want to [check that you have enough speed](https://fast.com) for that. [Read more about bandwidth use](Network-Requirements) at different quality settings. +A typical jam might have 4 people, for which you would need 200 Kbit/s * 4 = 800 Kbit/s (0.8 Mbit/s) up and down. So if you have a 10 Mbit/s down and 1 Mbit/s up broadband connection, **you may start running out of bandwidth if a fifth player joins**, particularly if other musicians choose settings that increase their usage. You may want to [check that you have enough speed](https://fast.com) for that. [Read more about bandwidth use](Network-Requirements) at different quality settings. ### In general -- Consider using a cloud host to get better ping times if you having problems +- Consider using a cloud host to get better ping times if you're having problems - Any server should have at least 1.6GHz CPU frequency and 1GB RAM @@ -58,10 +58,11 @@ A typical jam might have 4 people, for which you would need 200Kbps * 4 = 800Kbs -Server operators may also be interested in downloading [this set of useful tools](https://github.com/corrados/jamulus/tree/master/tools) from the Jamulus repository (clone the Git repo and also call `git submodule update --init`). +If you want to run a server on a Raspberry Pi, have a look at the [guide for Raspberry Pi](/kb/2020/03/28/Server-Rpi.html) by fredsiva. + +Server operators may also be interested in downloading [this set of useful tools](https://github.com/jamulussoftware/jamulus/tree/master/tools) from the Jamulus repository (clone the Git repo and also call `git submodule update --init`). ## Having problems? Got issues? diff --git a/wiki/en/en-Server-Linux.md b/wiki/en/en-Server-Linux.md index 172e0f3b6..40faa48de 100644 --- a/wiki/en/en-Server-Linux.md +++ b/wiki/en/en-Server-Linux.md @@ -5,6 +5,8 @@ lang: "en" permalink: "/wiki/Server-Linux" --- +{% include breadcrumb.html root="Using Jamulus" branch1="Running a Server" branch1-url="Running-a-Server" %} + # Server Installation - Linux @@ -20,7 +22,7 @@ If you plan to run a server on your desktop machine (and you have installed the Hit return and you should see the server control window. You can stop the server by closing the server window, or by typing CTRL+C in the terminal. -**To configure the server**, please refer to [the Windows & Macintosh instructions](Server-Win-Mac). +**To configure the server**, please refer to [the Windows & macOS instructions](Server-Win-Mac). See also [Command Line Options](Command-Line-Options) for other parameters you can set. @@ -30,6 +32,20 @@ The following guide is for running Jamulus as a "pure" server on **hardware with * _Jamulus user [Grigory](https://sourceforge.net/u/cidnurg/profile/) maintains a **[Docker image for Jamulus](https://hub.docker.com/r/grundic/jamulus)** which you can use._ +### Use the official Debian/Ubuntu headless .deb files + +If you're on amd64 Debian/Ubuntu, you may try the compiled .deb packages from GitHub Actions: + +1. Download the [latest headless .deb file]({{ site.download_root_link }}{{ site.download_file_names.deb-headless }}) +1. Update apt: `sudo apt update` +1. Install the package: `sudo apt install /path/to/{{ site.download_file_names.deb-gui }}` +1. Enable the headless server via systemd: `sudo systemctl enable jamulus-headless` +1. Add the required [command line options](Command-Line-Options) to the systemd service file in `/lib/systemd/system/jamulus-headless.service`. +1. Reload systemd files `sudo systemctl daemon-reload` and restart the headless server: `sudo systemctl restart jamulus-headless` + +You should now be running a private server! + +**Note:** To configure the server, you can add command line flags to the file `/lib/systemd/system/jamulus-headless.service` e.g. make this a public server. Have a look at the [Command Line Options](Command-Line-Options) page. ### Compile sources, create a user @@ -143,7 +159,7 @@ Note: Press `q` to exit the service status. ### To update your installation to a new release -Download the new sources as per the [instructions above](Server-Linux#compile-sources-create-a-user) and repeat the compilation in step 2 as if for a new installation. Shut down the server, copy the Jamulus binary over the old one and start it back up. +Download the new sources as per the [instructions above](Server-Linux#compile-sources-create-a-user) and repeat the compilation in step 2 as if for a new installation or just install the new headless .deb files. If you compiled Jamulus from source, shut down the server, copy the Jamulus binary over the old one and start it back up. *** @@ -155,7 +171,9 @@ See also [Command Line Options](Command-Line-Options) for other parameters you c When using the [recording function](Server-Win-Mac#recording) with the `-R` [command line option](Command-Line-Options), if the server receives a SIGUSR1 signal during a recording, it will start a new recording in a new directory. SIGUSR2 will toggle recording enabled on/off. -To send these signals using systemd, create the following two `.service` files in `/etc/systemd/system`, calling them something appropriate (eg `newRecording-Jamulus-server.service`). +To send these signals using systemd, create the following two `.service` files in `/etc/systemd/system`, calling them something appropriate (e.g. `newRecording-Jamulus-server.service`). + +**Note:** You will need to save recordings to a path _outside_ of the jamulus home directory, or remove `ProtectHome=true` from your systemd unit file (be aware that doing so is however a potential security risk). For turning recording on or off (depending on the current state): @@ -193,7 +211,7 @@ You can see the result of these commands if you run `service jamulus status`, or ### Viewing The Logs -Jamulus will log to the system file if you left the `StandardOutput=journal` setting in the unit file. Logging to the system log is recommended, as the system will manage the log file for you, no need to come back and purge it later, or worry about filling up your disk space. +Jamulus will log to the system file if you left the `StandardOutput=journal` setting in the unit file. Logging to the system log is recommended, as the system will manage the log file for you - no need to come back and purge it later or worry about filling up your disk space. To view the log, use `journalctl` (to exit press Ctrl-C). For example, to read the system log file, filtered for the Jamulus service: diff --git a/wiki/en/en-Server-Rpi.md b/wiki/en/en-Server-Rpi.md index 4d069dd98..452faa121 100644 --- a/wiki/en/en-Server-Rpi.md +++ b/wiki/en/en-Server-Rpi.md @@ -1,52 +1,7 @@ --- -layout: wiki -title: "Server Installation – Raspberry Pi" +layout: redirect +redirect: "/kb/2020/03/28/Server-Rpi.html" lang: "en" permalink: "/wiki/Server-Rpi" +category: "hidden" --- - -# Server Installation - Raspberry Pi - -**_Please ensure you have read the [server overview](Running-a-Server)_** - -_Jamulus has been tested on a Raspberry Pi 4 2Gb by Jamulus user [SIVA Frédéric](https://sourceforge.net/u/fredsiva/profile/)_ - -1. Install Raspbian Buster (allow [VNC](https://www.raspberrypi.org/documentation/remote-access/vnc/) and [SSH](https://www.raspberrypi.org/documentation/remote-access/ssh/README.md) for comfort, but will ultimately run without VNC for higher speed) - -1. Edit [config.txt](https://www.raspberrypi.org/documentation/configuration/config-txt/) to enable boot without HDMI by adding `hdmi_force_hotplug=0` - -1. [Get the sources](Installation-for-Linux#get-jamulus-sources), install the [dependent packages](Installation-for-Linux#install-dependencies) according to the Linux client install guide **but do NOT install JACK package(s)** - you don't need them on a [headless server](Server-Linux#running-a-headless-server). To run a client, install all listed dependencies. - -1. Compile the source code for a server as per [these instructions](Server-Linux#compile-sources-create-a-user). Compile a client using the [default instructions](Installation-for-Linux#compile-this-bad-boy). - -This will build Jamulus and put it in `/usr/local/bin/Jamulus` - -Connect Raspberry Pi with Ethernet cable to your router. - -If you are running a server, test by starting with the `--server` option, and watch GUI on VNC (or HDMI). When running as a client, you should see the GUI start. - -`Jamulus -s` - -If all is well, run in your chosen [server mode](Choosing-a-Server-Type) as follows (or use systemd unit script provided in the [Linux guide](Server-Linux#create-a-start-script)), for example a public server: - -`sudo chrt 99 ionice -c1 nice -n -20 Jamulus -s -n -e [yourCentralServer] -o "yourServerName;yourCity;[country ID]"&` - -**Please also see this [important note on Central Servers](Central-Servers).** - -See also [Command Line Options](Command-Line-Options) for other parameters you can set. -*** - -### To upgrade Jamulus - -Stop the server and simply repeat step 3 for obtaining the sources and installing above. - -If you want to install a specific release, you can do the following using git (where `[RELEASE]` is a release ID such as r3_5_8). See the [official tagged releases](https://github.com/corrados/jamulus/releases). - -First, `cd` inside the directory in which the Jamulus sources were unpacked/downloaded, then use the following commands: - -~~~ -git pull -git checkout [RELEASE] -~~~ - -Then compile the sources as per a new install. Start Jamulus back up. diff --git a/wiki/en/en-Server-Troubleshooting.md b/wiki/en/en-Server-Troubleshooting.md index e4f6c2fb5..bcf52477d 100644 --- a/wiki/en/en-Server-Troubleshooting.md +++ b/wiki/en/en-Server-Troubleshooting.md @@ -5,17 +5,19 @@ lang: "en" permalink: "/wiki/Server-Troubleshooting" --- +{% include breadcrumb.html root="Using Jamulus" branch1="Running a Server" branch1-url="Running-a-Server" %} + # Troubleshooting ## Servers - Public -### Why doesn't my server show up in the list? Why isn't in registering? +### Why doesn't my server show up in the list? Why isn't it registering? -If you are registered OK (you can [see it here](http://explorer.jamulus.io/)) and you or your friends can't see your server, you may need to wait, or start your client with the `--showallservers` option and try connecting from there ([see this page](Command-Line-Options) on how to start your client with a config option). +If you are registered OK (you can [see it here](https://explorer.jamulus.io/)) and you or your friends can't see your server, you may need to wait, or start your client with the `--showallservers` option and try connecting from there ([see this page](Command-Line-Options) on how to start your client with a config option). If you are seeing a message that says the server is full, please [see this note](Central-Servers) on Central Servers. -You can verify that your server is listed in the relevant genre by [checking it here](http://explorer.jamulus.io/). +You can verify that your server is listed in the relevant genre by [checking it here](https://explorer.jamulus.io/). ## Servers - Private @@ -37,7 +39,7 @@ Yes. Please see [Server Types](Choosing-a-Server-Type) ### Can I convert my private server to being a public one? -Yes. Simply check the "Make my Server Public" box in the server window and fill out the details. Remember that you also do not need to port forward if you have a public server. +Yes. Simply check the "Make my Server Public" box in the server window and fill out the details. If you register your server, do not use port forwarding as it may prevent others using your server. ### **_Headless Linux_**: I have created a server but it is joining the Central Server and I don't want it to. diff --git a/wiki/en/en-Server-Win-Mac.md b/wiki/en/en-Server-Win-Mac.md index b8fb7b3c6..b9eadc067 100644 --- a/wiki/en/en-Server-Win-Mac.md +++ b/wiki/en/en-Server-Win-Mac.md @@ -5,6 +5,8 @@ lang: "en" permalink: "/wiki/Server-Win-Mac" --- +{% include breadcrumb.html root="Using Jamulus" branch1="Running a Server" branch1-url="Running-a-Server" %} + # Installation for Windows and macOS @@ -24,13 +26,13 @@ permalink: "/wiki/Server-Win-Mac" 1. Type in the name, city and country so that other users can easily identify you. -1. Specify a musical genre if you wish. This will make your server appear in the relevant server list for clients (see more [details on Central Servers](Central-Servers)). +1. Specify a music genre. This will make your server appear in the relevant server list for clients (see more [details on Central Servers](Central-Servers)). _The Chat Welcome Message appears to all users when they join the server (the chat window will open automatically for them)._ ### Private server setup -If you do not check the "Make My Server Public", you will be running a private server and need to [read these instructions](Running-a-Private-Server). +If you do not check "Make My Server Public", you will be running a private server and need to [read these instructions](Running-a-Private-Server). _If you want to **run a client on the same machine** you should **connect the client to `127.0.0.1`** for best performance. (Similarly, if you want to connect a client on another machine on your LAN, use the server's LAN IP address)._ @@ -51,10 +53,6 @@ For headless servers: you can control the recording function [using these instru (Leave the "Custom Central Server Address" field empty unless you need to list your server on a [private central server](Choosing-a-Server-Type#3-central)) - - - - *** See also [Command Line Options](Command-Line-Options) for other parameters you can set. diff --git a/wiki/en/en-Software-Manual.md b/wiki/en/en-Software-Manual.md index 3482dde23..8eeb40f49 100644 --- a/wiki/en/en-Software-Manual.md +++ b/wiki/en/en-Software-Manual.md @@ -4,12 +4,9 @@ title: "Software Manual" lang: "en" permalink: "/wiki/Software-Manual" --- -Jamulus Help (Software Manual) -============================== - -Main Window ------------ +# Jamulus Software Manual +## Main Window ![Main window](https://user-images.githubusercontent.com/20726856/97360410-77476880-189e-11eb-99c6-f4a68258bf31.png) @@ -33,10 +30,6 @@ The **Delay** status LED shows the current audio delay status: **Red** - The delay is too large for jamming - - - - The **Buffers** status LED shows the current audio/streaming status. If the light is **red**, the audio stream is interrupted. This is caused by one of the following problems: - The network jitter buffer is not large enough for the current network/audio interface jitter. @@ -59,7 +52,7 @@ Make sure not to clip the input signal to avoid distortions of the audio signal The chat text entered in that dialog is sent to all connected clients. If a new chat message arrives and the Chat dialog is not already open, it will -opened automatically for all clients. +open automatically for all clients. ### Profile window @@ -79,7 +72,7 @@ pressing this button will end the session. ![Connect dialog](https://user-images.githubusercontent.com/20726856/97360965-31d76b00-189f-11eb-870b-f58be6e30f04.png) -The Connection Setup window shows a list of available servers together with the number of occupants and the maximum number supported. Server operators can optionally list their servers by musical genre. Use the List dropdown to select a genre, click on the server you want to join and press the Connect button to connect to it. Alternatively, double-click on the server name. Permanent servers (those that have been listed for longer than 24 hours) are shown in bold. +The Connection Setup window shows a list of available servers together with the number of occupants and the maximum number supported. Server operators register their servers on lists (mostly defined by genre, though some could be location-specific or for all genres). Use the List dropdown to select a genre, click on the server you want to join and press the Connect button to connect to it. Alternatively, double-click on the server name. Permanent servers (those that have been listed for longer than 24 hours) are shown in bold. You can filter the list by server name or location. To list only occupied servers, enter a "#" character. @@ -106,8 +99,7 @@ to the right and move the fader upwards until the desired reverb level is reache Controls the relative levels of the left and right local audio channels. For a mono signal it acts as a pan between the two channels. For example, if a microphone is connected to the right input channel and -an instrument is connected to the left input channel which is much louder than the microphone, move the audio fader -in a direction where the label above the fader shows L -x, where x is the current attenuation indicator. +an instrument is connected to the left input channel which is much louder than the microphone, move the audio fader to increase the relative volume of the mic. ### Server audio mixer @@ -134,8 +126,7 @@ If the server operator has enabled recording, you will see a message above the m -Settings Window ---------------- +## Settings Window ![image](https://user-images.githubusercontent.com/4561747/99384700-b7ab6c80-28c7-11eb-845e-c137793941d4.png) @@ -180,7 +171,7 @@ In this case the buffer delay setting is disabled and has to be changed using th On Linux, use the JACK configuration tool to change the buffer size. The actual buffer delay has an influence on the connection status, the current upload rate and the overall delay. -The lower the buffer size, the higher the probability of a red light in the status indicator (drop outs) and the +The lower the buffer size, the higher the probability of a red light in the status indicator (dropouts) and the higher the upload rate and the lower the overall delay. ![Buffer delay dependencies](https://user-images.githubusercontent.com/20726856/97361878-816a6680-18a0-11eb-8c1f-fbf956be4b81.png) @@ -255,8 +246,10 @@ Leave this blank unless you need to enter the address of a central server other ![Indicators](https://user-images.githubusercontent.com/20726856/97362338-271dd580-18a1-11eb-99b7-02c9371a6258.png) The Ping Time is the time required for the audio stream to travel from the client to the server and back again. -This delay is introduced by the network and should about 20-30ms. If this delay is higher than about 50ms, -your distance to the server is too large or your internet connection is not sufficient. +This delay is introduced by the network and ideally should be about 20-30 ms. When this delay is higher than about 50 ms, it starts to become +more noticeable and you may find it harder to keep in time, though it is still possible once you get used to it. Factors such as tempo, the instrument +played or headphone isolation will have an impact on the delay you find you can deal with. +The most probable causes for a high delay are that your distance to the server is too large or your internet connection is not sufficient. Overall Delay is calculated from the current Ping Time and the delay introduced by the current buffer settings. diff --git a/wiki/en/en-Software-Synth.md b/wiki/en/en-Software-Synth.md index 5352d2845..063dcf83b 100644 --- a/wiki/en/en-Software-Synth.md +++ b/wiki/en/en-Software-Synth.md @@ -1,44 +1,7 @@ --- -layout: wiki -title: "Software Synth in Jamulus" +layout: redirect +redirect: "/kb/2020/10/19/Software-Synth.html" lang: "en" permalink: "/wiki/Software-Synth" +category: "hidden" --- - -# Software Synth in Jamulus - -## Linux -We will elaborate the concept of playing a software synth on Linux as example and transfer that to other operating systems (e.g. Windows, macOS). -* **(Hammond Organ Synth)** As an example we talk open source software synth [setBfree](https://github.com/pantherb/setBfree), which is a hammond organ emulator that outputs through JACK on Linux. -* **(MIDI Keyboard)** The MIDI keyboard is used to generate the key pressed events, that are transmitted through a USB-MIDI interface to Linux system and the Synthesizer [setBfree](https://github.com/pantherb/setBfree) generates the corresponding tone for the pressed key. In general the MIDI keyboard can also be replaced by a digital wind midi controller, that does the same but the tone is dependent on how the musician blows air into the digital wind controller. -* **(Connector to Jamulus)** You may hear the audio output of your Linux system on your speakers but the audio output may not be use as input for your Jamulus session. So another step is to connect the audio out to Jamulus client (with QJackCtl). - -### General Information about ALSA, JACK and MIDI -First of all we explain a few basic concepts on Linux to use MIDI and Audio together. -* ALSA is the basic to connection to the hardware, i.e. the soundcard and the midi controller for the keyboard. -* JACK is build on top of ALSA and uses ALSA for the audio output. It provides a adequat environment for music production on Linux. -* Synthesizer like the [Hammond Organ emulator setBfree](https://github.com/pantherb/setBfree) connect to JACK for audio output. -* Jamulus connects to JACK. - -### Requirements for Using Software Synths in Jamulus on Linux -For ALSA2JACK MIDI (`a2jmidid`) connection it is necessary to install the a2j package. Furthermore we use in this example a simple Hammond organ emulator `setBfree` in this example. Replace `setBfree` by your favorite Linux synthesizer. Both packages `a2jmidid` and `setbfree` can be installed via your package manager or e.g. on Ubuntu/Mint with `apt-get` commands: -```shell - sudo apt-get install a2jmidid - sudo apt-get install setbfree -``` - -### Connecting ALSA, JACK and MIDI for a Synth for Jamulus -Now we look an the workflow to use the whole infrastructure in Jamulus. -* **(Jamulus Installation and JACK)** Use the [install script](https://github.com/corrados/jamulus/wiki/Linux-Client-Install-Script) for Jamulus on Linux or [install Jamulus with the manual in the wiki](https://github.com/corrados/jamulus/wiki/Installation-for-Linux). With this installation we have JACK and QJackCtl installed for Jamulus. -* **(ALSA to JACK - MIDI)** Next we must create a connection from ALSA to JACK to route the MIDI input from the keyboard to the [Hammond Emulator setBfree](https://github.com/pantherb/setBfree). - * ***(Command Line: `qjackctl`)*** For this step you can start JACK-Control (QJackCtl) from the command line by `qjackctl`, - * ***(Command Line: `a2jmidid -e`)*** Then you launch the ALSA2JACK MIDI connector with command: `a2jmidid -e`. As long as this connector runs in the shell the `a2j` connection interface is visible in `QJackCtl`. - * ***(QJackCtl: `ALSA-MIDI`)*** Connect your USB MIDI as input to `MIDI through` in the ALSA-MIDI tab of QJackCtl. Now the midi events from your keyboard reach JACK and are ready to connect. - * ***(Start Synth)*** Start the Hammond Synthesizer too e.g. from the command line with `setBfree`. You will see the `setBfree` graphical user interface GUI (see http://setbfree.org/gui_3d). Press with your mouse on the visualised organ keyboard to test if the synth generates an organ sound on your speakers. - * ***(QJackCtl: `JACK-MIDI`)*** Now we can connect `a2j` in JACK-MIDI as input to the synth `setBfree`, that generates the sound as output for each key pressed on the keyboard. Keep in mind that you can connect synths if they are started and visible for QJackCtl. So you can connect after starting the [Hammond Emulator setBfree](https://github.com/pantherb/setBfree), i.e. connect `a2j` to the `setbfree` if you also see the Hammond Synth SetBFree in QJackCtl. - * ***(Test Software Synth with MIDI Keyboard)*** If you have speakers attached to your Linux Computer you would hear the emulated Hammond sound on your Linux PC for all the keys your press on your MIDI keyboard. If you just want to play the software synth with your keyboard you are ready to play from here. The only remaining step is to connect the audio to Jamulus. -* **(Synth to Jamulus - Audio)** In the previous step we connected the MIDI signals from your keyboard to the MIDI input of JACK via a2j - MIDI through connection. Now JACK the MIDI which tell JACK which keys are pressed on the keyboard. Now create an audio connection in JACK (i.e. the generated Hammond sound of the synth). We connect the [Hammond Emulator setBfree](https://github.com/pantherb/setBfree) output to Jamulus. Therefore Jamulus must be started so that you see also Jamulus in the audio connection of QJackCtl. Now you can the audio output of the [Hammond Emulator setBfree](https://github.com/pantherb/setBfree) to the audio input of Jamulus in JACK. - -In general `QJackCtrl` is used similar operations like for plugging in instruments in mixer and the mixer into an amplifier and the amplifier again to the speakers. Have fun with your other OpenSource synths like QSynth, [ZynAddSubFX](https://sourceforge.net/projects/zynaddsubfx/) than can be installed on your Linux system and/or used within LMMS. - -Have fun playing your synth within Jamulus. diff --git a/wiki/en/en-Sound-Devices.md b/wiki/en/en-Sound-Devices.md index fe5ba526c..b70603a4f 100644 --- a/wiki/en/en-Sound-Devices.md +++ b/wiki/en/en-Sound-Devices.md @@ -1,87 +1,7 @@ --- -layout: wiki -title: "Known Good Devices" +layout: redirect +redirect: "/kb/2021/01/05/Jamulus-Sound-Devices.html" lang: "en" permalink: "/wiki/Sound-Devices" ---- - -# Known Good Devices - -This page lists hardware known to work or not work with Jamulus (although it may vary between Windows, Mac and Linux). Please update with any new information you have (and indicate the platform(s) you have used). - -### Known to Work with Jamulus - -#### USB Microphones - -* Blue Yeti microphone. Works well on Mac (there is a checkbox to turn off local monitoring). Works OK on Windows with ASIO4all but with a bit more latency than on Mac. You can turn off the local monitoring if you go deep into the settings. Latency on Linux is good but I did not find any way to turn off the local monitoring. - -* [Shure X2u](https://www.shure.com/en-GB/products/accessories/x2u-xlr-usb-interface) XLR to USB audio interface with headphone jack, converting an XLR mic into a USB mic. Set PC/Mic mix dial to 100% PC and listen to the output on headphones. Tested using Raspberry Pi 4 running Raspberry Pi OS Buster, kernel version 4.19. - - -#### Audio interfaces - -* Ammoon [AGM02](https://www.ammoon.com/p-i3974.html) and [AGM04](https://www.ammoon.com/p-i4049.html) USB mixer: relatively inexpensive 4 channel USB mixers, both tested on MacOS Catalina, the AGM02 tested on Windows 10. On Windows 10, with ASIO4ALL, the AGM02 can be used as an input, and the onboard audio as the output. There is no way to monitor only the USB return signal on the AGM02. (USB Audio) -**Note:** The Ammoon AGM04 appears to be a re-branded [ART USBMix4](https://artproaudio.com/product/usbmix4-four-channel-mixer-usb-audio-interface/). - -* ART USB Mix4 (USB audio interface + 4 channel mixer). - -* Audient EVO 4, [driver download and install](https://evo.audio/driver-installation/) (USB Audio) - -* Behringer UCA222 & UCA202 U-Control (USB audio) _Note: Works best on Mac and Linux. On Windows, [ASIO4ALL](http://www.asio4all.org/) driver works OK but not great. There is also the [native driver](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip) which Behringer withdrew support for a while ago, and therefore removed from their download section._ - -* Behringer UGC102 (USB interface for guitar/bass) _Note: On Mac, appears as "USB Audio Codec" - when selected for input and output in Jamulus, the UGC102 headphone jack is the output (and cannot be used for input)._ - -* Behringer UMC202HD, UMC204HD, and UMC404HD interfaces, [Windows 7 to 10 ASIO Driver](http://downloads.music-group.com/software/behringer/UMC/UMC-Driver_4-59-0.zip) (USB Audio) - -* Behringer X32 digital mixer with X-USB 32-in/32out (USB audio) - -* Behringer XENYX 302USB (USB audio) [Behringer ASIO Driver](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip) - -* Behringer XENYX Q502USB (USB audio) [Behringer ASIO Driver](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip) - -* Behringer XENYX Q802USB (USB audio) [Behringer ASIO Driver](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip). This Behringer ASIO Driver does not appear to be very good. Audio latency with this 'unsupported' driver seems poor - not better than ASIO4all. It's good device for Mac and Linux, but perhaps not for Windows. More testing is required. - -* Behringer XR18/XR16/XR12 digital mixers (USB Audio) - -* Edirol FA-66 (Firewire) - good on Mac, Linux, and Windows [ASIO driver](https://www.roland.com/global/products/fa-66/downloads/) - -* Focusrite Clarett 4Pre interface (Thunderbolt 2) - -* Focusrite Scarlett interfaces (USB Audio) _Note: if you have issues with the buffer size going to 136, download the updated driver version `4.64.15.598` from [http://beta.focusrite.com/](http://beta.focusrite.com/)_ - -* HiFiBerry DAC +ADC (HAT). Virtually no jitters and the good latency (20 millseconds). No headphone amplifier, so you'll need one of those. I used a Rolls MX122 mini mixer. Tested using Raspberry Pi 4 running Raspberry Pi OS Buster, kernel version 4.19. - -* iConnectivity AUDIO4+ interface (USB) - -* Lexicon Omega (USB audio) _Note: Works best on Mac and Linux. There is a driver for Windows but this does not allow to use 64 samples buffer size and adds some latency compared to, e.g., the Mac driver._ - -* Line 6 Helix Stomp, read [Remote Jamming with Helix and Jamulus](https://jimamsden.wordpress.com/2020/04/04/remote-jamming-with-helix-and-jamulus/) for setup on a Mac. (USB Audio) - -* MOTU Ultralite (2010 firewire model mk1/mk2), 2015 MacBook Pro, OS X El Capitan 10.11.6, Apple Thunderbolt/Firewire adapter. - -* Native Instruments Komplete Audio 2, Tested on Win10 with 64 sample buffer and am getting great sound and total latency around 15ms over the ping time. (USB Audio) - -* Resident Audio T4 (Thunderbolt 2) - -* Soundblaster live with kX ASIO driver - -* Soundblaster Audigy 4 - -* Steinberg UR22C (USB3, USBC 32bits 192khz). Works directly on a Mac with a beautiful sound even with un-balanced jack. Works on a Raspberry PI4 provided jackd version used is the one from /usr/bin (Tweaking raspijamulus.sh). Not tested on PC. - -* Steinberg UR22 MKII. Sounds great, can achieve 32 frame buffer and works on Windows and Linux. Not tested on Mac. - -* Tascam DR-07X stereo recorder with USB audio into computer, headphones in line-out of the recorder. It can also be used with an external mic in the line-in (had to use a pre-amp with that). Windows 10. - -* Tascam DR-40X stereo recorder as above. Set "Monitor" to "PC/Mac". Ubuntu 18.04. - -* Universal Audio Arrow (Thunderbolt 3). Achieved lowest-ever latency with this device. - -* Yamaha AG03 (USB audio) - -* Zoom H4 (regular USB) - Works also Mac, PC and Raspberry Pi4 - -* Zoom TAC-2 (Thunderbolt 2) - -### Known Not to work with Jamulus -* Zoom B3 bass amp-modeling pedal. Does not support 48000 Hz. (USB Audio) +category: "hidden" +--- \ No newline at end of file diff --git a/wiki/en/en-Tips-Tricks-More.md b/wiki/en/en-Tips-Tricks-More.md index 0eab82acc..d830d8716 100644 --- a/wiki/en/en-Tips-Tricks-More.md +++ b/wiki/en/en-Tips-Tricks-More.md @@ -11,13 +11,11 @@ permalink: "/wiki/Tips-Tricks-More" Jamulus user [Chris Rimple](https://sourceforge.net/u/chrisrimple/profile/) has compiled a massive amount of information relating to [Remote Band Rehearsals](https://docs.google.com/document/d/1smcvsxdaaViPQvGMQHmah_6BQeqowhmGSFMHfnlY2FI/) (Google doc), which covers topics such as hardware and software configuration including examples and advice for newcomers to the field. He also includes a section on Jamulus in comparison to other solutions. - - ## Using Jamulus audio in Zoom (or other) meeting apps -Several users have reported success allowing a "virtual audience" for a Jamulus session by using [JACK audio](https://jackaudio.org) to route the Jamulus signal through the JackRouter to the target application (in this case, Zoom meetings). +Several users have reported success allowing a "virtual audience" for a Jamulus session by using [JACK audio](https://jackaudio.org) to route the Jamulus signal through JackRouter to the target application (in this case, Zoom meetings). -You can also use [VoiceMeeter](https://www.vb-audio.com/Voicemeeter/banana.htm) (Banana) for Windows or [BlackHole](https://github.com/ExistentialAudio/BlackHole) for macOS to route Jamulus output to multiple destinations, for example to your headphones and the meeting application at the same time. +You can also use [VoiceMeeter](https://www.vb-audio.com/Voicemeeter/banana.htm) (Banana) for Windows or [BlackHole](https://github.com/ExistentialAudio/BlackHole) for macOS to route the Jamulus output to multiple destinations, for example to your headphones and the meeting application at the same time. ## Recording Jamulus on Windows with Reaper @@ -31,7 +29,7 @@ Jamulus user [BTDT](https://sourceforge.net/u/btdt/profile/) has written a syste ## Making a server status page -With the `-m` command line argument a server statistic information can be generated to be put on a web page. +With the `-m` command line argument, server statistic information can be generated to be put on a web page. Here is an example php script using the server status file to display the current server status on a html page (assuming the following command line argument to be used: `-m /var/www/stat1.dat`): @@ -64,7 +62,7 @@ You can run a public server long enough for your band to connect, then go privat Here's a Linux start script for Jamulus using an old Audigy4 sound card, the large number of available audio faders for which makes it hard to get the correct settings. -This script therefore includes the most important audio fader settings. The second part of the script deals with the jack connections. I use Guitarix as my guitar effect processor which I plug in in the jack audio path. +This script therefore includes the most important audio fader settings. The second part of the script deals with the JACK connections. I use Guitarix as my guitar effect processor which I plug in in the JACK audio path. Finally I start Jamulus automatically connecting to the central server. @@ -96,12 +94,16 @@ jack_connect Jamulus:'output left' system:playback_1 jack_connect Jamulus:'output right' system:playback_2 ~~~ +## Using ctrlmidich for MIDI controllers +The volume fader, pan control and mute and solo buttons in the client's mixer window strips can be controlled using a MIDI controller by using the `--ctrlmidich` parameter (note: only available for use with macOS and Linux using Jamulus version 3.7.0 or higher). To enable this feature, Jamulus must be launched with `--ctrlmidich`. There is one global MIDI channel parameter (1-16) and two parameters you can set for each item controlled: `offset` and `consecutive CC numbers`. Set the first parameter to the channel you want Jamulus to listen on (0 for all channels) and then specify the items you want to control (f = volume fader; p = pan; m = mute; s = solo) with the offset (CC number to start from) and number of consecutive CC numbers. Take the following example: -## Using ctrlmidich for MIDI controllers +`--ctrlmidich '1;f0*8;p16*8;s32*8;m48*8'` + +Here, Jamulus listens on MIDI channel 1. Volume fader CC numbers start at 0 and there are 8 of them (so end at CC number 7). Pan controls start at CC number 16 and end at 23; Solo 32 to 39 and Mute 48 to 55. -The volume faders in the client's mixer window can be controlled using a MIDI controller by using the `--ctrlmidich` parameter (note: only available for use with macOS and Linux). To enable this feature, Jamulus must be launched with `--ctrlmidich`. There are two parameters you can set: `Channel` and `Offset`. Set the first parameter to the channel you want Jamulus to listen on (0 for all channels) and the second parameter to the Control Number you want the first fader to react to. By default, the offset is 70 (for the Behringer X-Touch), which means that the first fader reacts to Control Number 70, the second to 71, and so on. +Fader strips in the mixer window are controlled in ascending order from left to right. Continuing with the above example, in strip number 1 (farthest left), the volume fader would be controlled by CC number 0; pan by 16; solo by 32 and mute by 48. As we have specified 8 consecutive controllers for each parameter, this would give us MIDI control over 8 strips (volume, pan, solo and mute in each one) in the mixer window. The next strip would be controlled by 1, 17, 33 and 49, and so forth. -So for example, if you're using a Behringer X-Touch, sending MIDI on channel 1 and leaving the offset at default, the command would look like this: `--ctrlmidich 1`. If you have a different controller, e.g. sending MIDI on channel 2 and starting with Control Number 30, the command would be as follows: `--ctrlmidich "2;30"` +*Note*: Jamulus does not provide feedback on the state of the Solo and Mute buttons, meaning that your controller must keep track and toggle LEDs (if any) to 'on' or 'off' itself. -Make sure you connect your MIDI device's output port to the Jamulus MIDI in port (Qjackctl (Linux), MIDI Studio (macOS) or whatever you use for managing connections). In Linux you will need to install and launch a2jmidid so your device shows up in the MIDI tab in Qjackctl. +Make sure you connect your MIDI device's output port to the Jamulus MIDI in port (QjackCtl (Linux), MIDI Studio (macOS) or whatever you use for managing connections). In Linux you will need to install and launch a2jmidid so your device shows up in the MIDI tab in Qjackctl. diff --git a/wiki/es/es-Central-Servers.md b/wiki/es/es-Central-Servers.md index b937506d1..eed4615ca 100644 --- a/wiki/es/es-Central-Servers.md +++ b/wiki/es/es-Central-Servers.md @@ -5,20 +5,24 @@ lang: "es" permalink: "/wiki/Central-Servers" --- +{% include breadcrumb.html root="Más" branch1="Ejecutar un Servidor" branch1-url="Running-a-Server" %} + # Registro de Servidor Público -A fecha de Mayo 2020, para minimizar el problema de sobrepasar el límite del número de servidores, hemos creado Servidores Centrales organizados por género (cada uno con un límite de 150 servidores). +Puesto que hay un límite de 150 servidores por cada servidor central, debes elegir en qué servidor central quieres publicar tu servidor. Selecciona un género si tu intención es restringir lo que se toca a ese estilo (los músicos verán tu servidor bajo ese género en su lista). Cuando arrancas un servidor público, verás un mensaje informando sobre si tu servidor se ha registrado con éxito o no. Si lo dejas arrancado, volverá a intentar registrarse hasta haya un hueco libre. ## Servidores 'Headless' -A partir de Jamulus v3.5.4, necesitarás configurar el servidor central (por género) manualmente utilizando la opción `--centralserver` (`-e`) como se muestra a continuación: +Configura el servidor central (por género) utilizando la opción `--centralserver` (`-e`) como se muestra a continuación: | Género | Dirección Servidor | |-----------|------------------| -| **Todos/Cualquiera** | `jamulusallgenres.fischvolk.de:22224` | -| **Rock** | `jamulusrock.fischvolk.de:22424` | -| **Jazz** | `jamulusjazz.fischvolk.de:22324` | -| **Clásica/Folk/Coro** | `jamulusclassical.fischvolk.de:22524` | -| Predeterminado _(obsoleto a partir de Jamulus v3.5.4)_ | `jamulus.fischvolk.de:22124` | +|**Cualquier Género 1** |`anygenre1.jamulus.io:22124`| +|**Cualquier Género 2** |`anygenre2.jamulus.io:22224`| +|**Cualquier Género 3** |`anygenre3.jamulus.io:22624`| +|**Género Rock** |`rock.jamulus.io:22424`| +|**Género Jazz** |`jazz.jamulus.io:22324`| +|**Género Clásico/Folk** |`classical.jamulus.io:22524`| +|**Género Coral/Barbershop** |`choral.jamulus.io:22724`| diff --git a/wiki/es/es-Choosing-a-Server-Type.md b/wiki/es/es-Choosing-a-Server-Type.md index 3e02213f4..87fdaaab3 100644 --- a/wiki/es/es-Choosing-a-Server-Type.md +++ b/wiki/es/es-Choosing-a-Server-Type.md @@ -5,6 +5,8 @@ lang: "es" permalink: "/wiki/Choosing-a-Server-Type" --- +{% include breadcrumb.html root="Más" branch1="Ejecutar un Servidor" branch1-url="Running-a-Server" %} + # Tipos de servidor Puedes ejecutar tu servidor en uno de tres "modos" (bien en casa o en un host de terceros): @@ -54,6 +56,8 @@ Los operadores de servidores convencionales también pueden registrarse con tu s Para ejecutar un servidor como central, se debe configurar con `--centralserver localhost` (esto es, se especifica como el servidor central que recibe consultas). -Si quieres controlar qué servidores pueden registrarse con tu servidor central, puedes habilitar una lista blanca con la opción de línea de comandos `--listfilter`. Ver la [página de opciones de la línea de comandos](Command-Line-Options) para más información sobre esta característica. +#### Notas sobre la configuración -Ver también [Opciones de Línea de Comandos](Command-Line-Options) para ver otros parámetros que se pueden establecer. +Si quieres controlar qué servidores pueden registrarse con tu servidor central, puedes habilitar una lista blanca con la opción de línea de comandos `--listfilter`. Ver la [página de opciones de la línea de comandos](Command-Line-Options) para más información sobre esta característica y otros parámetros que se pueden establecer. + +Cuando se ejecuta un Servidor Central tras un cortafuegos NAT en una red privada, utiliza la opción `--serverpublicip` para especificar la dirección IP pública de el/los servidor/es listados por tu Servidor Central. Esto es necesario para permitir a los clientes de la Red públic conectarse a ellos a través de NAT. Ten en cuenta que para los servidores utilizando esta opción, seguirás necesitando redireccionar puertos correctamente en tu router/cortafuegos. diff --git a/wiki/es/es-Client-Troubleshooting.md b/wiki/es/es-Client-Troubleshooting.md index 5fba50d2c..01a788d63 100644 --- a/wiki/es/es-Client-Troubleshooting.md +++ b/wiki/es/es-Client-Troubleshooting.md @@ -8,9 +8,9 @@ permalink: "/wiki/Client-Troubleshooting" # Resolución de Problemas ### ¿No escuchas nada/Otros no pueden escucharte? -Empieza por lo sencillo: asegúrate de que tu instrumento/micrófono y auriculares están conectados al puerto correcto. Asegúrate de que ninguna otra aplicación como el navegador, herramienta de videoconferencia, etc. está utilizando la tarjeta de sonido. Deberías cerrar estos programas al utilizar Jamulus. Si todo parece estar bien y el problema persiste, es probable que haya algún problema con la configuración del dispositivo de audio. Esto dependerá de tu configuración particular (plataforma, hardware, software y drivers), así que es mejor preguntar en [los foros](https://sourceforge.net/p/llcon/discussion/software/) para solicitar ayuda. +Empieza por lo sencillo: asegúrate de que tu instrumento/micrófono y auriculares están conectados al puerto correcto. Asegúrate de que ninguna otra aplicación como el navegador, herramienta de videoconferencia, etc. está utilizando la tarjeta de sonido. Deberías cerrar estos programas al utilizar Jamulus. Si todo parece estar bien y el problema persiste, es probable que haya algún problema con la configuración del dispositivo de audio. Esto dependerá de tu configuración particular (plataforma, hardware, software y drivers), así que es mejor preguntar en [los foros](https://github.com/jamulussoftware/jamulus/discussions) para solicitar ayuda. -**Usuarios de Windows (ASIO4All)**: Si estás utilizando el driver ASIO4All, mira [la sección de configuración para ASIO4All](Installation-for-Windows#configurar-asio4all) +**Usuarios de Windows (ASIO4ALL)**: Si estás utilizando el driver ASIO4ALL, mira [la sección de configuración para ASIO4ALL](Installation-for-Windows#configurar-asio4all) ### Todos suenan bien pero es difícil tocar todos juntos manteniendo el tiempo. @@ -18,15 +18,16 @@ Empieza por lo sencillo: asegúrate de que tu instrumento/micrófono y auricular Puedes probar si estás escuchando correctamente tu señal haciendo lo siguiente: -1. Conecta tu fuente de audio (instrumento/micrófono) al ordenador. -1. Utiliza una aplicación de grabación de audio (como [Audacity](https://www.audacityteam.org/)) en tu ordenador para grabar esa fuente de audio y comprueba que funciona. -1. Asegúrate de que si muteas tu entrada de audio en la aplicación de grabación, no te escuchas. -1. Cierra la aplicación de grabación y abre Jamulus. Aún no deberías oírte. -1. Conéctate a un servidor y toca algo. Ahora deberías escucharte con el retardo del servidor. +1. Ejecuta Jamulus y conéctate a un servidor con un tiempo ping largo (mayor de 200 ms) +2. Choca las palmas (o toca una nota corta en un instrumento). Deberías escuchar el sonido volver del servidor Jamulus, pero con un retardo importante. +3. Haz clic en el botón de "Mute" bajo tu fader en la ventana del mezclador de Jamulus (**NO** el botón de "Silenciarme Yo" a la izquierda). +4. Vuelve a chocar las palmas. -**Si sigues teniendo problemas**, prueba a preguntar en el [foro de hardware](https://sourceforge.net/p/llcon/discussion/hardware/). Cómo evitas exactamente escuchar tu señal directa dependerá de tu configuración individual - tu interfaz de audio, mesa de mezclas, conexión de auriculares, etc. Por ejemplo, algunos interfaces de audio tienen botón de "monitor" (apágalo), u opciones similares. +Si escuchas dos choques de palmas tras el paso 2, o cualquier choque tras el paso 4, es que **no** estás siguiendo la Regla Número Uno - tienes el audio local habilitado y deberías deshabilitarlo. -Ten en cuenta que aunque escuches la señal del servidor y esto asegura que estás en sincronización con los demás músicos, puedes experimentar problemas si tu retardo total (indicado por la luz de "Retardo" en Jamulus) no está en verde o al menos en amarillo la mayor parte del tiempo. Consulta el [manual de software](https://github.com/corrados/jamulus/blob/master/src/res/homepage/manual.md) para entender cómo ajustar tu configuración para mejorar este aspecto. +Exactamente cómo evitas escuchar tu señal directa dependerá de tu configuración individual - tu interfaz de audio, mesa de mezclas, punto de conexión de auriculares, etc. Por ejemplo, algunos interfaces de audio tienen botón de "monitor" (apágalo), u opciones similares. **Si sigues teniendo problemas**, prueba a preguntar en el [foro](https://github.com/jamulussoftware/jamulus/discussions). + +Ten en cuenta que mientras que escuchar la señal del servidor asegurará que estarás en sincronización con los demás músicos, puedes también experimentar problemas si tu latencia total (indicada por el piloto de "Retardo" en Jamulus) no está en verde o al menos en amarillo la mayor parte del tiempo. Consulta [el manual de software](/wiki/Software-Manual) para entender cómo ajustar tu configuración para ayudar con esto. ### ¿Dificultades a la hora de configurar el micrófono? @@ -50,7 +51,7 @@ Puedes establecer el "Nivel Cliente Nuevo" a un valor bajo (por ej. 10), o confi ### ¿No ves el servidor al que te quieres unir? -Primero comprueba que tienes el género de servidor correcto seleccionado en la ventana de Configuración de Conexión. Pero en ocasiones problemas de red hacen que tu cliente no muestre todos los servidores disponibles. Si conoces el nombre del servidor al que te quieres unir, puedes [mirar su dirección IP aquí](https://explorer.jamulus.io/). Introduce la dirección IP en el campo de "Nombre/Dirección Servidor" en la ventana de Configuración de Conexión para conectarte. +Primero comprueba que tienes el género de servidor correcto seleccionado en la ventana de Configuración de Conexión. En ocasiones problemas de red hacen que tu cliente no muestre todos los servidores disponibles. Si conoces el nombre del servidor al que te quieres unir, puedes [mirar su dirección IP aquí](https://explorer.jamulus.io/). Introduce la dirección IP en el campo de "Nombre/Dirección Servidor" en la ventana de Configuración de Conexión para conectarte. ### ¿No ves ninguna lista de servidores? @@ -72,4 +73,4 @@ Quizá no respondiste "Sí" al mensaje de `"Jamulus quiere acceder a tu micrófo *** -Para cualquier otra cosa, por favor busca o publica un post en los [Foros de Discusión](https://sourceforge.net/p/llcon/discussion/software/) +Para cualquier otra cosa, por favor busca o publica un post en los [Foros de Discusión](https://github.com/jamulussoftware/jamulus/discussions) diff --git a/wiki/es/es-Command-Line-Options.md b/wiki/es/es-Command-Line-Options.md index 81568ac7f..b3443dc41 100644 --- a/wiki/es/es-Command-Line-Options.md +++ b/wiki/es/es-Command-Line-Options.md @@ -43,12 +43,13 @@ Puedes ver todas las opciones posibles soportadas por tu versión arrancando Jam | `-o` |`--serverinfo` | Detalles de localización del servidor en el formato:
`[nombre];[ciudad];[[valor locale]]` (ver [valores](https://doc.qt.io/qt-5/qlocale.html#Country-enum)) | (Solo servidores públicos) | | `-p` |`--port` | Número del puerto UDP local. Por defecto es 22124 | (solo servidor) | | `-R` |`--recording` | Incluye una ruta editable donde se deben guardar los archivos (entrecomillado si procede). | (solo servidor) Ver descripción en [Configuración del Servidor](Server-Win-Mac#grabación). | -| |`--norecord` | Arranca la grabadora con la grabación desactivada| (solo servidor) | +| |`--norecord` | Arranca la grabadora con la grabación desactivada| (solo servidor) | | `-s` |`--server` | Arrancar en modo servidor | (solo servidor) [Ver nota](Choosing-a-Server-Type) | | `-t` |`--notranslation` | Deshabilitar traducciones | (cliente y servidor) | | `-T` |`--multithreading` | Habilitar multithreading | (solo servidor) | | `-u` |`--numchannels` | Número máximo de usuarios. Por defecto son 10, el máximo son 50 | (solo servidor) | | `-w` |`--welcomemessage` | Soporta el formateo HTML y CSS (entre comillas), o establece la ruta a un archivo de texto | (solo servidor) | | `-z` |`--startminimized` | Arranca minimizado | (solo servidor) | -| |`--ctrlmidich` | Canal para recibir mensajes de controlador MIDI y compensación de número de control, formato: `canal[;compensación]` | (solo cliente), ver [Consejos y Trucos](Tips-Tricks-More#utilizar-ctrlmidich-para-controladores-midi) | -| |`--clientname` | Título de ventana y nombre de cliente en JACK | (solo cliente) | | +| |`--ctrlmidich` | Canal para recibir mensajes de controlador MIDI, compensación de número de control y números CC consecutivos (canales). Formato: `canal[;f*][;p*][;s*][;m*]` | (solo cliente), ver [Consejos y Trucos](Tips-Tricks-More#utilizar-ctrlmidich-para-controladores-midi) | +| |`--clientname` | Título de ventana y nombre de cliente en JACK | (solo cliente) | +| |`--serverpublicip` | Proporciona la dirección IP pública del servidor | (solo servidor) [Ver nota](Choosing-a-Server-Type) | diff --git a/wiki/es/es-Compiling.md b/wiki/es/es-Compiling.md index 5fb3383ff..53b34a098 100644 --- a/wiki/es/es-Compiling.md +++ b/wiki/es/es-Compiling.md @@ -16,7 +16,7 @@ No necesitas compilar Jamulus para macOS ya que proporcionamos binarios oficiale ### Requisitos 1. Instala XCode -1. Instala QT como sigue +1. Instala Qt como sigue ```shell brew install qt5 @@ -62,11 +62,33 @@ Generará el archivo y lo hará disponible en ./Release/Jamulus.app ## Windows No necesitas compilar Jamulus para Windows ya que proporcionamos binarios oficiales, pero si de verdad quieres hacerlo, sigue las siguientes instrucciones. -**Software necesario**: [QT](https://www.qt.io/download), un compilador como Visual Studio, archivos de desarrollo de ASIO +### Software necesario +* Un compilador como [Visual Studio](https://visualstudio.microsoft.com) (Solo necesitas [Build Tools 2017 o 2019](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16) pero también puedes optar por descargar e instalar el IDE completo de [la página de descargas de Visual Studio](https://visualstudio.microsoft.com/downloads/)) +* [Qt](https://www.qt.io/download) +* Utiliza la licencia libre GPLv2 para desarrollo de código abierto +* Para determinar qué versión de Qt necesitas, comprueba [qt-installer-windows.qs](https://github.com/jamulussoftware/jamulus/blob/master/windows/qt-installer-windows.qs): bajo INSTALL_COMPONENTS verás `qt.qt5.[version]`, por ej., 5123 significa versión 5.12.3. +* Selecciona Componentes durante la instalación: Expande la sección Qt, encuentra la versión correspondiente, por ej., **Qt 5.12.3**, y añade los componentes de compilador para tu compilador, por ej., `MSVC 2017 32-bit/64-bit` para Visual Studio 2019 +* [Archivos de desarrollo de ASIO](https://www.steinberg.net/en/company/developer.html) -- obtén el código fuente de Jamulus, por ej. de git o una descarga del zip desde el repositorio de Jamulus -- copia los archivos de desarrollo de [ASIO](https://www.steinberg.net/de/company/developer.html) al directorio `[\ruta\a\jamulus\source]\windows` para que, por ejemplo, se cree el directorio `[\ruta\a\jamulus\source]\ASIOSDK2\common` -- abre Jamulus.pro en Qt Creator, compílalo y ejecútalo +### Descarga el código fuente de Jamulus +Obtén el código fuente de Jamulus, por ej. de git o [descarga el zip](https://github.com/jamulussoftware/jamulus/archive/master.zip) desde el [repositorio de Jamulus](https://github.com/jamulussoftware/jamulus). Asegúrate de que **no** haya espacios en el nombre del directorio al que mueves el directorio `jamulus` ya que puede hacer fallar al instalador de Jamulus (si sabes cómo solucionar este problema, por favor coméntalo en [issue #864](https://github.com/jamulussoftware/jamulus/issues/864) en el respositorio de Jamulus para explicarnos cómo. + +### Compilar y construir el instalador + +La mayoría de usuarios probablemente querrán utilizar este método: + +1. Abre PowerShell +1. Navega al directorio `jamulus` +1. Para permitir scripts sin firma, haz clic derecho en el script `windows\deploy_windows.ps1`, selecciona propiedades y permite la ejecución de este script. También puedes ejecutar `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`. (Puedes revertir esto tras ejecutar el script. Para más información ver la [página de documentación de Microsoft PowerShell](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy)). +1. Edita las variables $QtCompile32 y $QtCompile64. +1. Ejecuta el script de compilación e instalación en PowerShell: `.\windows\deploy_windows.ps1 C:\Qt\QtVersion`. +1. Ahora puedes encontrar el instalador de Jamulus en el directorio `.\deploy`. + +### Solo compilación + +1. Crea una carpeta bajo `\windows` llamada ASIOSDK2 +1. Descarga [ASIOSDK](https://www.steinberg.net/asiosdk), abre la carpeta raiz del archivo .zip y copia el contenido a `[\ruta\a\jamulus\source]\windows\ASIOSDK2` para que, por ejemplo, exista el directorio `[\ruta\a\jamulus\source]\windows\ASIOSDK2\common` +1. Abre Jamulus.pro en Qt Creator, configura el proyecto con un kit por defecto, luego compílalo y ejecútalo ## Notas generales diff --git a/wiki/es/es-Contribution.md b/wiki/es/es-Contribution.md index ab2df38d5..ec5e72569 100644 --- a/wiki/es/es-Contribution.md +++ b/wiki/es/es-Contribution.md @@ -8,18 +8,30 @@ permalink: "/wiki/Contribution" # Contribuir al Proyecto Jamulus ## Software Jamulus -* Si quieres contribuir código, abre un post con tu idea en [el foro para desarrolladores (en inglés)](https://sourceforge.net/p/llcon/discussion/developerforum/) primero para que se pueda analizar antes de hacer un "pull request" (asegúrate de leer el [manifiesto para contribuciones de Volker, el desarrollador principal (en inglés)](https://github.com/corrados/jamulus/issues/596)) +* Si quieres contribuir código o quieres pedir la implementación de una función, escribe tu idea en [abre un 'issue' en GitHub (en inglés)](https://github.com/jamulussoftware/jamulus/issues/) (preferiblemente) o [publica tu idea en el foro](https://github.com/jamulussoftware/jamulus/discussions) si no tienes cuenta de GitHub. Esto nos permite debatir los cambio, por ejemplo, antes de hacer un "pull request" (asegúrate de leer el [manifiesto de Volker para contribuciones en GitHub (en inglés)](https://github.com/jamulussoftware/jamulus/discussions/915) y el [archivo de CONTRIBUTING](https://github.com/jamulussoftware/jamulus/blob/master/CONTRIBUTING.md)) -Ver el [repositorio de Jamulus en GitHub](https://github.com/corrados/jamulus) para más información. +Ver el [repositorio de Jamulus en GitHub](https://github.com/jamulussoftware/jamulus) para más información. ## Página web de Jamulus -* Si observas algún error de contenido o tipográfico, o algo que está desfasado (en cualquier idioma), puedes [comentarlo aquí](https://github.com/jamulussoftware/jamuluswebsite/issues). +* Si observas algún error de contenido o tipográfico, o algo que está desfasado (en cualquier idioma), puedes [abrir un 'issue' en GitHub](https://github.com/jamulussoftware/jamuluswebsite/issues). -* Si crees que falta o se puede mejorar alguna documentación o información, abre un post en [el foro de discusión relevante](https://sourceforge.net/p/llcon/discussion/) para que se pueda discutir primero. +* Si crees que falta o se puede mejorar alguna documentación o información, abre un post en [el foro de discusión](https://github.com/jamulussoftware/jamuluswebsite/discussions) para que se pueda discutir primero. -Los "pull request" para la página web deben tener este aspecto: +Echa un vistazo al [archivo de CONTRIBUTING](https://github.com/jamulussoftware/jamuluswebsite/blob/changes/CONTRIBUTING.md) para la página web y al [repositorio GitHub de la página web](https://github.com/jamulussoftware/jamuluswebsite) para más información. -`[código idioma (por ej. en)] {breve descripción de tus cambios}` +### No estoy familiarizad@ con GitHub. Qué necesito saber? -Ver el [repositorio en GitHub de la página web](https://github.com/jamulussoftware/jamuluswebsite) para más información. +**¡El siguiente contenido solo es para la documentación en jamulus.io, no para el software de Jamulus!** + +Si no te manejas con 'Pull Requests', 'commits', etc. simplemente abre un 'issue'. Nos ocuparemos de los cambios. Si quieres realizar los cambios por tu cuenta y abrir un 'Pull Request', sigue estas instrucciones: + +1. Haz un 'fork' del repositorio (hay un botón para ello arriba a la derecha en la página de GitHub. +2. Decide a qué 'branch' tienes que hacer el 'commit' de tus cambios (en resumen: todo lo que necesita traducción tiene que ir al 'branch' de `changes`, errores tipográficos a `release`; se puede encontrar más información en el [archivo de CONTRIBUTING](https://github.com/jamulussoftware/jamuluswebsite/blob/changes/CONTRIBUTING.md)). Crea un nuevo 'branch' del 'branch' actualizado que has elegido. +3. Realiza tus cambios +4. Si has hecho los cambios offline, haz un 'push' a tu repositorio +5. Envía tu 'Pull Request', escribe una breve descripción de tus cambios y enlaza al 'issue' que abriste +6. Espera a la revisión y el 'merge' + +**Consejo (para git)** *No hagas un 'merge' de tu trabajo* a tu 'branch' local de `changes`; solo manténlo sincronizado con el repositorio remoto de la página web de Jamulus. Crea un nuevo 'branch' para los cambios que propones. +Si el 'branch' de `changes` se modifica antes de enviar tu 'Pull Request', mantén el 'branch' local de `changes` sincronizado con el oficial, haz un 'merge' del 'branch' local de `changes` al que estás trabajando, resuelve los conflictos, haz un 'push' con tus cambios y crea el 'Pull Request'. diff --git a/wiki/es/es-Demos.md b/wiki/es/es-Demos.md index cf82709e1..a5f2e88da 100644 --- a/wiki/es/es-Demos.md +++ b/wiki/es/es-Demos.md @@ -5,7 +5,6 @@ lang: "es" permalink: "/wiki/Demos" --- - # Ejemplos de uso de Jamulus **¡No dudes en añadir tus experiencias!** diff --git a/wiki/es/es-Getting-Started.md b/wiki/es/es-Getting-Started.md index bf7e31a69..9097f6ca4 100644 --- a/wiki/es/es-Getting-Started.md +++ b/wiki/es/es-Getting-Started.md @@ -33,13 +33,16 @@ Ahora que tienes lo básico, vayamos allá: Instalación en Windows Instalación en macOS Para usuarios de Linux + Install on Android (PoC)
También - [Jamulus OS!](https://sourceforge.net/projects/jamulus-os/files/JamulusOS/) Ejecuta Jamulus en cualquier ordenador utilizando un pendrive (solo sistemas de 64-bits). ¡Comprueba tu hardware y lo configura todo sin tener que hacer nada! ## Hardware recomendado -Ver [la lista de hardware comprobado](Sound-Devices) y [Configuración de Hardware](Hardware-Setup). +En general, tu dispositivo debe soportar una tasa de muestreo de **48 kHz** (calidad DVD) y debería permitirte escuchar la señal de audio del ordenador. En Windows se recomienda escoger un dispositivo con driver [ASIO](https://en.wikipedia.org/wiki/Audio_Stream_Input/Output) nativo. + +Ver [la lista de la comunidad de hardware funcional](/kb/2021/01/05/Jamulus-Sound-Devices.html). ## Otras guías * [Esta excelente guía](https://www.facebook.com/notes/jamulus-online-musicianssingers-jamming/idiots-guide-to-jamulus-app/510044532903831/){: target="_blank" rel="noopener noreferrer"} de [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a){: target="_blank" rel="noopener noreferrer"} (_Facebook_) también merece un vistazo. @@ -59,8 +62,8 @@ Se puede encontrar más información sobre cómo evitar escucharte a ti mismo (y **Así es cómo millones de personas utilizan Jamulus para tocar, cantar y enseñar música con otras personas en tiempo real, por todo el mundo:** ![Overview](https://user-images.githubusercontent.com/4263412/97573060-78d17780-19e9-11eb-94dd-7fd991650e37.png) -_Jamulus funciona bajo el principio del cliente/servidor. El audio de todos se envía a un servidor, se mezcla y se procesa allí. Después, el audio es enviado a cada cliente. Si un servidor es público y está registrado en un servidor central, su información será emitida a todos los clientes._ +_Jamulus funciona bajo el principio del cliente/servidor. El audio de todos se envía a un servidor, se mezcla y se procesa allí. Después, el audio es enviado de vuelta a cada cliente. Si un servidor es público y está registrado en un servidor central, su información será emitida a todos los clientes._ ## Notas -[^1]: [Detalles al completo aquí](Network-Requirements){: target="_blank" rel="noopener noreferrer"}. Si tienes 10Mbits de bajada y 1Mbps de subida, es poco probable que tengas problemas de ancho de banda. +[^1]: [Detalles al completo aquí](Network-Requirements){: target="_blank" rel="noopener noreferrer"}. Si tienes 10 Mbits de bajada y 1 Mbps de subida, es poco probable que tengas problemas de ancho de banda. [^2]: Los auriculares Bluetooth normalmente tienen demasiada latencia. Esa es una razón por la que se necesitan auriculares por cable. Sobre todo si cantas o tocas instrumentos acústicos, para asegurarte de que mantienes el tiempo con los demás, utiliza solo auriculares (ver la [nota sobre esto](Getting-Started#tienes-problemas-no-puedes-mantener-el-tiempo) para más información). diff --git a/wiki/es/es-Hardware-Setup.md b/wiki/es/es-Hardware-Setup.md index 0bd7ebdcb..aa7d057dd 100644 --- a/wiki/es/es-Hardware-Setup.md +++ b/wiki/es/es-Hardware-Setup.md @@ -5,6 +5,7 @@ lang: "es" permalink: "/wiki/Hardware-Setup" --- +{% include breadcrumb.html root="Utilización de Jamulus" branch1="Cómo Empezar" branch1-url="Getting-Started" %} # Configuración de Hardware @@ -24,7 +25,7 @@ Normalmente, configurar el hardware se reduce a 4 puntos, aunque cada equipo es 4. Conéctate a un servidor Jamulus y ¡a divertirse! -## Windows: Conexión interfaz de audio - ASIO4All +## Windows: Conexión interfaz de audio - ASIO4ALL Este es un ejemplo de instalación de un cliente en Windows con un dispositivo de audio [Behringer U-CONTROL UCA202](https://www.amazon.com/Behringer-U-Phono-UFO202-Audiophile-Interface/dp/B002GHBYZ0){: target="_blank" rel="noopener noreferrer"}. Las siguientes instrucciones pueden ser similares para otros dispositivos de audio. @@ -35,7 +36,7 @@ _**El modo exacto de conectar tu instrumento variará dependiendo de tu hardware En el futuro, siempre utiliza el mismo puerto USB para el dispositivo de audio. -**Usuarios de Windows**: Si no lo has hecho ya: descarga e instala [el driver ASIO de audio gratuito (ASIO4All)](http://www.asio4all.org){: target="_blank" rel="noopener noreferrer"}. Algunas personas han tenido éxito utilizando [este driver ASIO nativo](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip){: target="_blank" rel="noopener noreferrer"} __actualmente no disponible__; no está listado en las páginas de producto de Behringer a fecha de abril del 2020. +**Usuarios de Windows**: Si no lo has hecho ya: descarga e instala [el driver ASIO de audio gratuito (ASIO4ALL)](http://www.asio4all.org){: target="_blank" rel="noopener noreferrer"}. Algunas personas han tenido éxito utilizando [este driver ASIO nativo](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip){: target="_blank" rel="noopener noreferrer"} __actualmente no disponible__; no está listado en las páginas de producto de Behringer a fecha de abril del 2020. #### 2. Arranca Jamulus @@ -53,29 +54,29 @@ Conecta tu instrumento a una entrada del Behringer U-CONTROL UCA202. Enchufa tus ¡Ya está! ¡Diviértete! -## Linux: Conexión de interfaz de audio con QJackCtrl +## Linux: Conexión de interfaz de audio con QjackCtrl Consulta la [guía de instalación del cliente](Installation-for-Linux#configura-jack-con-qjackctl) en Linux. ## Linux: Kernels Low Latency para Jamulus -Quizá quieras instalar [Ubuntu Studio](https://ubuntustudio.org/){: target="_blank" rel="noopener noreferrer"}, que añade otra opción en el menú de arranque para un kernel de baja latencia. La clave para una jam session online es la baja latencia entre los servidores y los clientes conectados. Si el sistema Linux arranca con un kernel de baja latencia esto tiene un impacto positivo en tus sesiones de Jamulus. +Quizá quieras instalar [Ubuntu Studio](https://ubuntustudio.org/), que añade otra opción en el menú de arranque para un kernel de baja latencia. La clave para una jam session online es la baja latencia entre los servidores y los clientes conectados. Si el sistema Linux arranca con un kernel de baja latencia esto tiene un impacto positivo en tus sesiones de Jamulus. ## Apuntes sobre las entradas -- Si quieres conectar 2 o más fuentes de audio (por ej. voz + sinte + guitarra), es importante tener en cuenta que actualmente Jamulus solo acepta 2 canales de entrada (L/R). Por lo tanto, el hardware utilizado debe proporcionar una salida mezclada a estéreo a Jamulus. +- Si quieres conectar 2 o más fuentes de audio (por ej. voz + sinte + guitarra), es importante tener en cuenta que actualmente Jamulus solo acepta 2 canales de entrada (L/R). Por lo tanto, el hardware utilizado debe proporcionar una salida mezclada a estéreo a Jamulus. Como alternativa, ejecuta dos instancias de Jamulus si tu hardware lo permite, o utiliza entradas virtuales de audio a Jamulus para cada entrada de hardware. - Generalmente los dispositivos de audio producen una señal mezclada en su salida analógica, pero señales separadas (1 por fuente) en su salida digital (USB/Firewire/Thunderbolt). - Generalmente las mesas de mezclas solo producen señales mezcladas en su salida analógica. - Generalmente las mesas de mezclas con USB/Firewire/Thunderbolt producen señales mezcladas en su salida **analógica** Y TAMBIÉN señales separadas solo (no una señal mezclada) en su salida **digital**. -- Algunas mesas de mezclas con USB/Firewire/Thunderbolt enviarán **solo** una señal mezclada a la salida **digital** (mesas pequeñas/económicas), o si no también AÑADEN una señal mezclada a las señales separadas de la salida digital. +- Algunas mesas de mezclas con USB/FireWire/Thunderbolt enviarán **solo** una señal mezclada a la salida **digital** (mesas pequeñas/económicas), o si no también AÑADEN una señal mezclada a las señales separadas de la salida digital. _(Gracias a [pcar75](https://github.com/pcar75) por esta información)_ ## Otros ejemplos -**Este vídeo documenta una [sesión jam en directo](https://youtu.be/c8838jS2g3U).** Utilizo una tarjeta de audio USB Lexicon Omega en un Mac Mini del 2009. Mis compañeros de grupo utilizan todos Windows 10 y tienen tarjetas de audio Behringer, por ejemplo el Behringer Xenyx 1204USB. Mi conexión a internet tiene 10 Mbps de bajada / 1 Mbps de subida mediante conexión DSL. +**Este vídeo documenta una [sesión jam en directo](https://youtu.be/c8838jS2g3U).** Utilizo una tarjeta de audio USB Lexicon Omega en un Mac Mini del 2009. Mis compañeros de grupo utilizan todos Windows 10 y tienen tarjetas de audio Behringer, por ejemplo el Behringer Xenyx 1204USB. Mi conexión a internet tiene 10 Mbit/s de bajada / 1 Mbit/s de subida mediante conexión DSL. -**El usuario de Jamulus [Andrew Evans](https://sourceforge.net/u/belvario/profile/)**: Con todos los compañeros de grupo en la misma ciudad (pero con 2 ISPs diferentes) y un tiempo ping de 20 ms estables, ejecutando el servidor en un ordenador Windows por separado y el cliente en un Macbook Pro. Los demás músicos con Macbook Air. Todos con conexión Ethernet por cable a sus routers/gateways. Utilizamos WhatsApp video para vernos (con el audio apagado - ¡pero es divertido ver lo atrás que queda el audio de Whatsapp con respecto a Jamulus!) +**El usuario de Jamulus [Andrew Evans](https://sourceforge.net/u/belvario/profile/)**: Con todos los compañeros de grupo en la misma ciudad (pero con 2 ISPs diferentes) y un tiempo ping de 20 ms estables, ejecutando el servidor en un ordenador Windows por separado y el cliente en un MacBook Pro. Los demás músicos con MacBook Air. Todos con conexión Ethernet por cable a sus routers/gateways. Utilizamos WhatsApp video para vernos (con el audio apagado - ¡pero es divertido ver lo atrás que queda el audio de WhatsApp con respecto a Jamulus!) ## ¿Tienes problemas? diff --git a/wiki/es/es-Installation-for-Android.md b/wiki/es/es-Installation-for-Android.md new file mode 100644 index 000000000..fa52d8120 --- /dev/null +++ b/wiki/es/es-Installation-for-Android.md @@ -0,0 +1,33 @@ +--- +layout: wiki +title: "Instalación en Android" +lang: "es" +permalink: "/wiki/Installation-for-Android" +--- + +# Instalación en Android + +Asegúrate de leer la página de [Cómo Empezar](Getting-Started). + +## Apuntes sobre Android + +Aunque **es posible** instalar Jamulus en dispositivos Android (y escuchar audio), recomendamos encarecidamente **no** hacerlo. La calidad del sonido - sobre todo por WiFi - normalmente es mala y la latencia es alta. Si no tienes un PC, sugerimos la adquisición de un [Raspberry Pi](https://www.raspberrypi.org/){: target="_blank" rel="noopener noreferrer" } que es un dispositivo pequeño y asequible que rinde muy bien con Jamulus. El soporte para Android es solo una prueba de concepto. + +## Instalación de la prueba de concepto de Android + +Si quieres probar Jamulus en Android: + +1. Permite la instalación de apps de fuentes desconocidas (mira en Ajustes>Seguridad. Nota: El modo exacto de hacerlo depende de tu dispositivo y de la versión del sistema operativo) +1. [Descarga e instala Jamulus]({{ site.download_root_link }}{{ site.download_file_names.android }}){: .button} +1. Ahora deberías de poder ejecutar Jamulus en tu dispositivo Android + +## Comentarios y desarrollo + +Agradecemos el feedback de usuarios y desarrolladores de Android. Solo tienes que ir a [Jamulus GitHub repo](https://github.com/jamulussoftware/jamulus/). + +*** + +## ¿Todo instalado? +Jamulus ha sido instalado y puede utilizarse. Ahora puedes echar un vistazo a la + +[página de Iniciación a Jamulus](Onboarding){: .button} diff --git a/wiki/es/es-Installation-for-Linux.md b/wiki/es/es-Installation-for-Linux.md index cdd48d403..fa0751b25 100644 --- a/wiki/es/es-Installation-for-Linux.md +++ b/wiki/es/es-Installation-for-Linux.md @@ -5,28 +5,53 @@ lang: "es" permalink: "/wiki/Installation-for-Linux" --- +{% include breadcrumb.html root="Utilización de Jamulus" branch1="Cómo Empezar" branch1-url="Getting-Started" %} + # Instalación en Linux Asegúrate de leer la página de [Cómo Empezar](Getting-Started). ## Paquetes de Jamulus -Aunque no ofrecemos paquetes oficiales, puede que encuentres Jamulus en el gestor de paquetes de tu distribución. Echa un vistazo a esta tabla: +Aunque no ofrecemos paquetes oficiales para cada distribución de Linux, puede que encuentres Jamulus en el gestor de paquetes de tu distribución. Echa un vistazo a esta tabla: [![Packaging status](https://repology.org/badge/vertical-allrepos/jamulus.svg)](https://repology.org/project/jamulus/versions) -También hay una lista de paquetes no oficiales [para diferentes distribuciones aquí](https://github.com/corrados/jamulus/issues/223){: target="_blank" rel="noopener noreferrer"}. Si no lo encuentras en tu gestor de paquetes, tienes que compilar Jamulus de las fuentes. Es bastante fácil: -## Obtén las fuentes de Jamulus +También hay una list no oficial de [paquetes para diferentes distribuciones aquí](https://github.com/jamulussoftware/jamulus/discussions/914). + +### Flatpak + +Jamulus se encuentra disponible como [Flatpak](https://flatpak.org/) de [Flathub aquí](https://flathub.org/apps/details/io.jamulus.Jamulus). Necesitarás configurar pipewire para utilizar el flatpak de Jamulus. + +### Debian y Ubuntu +Puedes instalar Jamulus de [buster-backports](https://packages.debian.org/de/buster-backports/jamulus) o - si utilizas amd64 **Debian**/**Ubuntu** - puedes probar los paquetes .deb compilados con GitHub Actions: + +1. Descarga el [último archivo .deb]({{ site.download_root_link }}{{ site.download_file_names.deb-gui }}) +1. Actualiza apt: `sudo apt-get update` +1. Instala el paquete: `sudo apt install /path/to/{{ site.download_file_names.deb-gui }}`. +1. Puesto que Jamulus necesita el servidor JACK, también debes instalarlo. Recomendamos el uso de `QjackCtl` para configurar JACK. Puedes instalarlo con `sudo apt-get install qjackctl` + +Después, deberás consultar el paso de "[configurar tu tarjeta de sonido](#configura-tu-tarjeta-de-sonido)" de esta página. + +**Nota** Jamulus (con GUI) también se [incluye en Debian Bullseye (testing)](https://packages.debian.org/bullseye/jamulus) gracias a [mirabilos](https://github.com/mirabilos). Si ya utilizas Bullseye, simplemente instala Jamulus con `sudo apt-get install jamulus`. + +--- + +Si no puedes utilizar ninguna de las opciones de arriba, deberás compilarlo de las fuentes: + +## Compilar de las fuentes + +### Obtén las fuentes de Jamulus 1. Abre una terminal (línea de comandos - `CTRL+ALT+t` en Ubuntu y distros relacionadas) 1. Descarga y descomprime las fuentes para la última versión: ```shell -wget https://github.com/corrados/jamulus/archive/latest.tar.gz +wget https://github.com/jamulussoftware/jamulus/archive/latest.tar.gz tar -xvf latest.tar.gz ``` -## Instala las dependencias +### Instala las dependencias Primero actualiza la lista de paquetes (por ej. en distribuciones basadas en Debian con `sudo apt-get update`). @@ -44,7 +69,7 @@ sudo dnf install qt5-qtdeclarative-devel jack-audio-connection-kit-dbus libQt5Co ### QjackCtl: Opcional, pero recomendado -[QjackCtl](https://qjackctl.sourceforge.io) es una utilidad para ayudarte a configurar Jack (instalado como parte de las dependencias mencionadas arriba). Instálalo por ej. con +[QjackCtl](https://qjackctl.sourceforge.io) es una utilidad para ayudarte a configurar JACK (instalado como parte de las dependencias mencionadas arriba). Instálalo por ej. con ```shell sudo apt-get install qjackctl @@ -52,7 +77,7 @@ sudo apt-get install qjackctl También puedes plantearte usar un [kernel low-latency](https://help.ubuntu.com/community/UbuntuStudio/RealTimeKernel) (por ej. para Ubuntu 18.04: `sudo apt-get install linux-lowlatency-hwe-18.04`). -## Compílalo +### Compílalo Ahora `cd` a la carpeta de las fuentes de Jamulus que has descargado: @@ -67,28 +92,33 @@ make clean make sudo make install ``` +**Nota** La versión compilada de Jamulus se instala en `/usr/local/bin`. +Ahora ya puedes eliminar el directorio de las fuentes donde lo has compilado. + +--- ## Configura tu tarjeta de sonido ### Configura JACK con QjackCtl -Los clientes de Jamulus necesitan [JACK](https://jackaudio.org/){: target="_blank" rel="noopener noreferrer"} para funcionar, pero hay que configurarlo primero. El método recomendado es utilizar `QjackCtl`. +Los clientes de Jamulus necesitan [JACK](https://jackaudio.org/) para funcionar, pero hay que configurarlo primero. El método recomendado es utilizar `QjackCtl`. 1. Abre la terminal por ej. con Crtl-Alt-T y -1. Ejecuta el comando `qjackctl`. Verás la aplicación **Jack Audio Connection Kit** -2. Configura tu interfaz de audio como sigue (la configuración exacta de Jack dependerá de lo que es capaz tu interfaz/tarjeta de audio): +1. Ejecuta el comando `qjackctl`. Se abrirá la aplicación **Qt JACK Control** +2. Configura tu interfaz de audio como sigue (la configuración exacta de JACK dependerá de lo que es capaz tu interfaz/tarjeta de audio): - Elige el **Interfaz** que quieres utilizar (puede haber varios en la lista) - Establece la **Frecuencia de Muestreo en 48000** - Establece los **Cuadros/Periodo en 128** y Periodos/Buffer en 2 para empezar -Reinicia Jack para que surta efecto la nueva configuración +Reinicia JACK para que surta efecto la nueva configuración ### Arranca Jamulus -Abre Jamulus, por ej. con la terminal. Si utilizas la terminal, ejecuta el comando `Jamulus` (con 'J' mayúscula) y esto arranca el cliente de Jamulus. + +Desde la terminal, ejecuta el comando `jamulus`, o si lo has compilado de las fuentes `Jamulus` (con 'J' mayúscula). Esto arrancará el cliente de Jamulus. Jamulus se instala en `/usr/local/bin`. Ahora puedes eliminar la carpeta de las fuentes si quieres. -Si tienes problemas con cortes de sonido (en particular errores de XRUN mostrados por JACK/QjackCtl) prueba con valores más altos (por ej. 256 cuadros o 3 periodos) en el paso 3 anterior. Valores más bajos (por ej. 64 cuadros) pueden ofrecer un mejor rendimiento pero también quizá más problemas con el audio. Ver la [página de resolución de problemas](Client-Troubleshooting). +Si tienes problemas con cortes de sonido (en particular errores de XRUN mostrados por JACK/QjackCtl) prueba con valores más altos (por ej. 256 cuadros o 3 periodos). Valores más bajos (por ej. 64 cuadros) pueden ofrecer un mejor rendimiento pero también quizá más problemas con el audio. Ver la [página de resolución de problemas](Client-Troubleshooting). ## ¿Todo instalado? Jamulus ha sido instalado y ahora puede utilizarse. Ahora puedes echar un vistazo a la @@ -97,16 +127,16 @@ Jamulus ha sido instalado y ahora puede utilizarse. Ahora puedes echar un vistaz ## Para actualizar tu instalación a una nueva versión -Descarga las nuevas fuentes como en [Obtén Jamulus](Installation-for-Linux#obtén-las-fuentes-de-jamulus) y repite solamente las [instrucciones de compilación](Installation-for-Linux#compílalo) como si fuera una nueva instalación. +Descarga las nuevas fuentes como en [Obtén Jamulus](Installation-for-Linux#obtén-las-fuentes-de-jamulus) y repite solamente las [instrucciones de compilación](Installation-for-Linux#compílalo) como si fuera una nueva instalación o instala el nuevo paquete .deb si fue lo que utilizaste. ## Nota para frikis -* "make clean" es esencial para eliminar los archivos de Qt generados automáticamente los cuales están presentes en el archivo .tar.gz y que quizá no concuerden con la versión de Qt que estás utilizando. +* El comando "make clean" es esencial para eliminar los archivos de Qt generados automáticamente los cuales están presentes en el archivo .tar.gz y que quizá no concuerden con la versión de Qt que estás utilizando. * Para utilizar una librería compartida de OPUS en lugar del que viene integrado usa qmake `"CONFIG+=opus_shared_lib" Jamulus.pro`. * Para utilizar este archivo configura el software con `qmake "CONFIG+=noupcasename" Jamulus.pro` para asegurarte de que el nombre de destino de este software es **j**amulus en lugar de **J**amulus. -* Usuarios de Raspberry Pi: Quizá quieras compilar el cliente en otra máquina y ejecutar el archivo binario en el Raspberry Pi. En este caso, las únicas librerías que necesitas para ejecutarlo son aquellos necesarios para la compilación de un [servidor "headless"](Server-Linux#ejecutar-un-servidor-headless) pero _con_ las librerías de audio para Jack. Sobre todo lee el pie de página sobre la compilación "headless". +* Usuarios de Raspberry Pi: Quizá quieras compilar el cliente en otra máquina y ejecutar el archivo binario en el Raspberry Pi. En este caso, las únicas librerías que necesitas para ejecutarlo son aquellos necesarios para la compilación de un [servidor "headless"](Server-Linux#ejecutar-un-servidor-headless) pero _con_ las librerías de audio para JACK. Sobre todo lee el pie de página sobre la compilación "headless". * A partir de la versión 3.5.3, Jamulus ya no es compatible con Qt4. diff --git a/wiki/es/es-Installation-for-Macintosh.md b/wiki/es/es-Installation-for-Macintosh.md index 4f9dbec52..379b0f1ea 100644 --- a/wiki/es/es-Installation-for-Macintosh.md +++ b/wiki/es/es-Installation-for-Macintosh.md @@ -5,19 +5,20 @@ lang: "es" permalink: "/wiki/Installation-for-Macintosh" --- +{% include breadcrumb.html root="Utilización de Jamulus" branch1="Cómo Empezar" branch1-url="Getting-Started" %} + # Instalación en macOS Asegúrate de haber leído la página de [Cómo Empezar](Getting-Started). -1. [Descarga Jamulus](https://sourceforge.net/projects/llcon/files/latest/download){: target="_blank" rel="noopener noreferrer" .button} -1. **Extrae el archivo .zip descargado.**Haz doble clic en el archivo .zip, que creará una nueva carpeta con el mismo nombre. La carpeta contiene el archivo de la licencia y un archivo `.dmg` que contiene la aplicación. -1. **Haz doble clic en el archivo `.dmg`** para abrirlo. Se descomprimirá y verás dos archivos (cliente y servidor Jamulus). Acepta la licencia. -1. **Arrastra ambos iconos a tu carpeta de Aplicaciones** para instalar Jamulus. +1. [Descarga Jamulus]({{ site.download_root_link }}{{ site.download_file_names.mac }}){: .button}\\ +1. **Mirror 2:** [SourceForge](https://sourceforge.net/projects/llcon/files/latest/download) +1. **Instala Jamulus** Abre el archivo `dmg`, acepta la licencia, *arrastra y pega* los dos iconos que ves en la ventana (cliente y servidor Jamulus) en tu *Carpeta de aplicaciones*. Ahora puedes cerrar esta ventana. 1. **Ejecuta Jamulus**. Ahora deberías de poder usar Jamulus como cualquier otra aplicación. Si ves un mensaje diciendo que Jamulus no puede abrirse porque el desarrollador no puede ser verificado, sigue leyendo y echa un vistazo a la siguiente sección. _Puedes eliminar la carpeta en el directorio de Descargas que contiene el archivo `.dmg` y expulsar la unidad "Jamulus" del escritorio. Ya no son necesarios._ -También puedes [compilar tu propio archivo binario](Compiling) si así lo deseas. +*** ## "Jamulus" no puede abrirse porque no se puede verificar al desarrollador @@ -25,13 +26,17 @@ También puedes [compilar tu propio archivo binario](Compiling) si así lo desea La primera vez que trates de hacer doble clic en Jamulus para ejecutarlo, probablemente verás un mensaje diciendo que no puede abrirse. De momento no realizamos la firma de código para Jamulus (es bastante caro). -Para abrir Jamulus, navega hasta la carpeta de Aplicaciones con el Buscador, haz clic en Jamulus, clic derecho (o control-clic) en Jamulus, y selecciona "Abrir" de la parte superior del menú. +Para abrir Jamulus +1. Navega a la carpeta de Aplicaciones con Finder +1. Haz doble-clic en Jamulus y espera al mensaje mencionado arriba. +1. Cierra este mensaje haciendo clic en "Cancelar" +1. Ahora haz control-clic (o clic derecho) en Jamulus y selecciona "Abrir" de la parte de arriba del menú. Ahora verás una versión ligeramente diferente del mismo mensaje, que te permite hacer clic para Abrir y ejecutarlo. No se te mostrará esta advertencia más - simplemente haz doble clic para ejecutarlo en adelante. -Para más información consulta [esta página de Soporte para Apple](https://support.apple.com/en-gb/guide/mac-help/mh40616/mac){: target="_blank" rel="noopener noreferrer"}. +Para más información consulta [esta página de Soporte para Apple](https://support.apple.com/en-gb/guide/mac-help/mh40616/mac). ## ¿Todo instalado? -Jamulus ha sido instalado y ahora puede utilizarse. Si no has configurado tu equipo de audio, consulta la [Configuración de Hardware](Hardware-Setup). +Jamulus ha sido instalado y ahora puede utilizarse. Ahora puedes echar un vistazo a la -Para información detallada sobre la utilización de Jamulus, por favor consulta el [Manual de Ayuda](https://github.com/corrados/jamulus/blob/master/src/res/homepage/manual.md). +[Página de Iniciación a Jamulus](Onboarding){: .button} diff --git a/wiki/es/es-Installation-for-Windows.md b/wiki/es/es-Installation-for-Windows.md index 53b83ddd7..b7c704c83 100644 --- a/wiki/es/es-Installation-for-Windows.md +++ b/wiki/es/es-Installation-for-Windows.md @@ -5,45 +5,68 @@ lang: "es" permalink: "/wiki/Installation-for-Windows" --- +{% include breadcrumb.html root="Utilización de Jamulus" branch1="Cómo Empezar" branch1-url="Getting-Started" %} + # Instalación en Windows Asegúrate de leer la página de [Cómo Empezar](Getting-Started). -1. **Descarga e instala un driver ASIO**. Se recomienda usar una tarjeta de audio con driver ASIO nativo. Si no tienes (sobre todo las tarjetas internas), instala [este driver ASIO gratuito (ASIO4All)](http://www.asio4all.org){: target="_blank" rel="noopener noreferrer"} antes de instalar Jamulus. -1. [Descarga e instala Jamulus](https://sourceforge.net/projects/llcon/files/latest/download){: target="_blank" rel="noopener noreferrer"}. Si te aparece una notificación de aviso de SmartScreen, haz clic en "Más info" y "Ejecutar de todas formas" para instalar Jamulus. Esto es necesario ya que aún no pagamos para la firma de código. +1. **Descarga e instala un driver ASIO**. Se recomienda usar una tarjeta de audio con driver ASIO nativo. Si no tienes una tarjeta de audio externa, probablemente tendrás que instalar un driver genérico como ASIO4ALL. Para más información, baja a la sección sobre [ASIO](#asio). +1. [Descarga Jamulus]({{ site.download_root_link }}{{ site.download_file_names.windows }}){: .button}\\ +**Mirror 2:** [SourceForge](https://sourceforge.net/projects/llcon/files/latest/download) +1. [Instala Jamulus](https://sourceforge.net/projects/llcon/files/latest/download)Haz doble-clic en el instalador para ejecutarlo. Si ves un aviso de SmartScreen, haz clic en "Más info" y "Ejecutar de todas formas" para instalar Jamulus. (Si descargaste una versión nueva de Jamulus y eres de las primeras personas en descargarlo, Jamulus no entrará en la lista blanca de SmartScreen aún. No pagamos para la firma de código). 1. **Ejecuta Jamulus**. Ahora deberías de poder utilizar Jamulus igual que cualquier otra aplicación. -1. **Configura tu tarjeta de sonido**. Una vez hecho, tienes que configurar tu hardware de audio. Mira cómo configurar ASIO4All si es lo que vas a utilizar ([consulta abajo](#configurar-asio4all)), y luego la [Configuración de Hardware](Hardware-Setup). - -También puedes [compilar tu propio archivo binario](Compiling) si así lo deseas. +1. **Configura tu tarjeta de sonido**. Una vez hecho, tienes que configurar tu hardware de audio. Mira cómo configurar ASIO4ALL si es lo que vas a utilizar y/o la [Configuración de Hardware](Hardware-Setup). *** -## Configurar ASIO4All -*La mayoría de las tarjetas de audio internas requieren este driver. ASIO4All no se recomienda si tu interfaz de audio tiene su propio driver ASIO, puesto que este último podría proporcionar mejor latencia.* +## ASIO +### Configurar ASIO4All +Jamulus utiliza [ASIO](https://en.wikipedia.org/wiki/Audio_Stream_Input/Output) para proporcionar la menor latencia. +* Si tienes una tarjeta de sonido/interfaz de audio externa, utiliza su driver ASIO oficial (normalmente ofrecen la mejor calidad). +* Si no tienes una tarjeta externa, probablemente no tendrás instalado un driver ASIO. Por tanto, deberás instalar uno genérico como ASIO4ALL: + +Puedes probar dos versiones de ASIO4ALL. ASIO4ALL v2.14 incluye una actualización para un bug que puede hacer fallar otras funcionalidades. + +[ASIO4ALL v2.14 Descarga](https://github.com/jamulussoftware/assets/raw/main/ASIO4ALL/v2.14/ASIO4ALL_2_14_English.exe){: .button target="_blank" rel="noopener noreferrer"} + +[ASIO4ALL v2.13 Descarga](https://github.com/jamulussoftware/assets/raw/main/ASIO4ALL/v2.13/ASIO4ALL_2_13_English.exe){: .button target="_blank" rel="noopener noreferrer"} -Para ASIO4ALL, quizá necesites experimentar un poco para encontrar la configuración adecuada ya que cada ordenador es un poco diferente. Configura tu tarjeta mientras estés en conexión con un servidor para escuchar tu instrumento o tu voz y comprobar que todo está bien configurado. +[Web ASIO4ALL](https://www.asio4all.org/){: target="_blank" rel="noopener noreferrer"} + + +### Setting up ASIO4ALL +*No se recomienda ASIO4ALL si tu tarjeta de sonido/interfaz de audio proporciona su propio driver ASIO, ya que este último puede ofrecer mejor latencia.* + +Para ASIO4ALL, quizá necesites experimentar un poco para encontrar la configuración adecuada ya que cada ordenador es un poco diferente. + +**Consejo:** Configura tu tarjeta mientras estés en [conexión con un servidor](Onboarding#2-conectarse-a-un-servidor) para escuchar tu instrumento o tu voz y comprobar que todo está bien configurado; pero sigue leyendo. Antes de empezar con Jamulus: -1. **Cierra todas las aplicaciones** (sobre todo aquellas que podrían acceder a tu tarjeta de sonido como tu navegador/reproductor de audio) ya que Jamulus necesita acceso exclusivo a tu tarjeta de audio. -1. Si el audio no funciona directamente, asegúrate de que solo **están activadas** las **entradas/salidas correctas** en ASIO4ALL. Todo lo demás debería estar apagado. Esto se puede hacer como sigue: +1. **Cierra todas las aplicaciones** (sobre todo aquellas que podrían acceder a tu tarjeta de sonido como tu navegador/reproductor de audio) ya que Jamulus necesita acceso exclusivo a tu tarjeta de audio. Otros programas no podrán usar audio si ASIO4ALL y Jamulus están activos. +1. Si el audio de Jamulus no funciona directamente, asegúrate de que solo **están activadas** las **entradas/salidas correctas** en ASIO4ALL. Todo lo demás debería estar apagado. Esto se puede hacer como sigue: -### Cómo configurar las entradas de ASIO4All (Guía) +### Cómo configurar las entradas de ASIO4ALL (Guía) 1. Abre la ventana de Configuración de Jamulus -1. Ve a _"ASIO Settings"_ -1. Activa _advanced view_ en ASIO4All (haz clic en el icono de la herramienta abajo a la derecha) +1. Ve a _"ASIO Device Settings"_ (la columna a la izquierda; directamente debajo de la selección de driver) +1. Activa _advanced view_ en ASIO4ALL (haz clic en el icono de la herramienta abajo a la derecha) 1. Activa solamente la tarjeta de audio que quieres utilizar haciendo clic en el botón al lado de su nombre -1. Abre las entradas de tu tarjeta de audio haciendo clic en el _icono de plus_ al lado de esta tarjeta. -1. Ahora activa/desactiva las entradas/salidas correctas en la lista bajo tu tarjeta de audio y desactiva todo lo demás +1. Abre las entradas/salidas de tu tarjeta de audio haciendo clic en el _icono de plus_ al lado de esta tarjeta. +1. Ahora activa/desactiva las entradas/salidas correctas en la lista bajo tu tarjeta de audio y desactiva todo lo demás. Puedes mover el ratón sobre las entradas/salidas para ver qué es cada una y si soportan la tasa de muestreo de Jamulus que es de 48 kHz (calidad DVD). -**Consejo:** Muchas tarjetas internas se denominan Realtek High Definition Audio, Conexant o similar. En cuanto a las entradas/salidas: a menudo los auriculares y los altavoces están etiquetados como 'output' y los micrófonos como 'input' o 'capture'. 'Stereo Mix' normalmente no es la entrada/salida que buscas, por tanto puedes desactivarlo si lo ves. +**Consejos:** +1. Muchas tarjetas internas se denominan Realtek High Definition Audio, Conexant o similar. +1. A menudo los auriculares y los altavoces están etiquetados como 'output' y los micrófonos como 'input' o 'capture'. +1. 'Stereo Mix' normalmente no es la entrada/salida que buscas, por tanto puedes desactivarlo si lo ves. ### ¿Tienes problemas con la configuración de ASIO4All? -Si nada funciona, primero prueba a**reiniciar Jamulus y/o tu PC**. -Después trata de **configurar de nuevo las entradas/salidas**. Las entradas/salidas activadas y accesibles muestran un botón on/off iluminado y un botón de play. Si ves una cruz roja o un símbolo amarillo, quizá tengas que cerrar otras aplicaciones como tu navegador, Zoom, ... +Si nada funciona, primero prueba a reiniciar Jamulus y/o tu PC para cerrar procesos que puedan estar accediendo a tu tarjeta de sonido. + +Después, *configura de nuevo las entradas/salidas*. Las entradas/salidas activadas y accesibles muestran un botón on/off iluminado y un botón de play. Si en su lugar ves una cruz roja o un símbolo amarillo, cierra otras aplicaciones que puedan estar accediendo a tu tarjeta de sonido (por ej. navegador, Zoom, etc.). -Mírate [este vídeo](https://youtu.be/_GzOsitVgLI){: target="_blank" rel="noopener noreferrer"} de @trombonepizza que ofrece más información detallada sobre la configuración de ASIO4All. +Mírate [este vídeo](https://youtu.be/_GzOsitVgLI) de [trombonepizza](https://github.com/trombonepizza) que ofrece más información detallada sobre la configuración de ASIO4ALL. -Información oficial y más detallada sobre cómo configurar ASIO4All se encuentra en la sección [ASIO4All FAQs en la página web de ASIO4All](http://www.asio4all.org/faq.html){: target="_blank" rel="noopener noreferrer"} y en el manual de ASIO4All. Normalmente se encuentra en tu escritorio o en la carpeta donde se instala el archivo binario de ASIO4All (normalmente `C:\Archivos de Programa (x86)\ASIO4ALL v2\`). +Información oficial y más detallada sobre cómo configurar ASIO4ALL se encuentra en la sección [ASIO4ALL FAQs en la página web de ASIO4ALL](https://www.asio4all.org/index.php/help/faq/){: target="_blank" rel="noopener noreferrer"} y en el manual de ASIO4ALL que se encuentra en tu escritorio o en la carpeta donde se instala el archivo binario de ASIO4ALL (normalmente `C:\Archivos de Programa (x86)\ASIO4ALL v2\`). ## ¿Todo instalado? diff --git a/wiki/es/es-Network-Requirements.md b/wiki/es/es-Network-Requirements.md index be53dc8a5..42753e352 100644 --- a/wiki/es/es-Network-Requirements.md +++ b/wiki/es/es-Network-Requirements.md @@ -5,33 +5,35 @@ lang: "es" permalink: "/wiki/Network-Requirements" --- +{% include breadcrumb.html root="Más" branch1="Ejecutar un Servidor" branch1-url="Running-a-Server" %} + # Requisitos de Red ## Ancho de banda de audio La configuración de audio tiene un impacto en el ancho de banda de red requerido. La tabla siguiente resume los requisitos con respecto a la configuración de: -* canales : estéreo/mono -* calidad : alta/media/baja -* duración buffer audio : 2,67ms, 5,33ms, 10,67ms, 21,33ms +* Canales: estéreo/mono +* Calidad: alta/media/baja +* Duración buffer audio: 2,67 ms, 5,33 ms, 10,67 ms, 21,33 ms Con las siguientes unidades * ms : milisegundos -* Kbps : Kilo-bits por segundo (Recordatorio : 1Mbps = 1024Kbps, 1KByte = 8Kbits) -* Mbps : Mega-bits por segundo +* Kbit/s : Kilo-bits por segundo (Recordatorio : 1 Mbit/s = 1024 Kbit/s, 1 KByte/s = 8 Kbit/s) +* Mbit/s : Mega-bits por segundo -| Canales | Calidad | Ancho de banda (para buffer : 2,67ms) | Ancho de banda (para buffer : 5,33ms) | Ancho de banda (para buffer : 10,67ms) | Ancho de banda (para buffer : 21,33ms) | +| Canales | Calidad | Ancho de banda (para buffer : 2,67 ms) | Ancho de banda (para buffer : 5,33 ms) | Ancho de banda (para buffer : 10,67 ms) | Ancho de banda (para buffer : 21,33 ms) | | --------- | ------ | -------- | -------- | -------- | -------- | -| Estéreo | Alta | 894 Kbps | 657 Kbps | 541 Kbps | 483 Kbps | -| Estéreo | Media | 672 Kbps | 444 Kbps | 328 Kbps | 270 Kbps | -| Estéreo | Baja | 606 Kbps | 372 Kbps | 256 Kbps | 198 Kbps | -| Mono | Alta | 672 Kbps | 444 Kbps | 328 Kbps | 270 Kbps | -| Mono | Media | 594 Kbps | 366 Kbps | 250 Kbps | 192 Kbps | -| Mono | Baja | 534 Kbps | 306 Kbps | 190 Kbps | 132 Kbps | +| Estéreo | Alta | 894 Kbit/s | 657 Kbit/s | 541 Kbit/s | 483 Kbit/s | +| Estéreo | Media | 672 Kbit/s | 444 Kbit/s | 328 Kbit/s | 270 Kbit/s | +| Estéreo | Baja | 606 Kbit/s | 372 Kbit/s | 256 Kbit/s | 198 Kbit/s | +| Mono | Alta | 672 Kbit/s | 444 Kbit/s | 328 Kbit/s | 270 Kbit/s | +| Mono | Media | 594 Kbit/s | 366 Kbit/s | 250 Kbit/s | 192 Kbit/s | +| Mono | Baja | 534 Kbit/s | 306 Kbit/s | 190 Kbit/s | 132 Kbit/s | ## Ancho de banda de red Hay un flujo hacia arriba (músico enviando al servidor) y otro hacia abajo (el servidor enviando la mezcla de vuelta al músico) ![image](https://user-images.githubusercontent.com/9976944/79274940-999b0b00-7ea5-11ea-85be-3ded5ee198d5.png) -Nótese que la tasa de transferencia media de ADSL2 es de 10 Mbits/segundo para bajada y 1 Mbit/segundo para subida. El rendimiento real depende de la diatancia al proveedor, que puede [variar en teoría de 24Mb/s a 0,3km hasta 1,5Mb/s a 5,2km](https://en.wikipedia.org/wiki/Asymmetric_digital_subscriber_line) para la tasa de descarga. +Nótese que la tasa de transferencia media de ADSL2 es de 10 Mbit/s para bajada y 1 Mbit/s para subida. El rendimiento real depende de la distancia al proveedor, que puede [variar en teoría de 24 Mbit/s a 0,3 km hasta 1,5 Mbit/s a 5,2 km](https://en.wikipedia.org/wiki/Asymmetric_digital_subscriber_line) para la tasa de descarga. diff --git a/wiki/es/es-Onboarding.md b/wiki/es/es-Onboarding.md index 567515f75..6473587ba 100644 --- a/wiki/es/es-Onboarding.md +++ b/wiki/es/es-Onboarding.md @@ -5,15 +5,21 @@ lang: "es" permalink: "/wiki/Onboarding" --- # Iniciación a Jamulus -Veamos qué aspecto tiene Jamulus y qué debes hacer tras haber instalado el software. +Veamos qué debes hacer tras haber instalado el software. ## Primer paso Antes de arrancar Jamulus: 1. Por ahora, **cierra todas las demás aplicaciones**. Es mejor empezar desde cero primero. -2. **Conecta todo** (cable Ethernet, dispositivos de audio, etc.) +1. **Conecta todo** (cable Ethernet, dispositivos de audio, etc.) ... para *minimizar la carga* en tu ordenador y asegurarte de que *ninguna otra aplicación* trata de utilizar tu tarjeta de sonido. -Puedes echar un vistazo a la [Configuración de Hardware](Hardware-Setup) para más información sobre qué hacer con tu equipo. Si necesitas ayuda para configurar ASIO4All en Windows, echa un vistazo a [la guía de Configuración de ASIO4All en la página de instalación en Windows](Installation-for-Windows#configurar-asio4all). +### Configuración del audio +Si no lo has hecho ya, por favor hazlo conectando tu hardware (si es necesario), abriendo la página de configuración de Jamulus y seleccionando tus dispositivos de entrada/salida. + +Si necesitas ayuda para configurar ASIO4ALL en Windows, echa un vistazo a [la guía de configuración de ASIO4ALL en la página de instalación en Windows](Installation-for-Windows#configurar-asio4all). +* Los usuarios de macOS solo necesitan seleccionar sus dispositivos de entrada/salida en la configuración de Jamulus. + +También puedes echar un vistazo a la [Configuración de Hardware](Hardware-Setup) para más información sobre qué hacer con tu equipo. ### Ventana principal de Jamulus Cuando abras Jamulus, verás una ventana con este aspecto: @@ -21,7 +27,7 @@ Cuando abras Jamulus, verás una ventana con este aspecto: ![Jamulus main window](https://user-images.githubusercontent.com/4263412/101616031-22efe680-3a0f-11eb-8587-a65b379b2298.png) ### 1. Establecer un perfil -Para que otras personas sepan quién eres, deberás establecer tu *perfil*. Para hacerlo, haz clic en "Ver" (barra superior)>"Mi Perfil..." +Para que otras personas sepan quién eres, deberás establecer tu *perfil*. Para hacerlo, haz clic en "Ver" (barra superior) > "Mi Perfil..." Ahora verás esto: ![Musician Profile](https://user-images.githubusercontent.com/4263412/101616194-5b8fc000-3a0f-11eb-8b5d-3aa6ed3f7234.png) @@ -29,7 +35,12 @@ Ahora verás esto: Rellena al menos el campo de "Alias/Nombre" para establecer tu nombre y cierra la ventana. ### 2. Conectarse a un servidor -Ahora que tienes todo preparado, puedes utilizar el botón de "Conectar" en la ventana principal de Jamulus para unirte a un servidor. Se abrirá una ventana en la que encontrarás listas de *servidores agrupados por género*. Para seleccionar otro género, elige uno de la lista arriba a la izquierda. Tras elegir un género y un servidor, únete a un servidor haciendo clic en "Conectar". Si te encuentras con problemas en este punto, probablemente se deban a una configuración errónea de los dispositivos de audio o a problemas de la red. Echa un vistazo a la [página de Resolución de Problemas](Client-Troubleshooting). +Ahora que tienes todo preparado, puedes utilizar el botón de "Conectar" en la ventana principal de Jamulus para unirte a un servidor. Se abrirá una ventana: + +![Connection Setup](https://user-images.githubusercontent.com/20726856/102825226-a1b92c00-43de-11eb-9aa9-21d7a8576f5c.png) + +Esta ventana muestra listas de *servidores agrupados por género*. Para seleccionar otro género, elige uno de la lista arriba a la izquierda. Tras elegir un género y un servidor, únete a un servidor haciendo clic en "Conectar". Si te encuentras con problemas en este punto, probablemente se deban a una configuración errónea de los dispositivos de audio o a problemas de la red. Echa un vistazo a la [página de Resolución de Problemas](Client-Troubleshooting). + ### La primera Jam ¡Enhorabuena! Ya puedes empezar a tocar con Jamulus. Los faders que ves a la derecha son tu mezcla personal. Todo lo que cambies aquí afectará a lo que tú escuchas, pero no a los demás. Si bajas un fader, ese usuario sonará más bajo, si lo subes, se escuchará más alto. @@ -42,15 +53,15 @@ Ya que estamos aquí: "Configuración" abre – por supuesto – la ventana de c Se puede encontrar más información sobre el uso de Jamulus en el [Manual de Software](Software-Manual). ## Avanzado - +Por supuesto, se puede hacer mucho más con Jamulus (como configurar un servidor privado, realizar conciertos online...). Echa un vistazo a la navegación de esta página web. Además, la comunidad publica guías, consejos y trucos en la [base de consulta](/kb/). ## Ayuda y Comunidad Si necesitas ayuda o quieres contribuir al Proyecto Jamulus, puedes echar un vistazo a los siguientes enlaces: ### Foros de Discusión -Para ayuda, conversar y discusiones generales sobre Jamulus, consulta los [foros en SourceForge](https://sourceforge.net/p/llcon/discussion/). +Para ayuda, conversar y discusiones generales sobre Jamulus, consulta los [foros en GitHub](https://github.com/jamulussoftware/jamulus/discussions). ### Desarrollo y contribuciones -Si quieres contribuir al Software Jamulus, consulta el [repositorio de Jamulus en GitHub](https://github.com/corrados/jamulus/) y lee el documento sobre contribuciones que hay allí. +Si quieres contribuir al Software Jamulus, consulta el [repositorio de Jamulus en GitHub](https://github.com/jamulussoftware/jamulus/) y lee el documento `CONTRIBUTING.md` que hay allí. diff --git a/wiki/es/es-Privacy-Statement.md b/wiki/es/es-Privacy-Statement.md index b733e08d9..bd355b151 100644 --- a/wiki/es/es-Privacy-Statement.md +++ b/wiki/es/es-Privacy-Statement.md @@ -24,7 +24,7 @@ Cuando te conectas a un servidor público o privado, el operador del servidor pu Como operador de un servidor, cuando tu registras un servidor público con un Servidor Central, tu dirección IP es enviada a CloudFare (1.1.1.1) para identificar tu dirección IP pública. Las direcciones IP de todos los servidores públicos registrados con el Servidor Central también pueden ser vistas por terceros para fines informativos u otros fines (por ejemplo [aquí](https://explorer.jamulus.io/)). Tu dirección IP pública no es registrada ni guardada por parte de Jamulus, pero puede ser guardada o procesada por terceros. -_Los usuarios preocupados por el uso de la red de CloudFare pueden [re-compilar](Compiling) el código fuente de Jamulus para utilizar una alternativa para WELL_KNOWN_HOST/ WELL_KNOWN_PORT en [global.h](https://github.com/corrados/jamulus/blob/master/src/global.h#L111)_ +_Los usuarios preocupados por el uso de la red de CloudFare pueden [re-compilar](Compiling) el código fuente de Jamulus para utilizar una alternativa para WELL_KNOWN_HOST/ WELL_KNOWN_PORT en [global.h](https://github.com/jamulussoftware/jamulus/blob/master/src/global.h#L111)_ ### Grabaciones de Audio diff --git a/wiki/es/es-Running-a-Private-Server.md b/wiki/es/es-Running-a-Private-Server.md index 1f04e3322..a3455d9ee 100644 --- a/wiki/es/es-Running-a-Private-Server.md +++ b/wiki/es/es-Running-a-Private-Server.md @@ -5,6 +5,8 @@ lang: "es" permalink: "/wiki/Running-a-Private-Server" --- +{% include breadcrumb.html root="Utilización de Jamulus" branch1="Ejecutar un Servidor" branch1-url="Running-a-Server" %} + # Ejecutar un Servidor Privado **_Primero asegúrate de leer la [descripción de servidores](Running-a-Server)_** @@ -33,7 +35,7 @@ Una vez configurado el router, puedes obtener tu dirección IP (WAN) externa por * No necesitas abrir un rango de puertos como muestra el ejemplo de arriba si solo vas a abrir una instancia del servidor Jamulus en tu ordenador. -* Si utilizas un puerto distinto al que se usa por defecto (22124) tienes que escribir el número del puerto detrás del nombre del servidor o la dirección IP, separado por dos puntos, en el cliente de Jamulus (por ej.: jamulus.dyndns.org:22120). +* Si utilizas un puerto distinto al que se usa por defecto (22124) tienes que escribir el número del puerto detrás del nombre del servidor o la dirección IP, separado por dos puntos, en el cliente de Jamulus (por ej. jamulus.ejemplo.org:22120). * Ver también esta excelente [guía sobre la operación de un servidor privado](https://www.facebook.com/notes/jamulus-online-musicianssingers-jamming/how-to-create-a-private-server-for-band-rehearsals/508642543044030/) de [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a) en Facebook (inglés). diff --git a/wiki/es/es-Running-a-Server.md b/wiki/es/es-Running-a-Server.md index c8855cb4b..8573d9874 100644 --- a/wiki/es/es-Running-a-Server.md +++ b/wiki/es/es-Running-a-Server.md @@ -33,13 +33,13 @@ Si realmente quieres operar un servidor, es **muy importante** que leas y entien Mucha gente atribuye problemas al servidor que en realidad son problemas con el _cliente_. Mucho depende del [hardware](Hardware-Setup) del cliente, las redes en las que _operan_, y su adherencia a la [Regla Número Uno](Getting-Started#tienes-problemas-no-puedes-mantener-el-tiempo). Por tanto, no hay ninguna garantía de que conseguirás una latencia más baja o un rendimiento superior ejecutando tu propio servidor. -Si tienes intención de tocar regularmente con las mismas personas, **se recomienda encarecidamente** que primero os aseguréis de que cada miembro del grupo tiene la configuración adecuada para utilizar Jamulus. Haz esto buscando un servidor público con un tiempo de ping razonablemente bajo para todos (20ms o menos quizá), os conectáis todos allí y trabajáis para solucionar cualquier problema individual (verificando que pueden seguir la [Regla Número Uno](Getting-Started#tienes-problemas-no-puedes-mantener-el-tiempo) en particular). Utiliza la técnica descrita arriba de usar el botón de "solo" para impedir interrupciones si es necesario. +Si tienes intención de tocar regularmente con las mismas personas, **se recomienda encarecidamente** que primero os aseguréis de que cada miembro del grupo tiene la configuración adecuada para utilizar Jamulus. Haz esto buscando un servidor público con un tiempo de ping razonablemente bajo para todos (20 ms o menos quizá), os conectáis todos allí y trabajáis para solucionar cualquier problema individual (verificando que pueden seguir la [Regla Número Uno](Getting-Started#tienes-problemas-no-puedes-mantener-el-tiempo) en particular). Utiliza la técnica descrita arriba de usar el botón de "solo" para impedir interrupciones si es necesario. -Una vez se haya solucionado cualquier problema que puedan tener los músicos, ahora puedes investigar sobre cómo ejecutar tu propio servidor en casa o en un host en la nube como Amazon, que puede resultar en una major latencia que con servidores ejecutados en casa. Por ejemplo, [ver esta guía](https://www.facebook.com/notes/jamulus-online-musicianssingers-jamming/howto-idiots-guide-to-installing-jamulus-server-on-amazon-aws-lightsail-ubuntu-i/507719749802976/) para utilizar AWS Lightsail por parte del usuario de Jamulus [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a) (_Facebook_) +Una vez se haya solucionado cualquier problema que puedan tener los músicos, ahora puedes investigar sobre cómo ejecutar tu propio servidor en casa o en un host en la nube como Amazon, que puede resultar en una major latencia que con servidores ejecutados en casa. Por ejemplo, [ver esta guía](https://www.facebook.com/notes/jamulus-worldjam/howto-idiots-guide-to-installing-or-upgrading-a-jamulus-server-on-amazon-aws-lig/818091045662521/) para utilizar AWS Lightsail por parte del usuario de Jamulus [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a) (_Facebook_) ### Ancho de banda - ¿tienes suficiente? -En una jam típica puede haber 4 personas, para lo que necesitarías 200Kbps * 4 = 800Kbs (0,8Mbps) de subida y bajada. Así que si tienes 10Mbits de bajada y 1Mbps de subida de banda ancha, **puede ser que te empiece a escasear el ancho de banda si se une una quinta persona**, sobre todo si otros músicos eligen configuraciones que aumentan su uso. Quizá quieras [comprobar que tienes velocidad suficiente](https://fast.com) para ello. [Lee más sobre el uso de ancho de banda](Network-Requirements) con diferentes configuraciones de calidad. +En una jam típica puede haber 4 personas, para lo que necesitarías 200 Kbit/s * 4 = 800 Kbit/s (0,8 Mbit/s) de subida y bajada. Así que si tienes 10 Mbit/s de bajada y 1 Mbp/s de subida de banda ancha, **puede ser que te empiece a escasear el ancho de banda si se une una quinta persona**, sobre todo si otros músicos eligen configuraciones que aumentan su uso. Quizá quieras [comprobar que tienes velocidad suficiente](https://fast.com) para ello. [Lee más sobre el uso de ancho de banda](Network-Requirements) con diferentes configuraciones de calidad. ### En general @@ -58,10 +58,11 @@ En una jam típica puede haber 4 personas, para lo que necesitarías 200Kbps * 4 -Los operadores de servidores también pueden descargarse [este conjunto de herramientas útiles](https://github.com/corrados/jamulus/tree/master/tools) del repositorio de Jamulus (clona el repositorio de Git y ejecuta `git submodule update --init`). +Si quieres ejecutar un servidor en un Raspberry Pi, echa un vistazo a la [guía para Raspberry Pi](/kb/2020/03/28/Server-Rpi.html) de fredsiva. + +Los operadores de servidores también pueden descargarse [este conjunto de herramientas útiles](https://github.com/jamulussoftware/jamulus/tree/master/tools) del repositorio de Jamulus (clona el repositorio de Git y ejecuta `git submodule update --init`). ## ¿Experimentando problemas? diff --git a/wiki/es/es-Server-Linux.md b/wiki/es/es-Server-Linux.md index 06cd40624..47386ec96 100644 --- a/wiki/es/es-Server-Linux.md +++ b/wiki/es/es-Server-Linux.md @@ -5,6 +5,8 @@ lang: "es" permalink: "/wiki/Server-Linux" --- +{% include breadcrumb.html root="Utilización de Jamulus" branch1="Ejecutar un Servidor" branch1-url="Running-a-Server" %} + # Instalación de Servidor - Linux @@ -30,11 +32,24 @@ La siguiente guía es para ejecutar Jamulus como un servidor "puro" en **hardwar * _El usuario de Jamulus [Grigory](https://sourceforge.net/u/cidnurg/profile/) mantiene una imagen de **[Docker para Jamulus](https://hub.docker.com/r/grundic/jamulus)** que puedes utilizar._ +### Utiliza los archivos .deb oficiales de Debian/Ubuntu para 'headless' -### Compila las fuentes, crea un usuario +Si utilizas amd64 Debian/Ubuntu, puedes probar los paquetes .deb compilados con GitHub Actions: + +1. Descarga el [último archivo .deb para headless]({{ site.download_root_link }}{{ site.download_file_names.deb-headless }}) +1. Actualiza apt: `sudo apt update` +1. Instala el paquete: `sudo apt install /path/to/{{ site.download_file_names.deb-gui }}` +1. Habilita el servidor 'headless' con systemd:`sudo systemctl enable jamulus-headless` +1. Añade las [opciones de línea de comandos](Command-Line-Options) al archivo de servicio de systemd en `/lib/systemd/system/jamulus-headless.service`. +1. Vuelve a cargar los archivos de sistema `sudo systemctl daemon-reload` y reinicia el servidor 'headless': `sudo systemctl restart jamulus-headless` + +¡Ya deberías de estar ejecutando un servidor 'headless'! +**Nota:** Para configurar el servidor, puedes añadir parámetros de línea de comandos al archivo `/lib/systemd/system/jamulus-headless.service` por ej. para hacerlo un servidor público. Echa un vistazo a la página de [opciones de línea de comandos](Command-Line-Options). -1. [Obtén las fuentes](Installation-for-Linux#obtén-las-fuentes-de-jamulus) e instala las [dependencias](Installation-for-Linux#instala-las-dependencias) de acuerdo a la guía de instalación de Linux. Ten en cuenta que **no necesitas instalar los paquetes de JACK** para una instalación 'headless'. _Si tienes pensado ejecutar un servidor 'headless' en Gentoo, o estás compilando en Ubuntu para usarlo en otra máquina con Ubuntu, [ver la nota a pie de página](#qué-hace-el-indicador-de-compilacion-headless)._ +### Compila las fuentes, crea un usuario + +1. [Obtén las fuentes](Installation-for-Linux#obtén-las-fuentes-de-jamulus) e instala las [dependencias](Installation-for-Linux#instala-las-dependencias) de acuerdo a la guía de instalación de Linux. Ten en cuenta que **no necesitas instalar los paquetes de JACK** para una instalación 'headless'. _Si tienes pensado ejecutar un servidor 'headless' en Gentoo, o estás compilando en Ubuntu para usarlo en otra máquina con Ubuntu, [ver la nota a pie de página](#qué-hace-el-indicador-de-compilación-headless)._ 1. Compila las fuentes para ignorar la librería de audio de JACK: ~~~ @@ -143,7 +158,7 @@ Nota: Pulsa `q` para salir del estado del servicio. ### Para actualizar tu instalación a una nueva versión -Descarga las fuentes siguiendo las [instrucciones anteriores](Server-Linux#compila-las-fuentes-crea-un-usuario) y repite el proceso de compilación del paso 2 como si fuera una nueva instalación. Cierra el servidor, copia el archivo binario de Jamulus encima del antiguo y reinícialo. +Descarga las fuentes siguiendo las [instrucciones anteriores](Server-Linux#compila-las-fuentes-crea-un-usuario) y repite el proceso de compilación del paso 2 como si fuera una nueva instalación o simplemente instala el nuevo archivo .deb para 'headless'. Si has compilado Jamulus de las fuentes, copia el archivo binario de Jamulus encima del antiguo y reinícialo. *** @@ -157,6 +172,8 @@ Cuando se utiliza la [función de grabación](Server-Win-Mac#grabación) con la Para enviar estas señales utilizando systemd, crea los siguientes dos archivos `.service` en `/etc/systemd/system`, dándoles un nombre apropiado (por ej. `nuevaGrabación-Jamulus-server.service`). +**Nota:** Deberás guaradar las grabaciones a una ruta _fuera_ del directorio 'home' de Jamulus, o quitar `ProtectHome=true` de tu archivo de unidad de systemd (ten en cuenta que hacer esto es un riesgo potencial para la seguridad). + Para iniciar o detener la grabación (dependiendo del estado actual): ~~~ diff --git a/wiki/es/es-Server-Troubleshooting.md b/wiki/es/es-Server-Troubleshooting.md index 612756e11..54b6eeebe 100644 --- a/wiki/es/es-Server-Troubleshooting.md +++ b/wiki/es/es-Server-Troubleshooting.md @@ -5,6 +5,8 @@ lang: "es" permalink: "/wiki/Server-Troubleshooting" --- +{% include breadcrumb.html root="Utilización de Jamulus" branch1="Ejecutar un Servidor" branch1-url="Running-a-Server" %} + # Resolución de Problemas ## Servidores - Públicos @@ -37,7 +39,7 @@ Sí. Lee sobre [Tipos de Servidor](Choosing-a-Server-Type) ### ¿Puedo convertir mi servidor privado en uno público? -Sí. Simplemente activa la casilla de "Mi Servidor es Público" en la ventana del servidor y rellena los datos. Recuerda que tampoco tienes por qué validar puertos si tu servidor es público. +Sí. Simplemente activa la casilla de "Mi Servidor es Público" en la ventana del servidor y rellena los datos. Si registras tu servidor, no redirecciones puertos ya que puede impedir que otros utilicen tu servidor. ### **_Linux Headless_**: He creado un servidor pero se está registrando con el Servidor Central y no quiero que lo haga. diff --git a/wiki/es/es-Server-Win-Mac.md b/wiki/es/es-Server-Win-Mac.md index 4684a53ff..27328aa2c 100644 --- a/wiki/es/es-Server-Win-Mac.md +++ b/wiki/es/es-Server-Win-Mac.md @@ -5,6 +5,8 @@ lang: "es" permalink: "/wiki/Server-Win-Mac" --- +{% include breadcrumb.html root="Using Jamulus" branch1="Running a Server" branch1-url="Running-a-Server" %} + # Instalación para Windows y macOS @@ -24,7 +26,7 @@ permalink: "/wiki/Server-Win-Mac" 1. Escribe el nombre, la ciudad y el país para que otros usuarios puedan identificarte con facilidad. -1. Especifica un género musical si quieres. Esto hará que tu servidor aparezca en la lista relevante para los clientes (ver más [detalles sobre los Servidores Centrales](Central-Servers)). +1. Especifica un género musical. Esto hará que tu servidor aparezca en la lista relevante para los clientes (ver más [detalles sobre los Servidores Centrales](Central-Servers)). _El Mensaje de Bienvenida del Chat aparece a todos los usuarios cuando se unen al servidor (la venta del chat se abrirá automáticamente)._ @@ -51,10 +53,6 @@ Para servidores "headless": puedes controlar la función de grabación [siguiend (Deja el campo de "Dirección Personalizada Servidor Central" vacío a menos que necesites listar tu servidor en un [servidor central privado](Choosing-a-Server-Type#3-central)) - - - - *** Ver también [Opciones de Línea de Comandos](Command-Line-Options) para ver otros parámetros que se pueden establecer. diff --git a/wiki/es/es-Software-Manual.md b/wiki/es/es-Software-Manual.md index 7f6da1130..ac1622ff1 100644 --- a/wiki/es/es-Software-Manual.md +++ b/wiki/es/es-Software-Manual.md @@ -4,12 +4,9 @@ title: "Manual del Software" lang: "es" permalink: "/wiki/Software-Manual" --- -Ayuda para Jamulus (Manual del Software) -============================== - -Ventana Principal ------------ +# Manual de Software de Jamulus +## Ventana Principal ![Main window](https://user-images.githubusercontent.com/4263412/97588743-1a15f900-19fd-11eb-889e-db47dce809fe.png) @@ -33,10 +30,6 @@ El LED de **Estado de Retardo** muestra el estado actual del retardo de audio: * **Rojo** - El retardo es demasiado grande para tocar - - - - El LED de estado de **Buffers** muestra el estado actual del flujo de audio/datos. Si está **rojo**, hay interrupciones en el flujo de audio. Esto puede ser causado por alguno de los siguientes problemas: - El jitter buffer de red no es lo suficientemente grande para el jitter actual de la red/interfaz de audio. @@ -73,7 +66,7 @@ Abre una ventana donde puedes seleccionar un servidor. Si estás conectado, puls ![Connect dialog](https://user-images.githubusercontent.com/4263412/97570179-be8d4080-19e7-11eb-9133-b7e12e634193.png) -La ventana de Configuración de Conexión muestra una lista de servidores disponibles junto con el número de usuarios conectados y el número máximo de los mismos soportado. Los operadores de servidores pueden, opcionalmente, listar su servidor por género musical. Utiliza el menú desplegable de Lista para elegir un género, haz clic sobre el servidor al que te quieres unir y otra vez sobre el botón de Conectar para conectarte. También puedes hacer doble clic sobre el nombre del servidor. Los servidores permanentes (aquellos que llevan más de 24 horas en la lista) se muestran en negrita. +La ventana de Configuración de Conexión muestra una lista de servidores disponibles junto con el número de usuarios conectados y el número máximo de los mismos soportado. Los operadores de servidores registran sus servidores en listas (normalmente definidas por género, aunque algunas pueden ser específicas de una región o para cualquier género). Utiliza el menú desplegable de Lista para elegir un género, haz clic sobre el servidor al que te quieres unir y otra vez sobre el botón de Conectar para conectarte. También puedes hacer doble clic sobre el nombre del servidor. Los servidores permanentes (aquellos que llevan más de 24 horas en la lista) se muestran en negrita. Puedes filtrar la lista por nombre de servidor o ubicación. Para solo mostrar los servidores ocupados, escribe el caracter "#". @@ -94,7 +87,7 @@ Se puede aplicar un efecto de reverberación a un canal local de audio mono o a Control local de paneo / balance -Controla los niveles relativos de los canales locales de audio derecho e izquierdo. Para una señal mono actúa como paneo entre los dos canales. Por ejemplo, si se conecta un miocrófono al canal derecho y un instrumento al izquierdo que suena mucho más alto que el micrófono, mueve el fader en una dirección donde la etiqueta sobre el fader muestra L -x, donde x es el indicador de atenuación actual. +Controla los niveles relativos de los canales locales de audio derecho e izquierdo. Para una señal mono actúa como paneo entre los dos canales. Por ejemplo, si se conecta un miocrófono al canal derecho y un instrumento al izquierdo que suena mucho más alto que el micrófono, mueve el fader de audio para aumentar el volumen relativo del micrófono. ### Mezclador de audio del servidor @@ -121,8 +114,7 @@ Si el operador del servidor ha habilitado la grabación, verás un mensaje sobre -Ventana de Configuración ---------------- +## Ventana de Configuración ![Settings](https://user-images.githubusercontent.com/4263412/97570866-ebd9ee80-19e7-11eb-9e24-314540cf1b32.png) @@ -219,7 +211,8 @@ Deja esto en blanco a menos que necesites escribir la dirección de un servidor ![Indicators](https://user-images.githubusercontent.com/4263412/97572481-97833e80-19e8-11eb-84a5-b671c16e48b5.png) -El Ping es el tiempo que requiere el flujo de audio para viajar desde el cliente al servidor y volver. Este retardo lo determina la red y debería ser de unos 20-30 ms. Si este retardo es mayor de unos 50 ms, la distancia al servidor es demasiado grande o tu conexión a internet no es óptima. +El Ping es el tiempo que requiere el flujo de audio para viajar desde el cliente al servidor y volver. +Este retardo lo determina la red y debería ser de unos 20-30 ms. Cuando este retardo es mayor de unos 50 ms, empieza a ser más notable y te puedes encontrar con que es más difícil mantener la sincronización con los demás, aunque sigue siendo posible cuando te acostumbras. Los factores como el tempo, el instrumento utilizado o el aislamiento de los auriculares pueden tener un impacto en el retardo con el que te sientes cómod@. Las causas más probables de un retardo alto son que la distancia al servidor es demasiado grande o que tu conexión a internet no es óptima. El retardo total se calcula con el ping y el retardo ocasionado por la configuración de buffers. diff --git a/wiki/es/es-Tips-Tricks-More.md b/wiki/es/es-Tips-Tricks-More.md index e4a446ca0..63603ac47 100644 --- a/wiki/es/es-Tips-Tricks-More.md +++ b/wiki/es/es-Tips-Tricks-More.md @@ -99,8 +99,14 @@ jack_connect Jamulus:'output right' system:playback_2 ## Utilizar ctrlmidich para controladores MIDI -Los faders de volumen en la ventana del mezclador del usuario se pueden controlar mediante un controlador MIDI usando el parámetro `--ctrlmidich` (nota: solo disponible para macOS y Linux). Para habilitar esta función, Jamulus debe arrancarse con `--ctrlmidich`. Se pueden establecer dos parámetros: `Canal` y `Compensación`. El primer parámetro es el canal que quieres que Jamulus utilice (0 para todos los canales) y el segundo parámetro el Número de Control (Control Number) con el que quieres que reaccione el primer fader. Por defecto, la compensación está establecida en 70 (para el Behringer X-Touch), lo cual significa que el primer fader reacciona al Número de Control 70, el segundo a 71, etc. +Los faders de volumen y paneo, y los botones de mute y solo en la ventana del mezclador del usuario se pueden controlar mediante un controlador MIDI usando el parámetro `--ctrlmidich` (nota: solo disponible para macOS y Linux). Para habilitar esta función, Jamulus debe arrancarse con `--ctrlmidich`. Hay un parámetro MIDI global que es el canal (1-16) y dos parámetros que puedes establecer para cada mando: `compensación` y `cifra de números CC consecutivos`. Establece el primer parámetro al canal MIDI por el que te comunicarás con Jamulus (0 para todos los canales) y luego especifica los mandos que quieres controlar (f = fader volumen; p = pan; m = mute; s = solo) con la compensación (número CC inicial) y cifra de números CC consecutivos. Observa el siguiente ejemplo: -Por tanto como ejemplo, si utilizas un Behringer X-Touch, enviando MIDI en el canal 1 y dejando la compensación en el valor predeterminado, el comando tendría este aspecto: `--ctrlmidich 1`. Si tienes un controlador diferente, que por ejemplo envía MIDI en el canal 2 y empezando con el Número de Control 30, el comando sería el siguiente: `--ctrlmidich "2;30"`. +`--ctrlmidich '1;f0*8;p16*8;s32*8;m48*8'` + +Aquí, Jamulus recibe por el canal MIDI 1. Los números CC para los faders de volumen comienzan por 0 y hay 8 de ellos (por tanto van hasta el número CC 7). Los mandos de paneo comienzan en el número CC 16 y van hasta el 23; Solo de 32 a 39 y Mute de 48 a 55. + +Las columnas de faders y controles de la ventana del mezclador se controlan en orden ascendente de izquierda a derecha. Continuando con el ejemplo de arriba, el fader de volumen de la columna número 1 (de más a la izquierda) se controlaría con el número CC 0; pan con 16; solo con 32 y mute con 48. Como hemos especificado 8 controladores consecutivos para cada parámetro, esto nos daría control sobre 8 columnas (cada una con volumen, pan, solo y mute) en la ventana del mezclador. La siguiente columna se controlaría con 1, 17, 33 y 49, y así sucesivamente. + +*Nota:* Jamulus no proporciona información de vuelta via MIDI sobre el estado de los botones de Solo y Mute, lo cual significa que tu controlador debe conmutar los LEDs (si tiene) por sí solo. Asegúrate de que el puerto de salida de tu dispositivo MIDI esté conectado al puerto de entrada MIDI de Jamulus (QjackCtl (Linux), MIDI Studio (macOS) o lo que sea que utilices para gestionar las conexiones). En Linux tendrás que instalar y arrancar a2jmidid para que tu dispositivo aparezca en la pestaña MIDI de QjackCtl. diff --git a/wiki/fr/fr-Compiling.md b/wiki/fr/fr-Compiling.md index 12ab43fbf..85df800b0 100644 --- a/wiki/fr/fr-Compiling.md +++ b/wiki/fr/fr-Compiling.md @@ -17,7 +17,7 @@ Vous n'avez pas besoin de compiler Jamulus sous macOS puisque nous fournissons d ### Pré-requis 1. Installez XCode -1. Installez QT comme suit +1. Installez Qt comme suit ```shell brew install qt5 diff --git a/wiki/fr/fr-Linux-Install-Script.md b/wiki/fr/fr-Linux-Install-Script.md deleted file mode 100644 index 697d53cdf..000000000 --- a/wiki/fr/fr-Linux-Install-Script.md +++ /dev/null @@ -1,152 +0,0 @@ ---- -layout: wiki -title: "Trucs et astuces Jamulus – Script bash d'installation pour Linux" -lang: "fr" -permalink: "/wiki/Linux-Client-Install-Script" ---- - - -# Script bash pour télécharger et compiler sous Linux - -Si vous prévoyez d'installer Jamulus sur plusieurs machines Linux, vous pourrier avoir envie d'essayer ce script. - -L'exemple suivant a été testé sous Linux Mint et combine toutes les commandes ci-dessus en un seul script pour Ubuntu/Linux Mint. Pour pouvoir incorporer les différentes commandes des distributions Linux, des variables définissent la distribution et la version pour lesquelles ce script d'installation pourrait être utilisé. L'exemple utilise Ubuntu version 18.04 comme référence. Ainsi le nom suggéré pour le script est, par ex., `install4ubuntu18_4.sh`. Les commandes du script sont génériques afin que l'installation puisse être modifiée pour fonctionner avec d'autres distributions. - -### Installation en fonction de la distribution Linux - -Le script suivant appelle différentes commandes d'installation en fonction de la distribution Linux. -La variable `DISTRO` définie quelles commandes sont exécutées. Paramétrez la variable en fonction de la distribution Linux que vous utilisez : - -* `DISTRO="Ubuntu"` pour une Ubuntu ou Linux Mint -* `DISTRO="Debian"` pour une Debian ou Raspian Linux -* `DISTRO="Fedora"` pour une Fedora Linux - -D'autre part si l'installation est dépendante de la version, la variable `LINVERSION` a été introduite mais n'est pour l'instant pas utilisée. -Dans la déclaration `if` pour Ubuntu il y a un exemple de la façon dont les appels d'installation en fonction de la version peuvent être utilisés. - -```bash -if [ "$LINVERSION" = "18.4" ] -then - echo "Perform Installation Specifics for $DISTRO Version $DISTRO" -fi -``` - -La variable `LINVERSION` n'est pas actuellement utilisée dans le script suivant, c'est juste une démonstration sur la manière dont les commandes d'installation spécifiques à une version peuvent être utilisées. - -### Adaptation du script d'installation -Si vous voulez créer un script d'installation pour Debian, copiez simplement le script `install4ubuntu18_4.sh` en le renommant `install4debian10_6.sh` et modifez la variable distro : - -```bash -#!/bin/sh -# set DISTRO either to "Ubuntu", "Debian" or "Fedora" -DISTRO="Debian" -LINVERSION="10.6" -``` - -Ensuite, testez l'installation sous Debian et modifiez les commandes pour que le script d'installation fonctionne sous Debian. Partagez, s'il vous plait, vos scripts d'installation fonctionnels sur ce Wiki. Le responsable du dépôt pourrait y ajouter un répertoire `/install_scripts` pour les scripts d'installation fonctionnels. Créez une demande de fusion pour votre nouveau script d'installation ou ouvrez une « issue » pour demander l'ajout du script documenté et testé dans ce dépôt. - -### Le script d'installation - -Copiez le script d'installation suivant dans un ficher et sauvegardez le avec le nom `install4ubuntu18_4.sh`. Après avoir sauvegardé ce fichier dans, par ex., votre répertoire `Téléchargements`, placez vous dans ce répertoire et appelez le script suivant avec `sh install4ubuntu18_4.sh`. - -```bash -#!/bin/sh -# set DISTRO either to "Ubuntu", "Debian" or "Fedora" -DISTRO="Ubuntu" -LINVERSION="18.04" - -# Get Jamulus Release Name with "curl" and "grep" -R=`curl -s https://api.github.com/repos/corrados/jamulus/releases/latest | grep -oP '"tag_name": "\K(.*)(?=")'` -echo "Jamulus Installation Script for $DISTRO $LINVERSION" -echo "Release: $R" -INSTALLJAMULUS="no" -while true; do - read -p "Do you wish to install Jamulus on $DISTRO $LINVERSION? (y/n) " yn - case $yn in - [Yy]* ) - echo "Start Installation $DISTRO $LINVERSION" - echo "(1) Fetch Release $R from GitHub" - wget https://github.com/corrados/jamulus/archive/$R.tar.gz - echo "(2) Extract Source Code for Jamulus Release $R from GitHub" - tar -xvf $R.tar.gz - echo "(3) Delete ${R}.tar.gz from GitHub" - rm $R.tar.gz - echo "(4) Update Repository" - sudo apt-get update - INSTALLJAMULUS="yes" - break;; - [Nn]* ) - echo "Cancelled Jamulus Installation on $DISTRO $LINVERSION" - exit;; - * ) echo "Please answer yes or no.";; - esac -done - -# echo "Check Variable: $INSTALLJAMULUS" - -if [ "$INSTALLJAMULUS" = "yes" ]; then - echo "(5) Install Build Essentials for $DISTRO" - - if [ "$DISTRO" = "Ubuntu" ] - then - echo "Installation for $DISTRO" - sudo apt-get install cmake qmake gcc g++ - sudo apt-get install build-essential qt5-qmake qtdeclarative5-dev qt5-default qttools5-dev-tools libjack-jackd2-dev - sudo apt-get install qjackctl - if [ "$LINVERSION" = "18.4" ] - then - echo "Perform Installation Specifics for $DISTRO Version $DISTRO" - fi - - elif [ "$DISTRO" = "Debian" ] - then - sudo apt-get install build-essential qtdeclarative5-dev qt5-default qttools5-dev-tools libjack-jackd2-dev - sudo apt-get install qjackctl - elif [ "$DISTRO" = "Fedora" ] - then - sudo dnf install qt5-qtdeclarative-devel jack-audio-connection-kit-dbus jack-audio-connection-kit-devel - sudo dnf install qjackctl - fi - - echo "(6) Compile Jamulus $R" - echo "Change to Directory jamulus-$R" - cd "jamulus-$R" - # ls - qmake Jamulus.pro - make clean - make - sudo make install - echo "Compilation DONE" - cd .. - echo "(6) Delete the Source Files after Installation" - rm -R "jamulus-$R" - -else - - echo "Installation cancelled" - -fi - -``` - -## Améliorations possibles du script d'installation pour Jamulus - -Le script peut, au tout début, demander pour quelle distribution Linux il doit être appelé. -Ça peut être testé avec la commande `lsb_release`. - -Avec la commande `lsb_release` qui retourne les informations spécifiques à la distribution sous Linux. -Avec la commande `grep` et en utilisant des expressions rationnelles pour les variables `DISTRO` et `LINVERSION`. -Par ex., un système basé sur Unbuntu retourne les informations suivantes avec cette commande : - -```bash -$ lsb_release -a -No LSB modules are available. -Distributor ID: Ubuntu -Description: Ubuntu 11.04 -Release: 11.04 -Codename: natty -``` - -La problématique est que la commande `lsb_release` doit être disponible sur le système Linux. Pour les systèmes basés sur CentOS ou Fedora la commande `lsb_release` n'est disponible que si les paquets de base `lsb` sont installés. La détection automatique de la version de Linux pourrait donc ne pas fonctionner. - -En conséquence, obtenir les valeurs de `DISTRO` et `LINVERION` avec la commande `read` serait la meilleure amélioration en fonction de la distribution plutôt que d'automatiser la configuration avec `lsb_release`.