From a792f6f5b02e6c5e8f572a08455312cac13b7c1e Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Sun, 14 Feb 2021 17:52:24 +0100 Subject: [PATCH 01/13] Add new linux installation --- wiki/en/en-Installation-for-Linux.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index 95600047d..3463765c1 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -14,18 +14,20 @@ Although we don't provide official packages for every Linux distribution, you mi [![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). +There is also list of unofficial [packages for different distributions here](https://github.com/jamulussoftware/jamulus/discussions/914). -### Debian and Ubuntu (amd64 .deb only) +### Debian and Ubuntu + +Jamulus (with GUI) is will be [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're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages from GitHub Actions. -1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/corrados/jamulus/releases/tag/latest) page +1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/jamulussoftware/jamulus/releases/tag/latest) page 1. Update apt: `sudo apt-get update` -1. Install the package: `sudo dpkg -i /path/to/jamulus_latest_ubuntu_amd64.deb` +1. Install the package: `sudo dpkg -i /path/to/jamulus_latest_ubuntu_amd64.deb` and fix the dependencies with `sudo apt-get install -f`. 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` -**Note:** The generated deb files will install Jamulus with a lower case "j". You can therefore start it in terminal by typing `jamulus`. This is different to a compiled version of Jamulus which uses the upper case *J*! +**Note:** The generated deb files will install Jamulus with a lower case "j". You can therefore start it in terminal by typing `jamulus`. This is different to a version you compiled from git which would use the upper case *J*! Afterwards you should look at the "Set up your sound card" step on this page. From 065bea72f4a3e4795eb14a0a7ec06ae069c4911e Mon Sep 17 00:00:00 2001 From: Jonathan <4561747+gilgongo@users.noreply.github.com> Date: Mon, 15 Feb 2021 17:06:22 +0000 Subject: [PATCH 02/13] Update en-Installation-for-Linux.md --- wiki/en/en-Installation-for-Linux.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index 3463765c1..b71b65651 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -27,11 +27,11 @@ If you're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages 1. Install the package: `sudo dpkg -i /path/to/jamulus_latest_ubuntu_amd64.deb` and fix the dependencies with `sudo apt-get install -f`. 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` -**Note:** The generated deb files will install Jamulus with a lower case "j". You can therefore start it in terminal by typing `jamulus`. This is different to a version you compiled from git which would use the upper case *J*! - Afterwards you should look at the "Set up your sound card" step on this page. -If you can't use one of these options, you need to compile Jamulus from source. That's quite easy: +--- + +If you can't use one of above options, you need to compile Jamulus from source: ## Get Jamulus sources @@ -88,6 +88,8 @@ sudo make install You can now delete the sources directory you compiled from. +--- + ## Set up your sound card ### Configure JACK with QjackCtl @@ -104,9 +106,9 @@ Restart JACK to take any new settings ### Start Jamulus -Open Jamulus e.g. via your command shell. If you use the shell and compiled Jamulus yourself, execute the command `Jamulus` (with a capital 'J') or if you used the .deb package with a lowercase j. This will start the Jamulus Client. +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? From f124d666d8f7a0bdb48f5ea7cbad4b0e55dc87ed Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Tue, 16 Feb 2021 19:13:55 +0100 Subject: [PATCH 03/13] Install deb via apt --- wiki/en/en-Installation-for-Linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index b71b65651..37860d106 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -24,7 +24,7 @@ If you're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages 1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/jamulussoftware/jamulus/releases/tag/latest) page 1. Update apt: `sudo apt-get update` -1. Install the package: `sudo dpkg -i /path/to/jamulus_latest_ubuntu_amd64.deb` and fix the dependencies with `sudo apt-get install -f`. +1. Install the package: `sudo apt install /path/to/jamulus_latest_ubuntu_amd64.deb`. 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" step on this page. From 3b950df84031812a80f8aa4cd1cf4c59992bc33a Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Tue, 16 Feb 2021 19:38:21 +0100 Subject: [PATCH 04/13] Add flatpak and other instructions --- wiki/en/en-Installation-for-Linux.md | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index 37860d106..915870de9 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -16,11 +16,15 @@ Although we don't provide official packages for every Linux distribution, you mi 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 Jamulus (with GUI) is will be [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're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages from GitHub Actions. +If you're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages from GitHub Actions: 1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/jamulussoftware/jamulus/releases/tag/latest) page 1. Update apt: `sudo apt-get update` @@ -33,17 +37,19 @@ Afterwards you should look at the "Set up your sound card" step on this page. If you can't use one of above options, you need to compile Jamulus from source: -## Get Jamulus sources +## 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`). @@ -69,7 +75,7 @@ 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`). -## Compile this bad boy +### Compile this bad boy Now `cd` into the jamulus sources directory you downloaded: From 7cc660d5befe3ec0c623cc10c105a79b6e2e5d2c Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Tue, 16 Feb 2021 19:40:14 +0100 Subject: [PATCH 05/13] Move debian testing down --- wiki/en/en-Installation-for-Linux.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index 915870de9..db712b8da 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -22,8 +22,6 @@ Jamulus is available as a [Flatpak](https://flatpak.org/) from [Flathub here](ht ### Debian and Ubuntu -Jamulus (with GUI) is will be [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're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages from GitHub Actions: 1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/jamulussoftware/jamulus/releases/tag/latest) page @@ -33,6 +31,8 @@ If you're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages Afterwards you should look at the "Set up your sound card" step on this page. +**Note:** Jamulus (with GUI) is will be [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 above options, you need to compile Jamulus from source: From aa77595f520c56e5331ff772c64d892a4c793002 Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Tue, 16 Feb 2021 19:41:17 +0100 Subject: [PATCH 06/13] Add jump marker --- wiki/en/en-Installation-for-Linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index db712b8da..19dd13c72 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -29,7 +29,7 @@ If you're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages 1. Install the package: `sudo apt install /path/to/jamulus_latest_ubuntu_amd64.deb`. 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" step on this page. +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 will be [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`. From 4eb53b21fa8e066a8790dd72655432af9edef80a Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Tue, 16 Feb 2021 19:55:23 +0100 Subject: [PATCH 07/13] Add headless server .deb instruction --- wiki/en/en-Server-Linux.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/wiki/en/en-Server-Linux.md b/wiki/en/en-Server-Linux.md index 1e059dc6e..7c700b921 100644 --- a/wiki/en/en-Server-Linux.md +++ b/wiki/en/en-Server-Linux.md @@ -30,6 +30,18 @@ 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 `jamulus_headless_latest_ubuntu_amd64.deb` file from the Jamulus [GitHub release page](https://github.com/jamulussoftware/jamulus/releases/tag/latest) +1. Update apt: `sudo apt update` +1. Install the package: `sudo apt install /path/to/jamulus_headless_latest_ubuntu_amd64.deb` +1. Enable the headless server via systemd: `sudo systemctl enable 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 [CLI page](Command-Line-Options). ### Compile sources, create a user @@ -143,7 +155,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. *** From 45cc757267482c05efe70e635998b4f06406beb4 Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Tue, 16 Feb 2021 20:00:46 +0100 Subject: [PATCH 08/13] Add link to deb file --- wiki/en/en-Installation-for-Linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index 19dd13c72..c1e59975f 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -24,7 +24,7 @@ Jamulus is available as a [Flatpak](https://flatpak.org/) from [Flathub here](ht If you're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages from GitHub Actions: -1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/jamulussoftware/jamulus/releases/tag/latest) page +1. Download the [jamulus_latest_ubuntu_amd64.deb](https://github.com/jamulussoftware/jamulus/releases/download/latest/jamulus_latest_ubuntu_amd64.deb) file from the [Jamulus GitHub release](https://github.com/jamulussoftware/jamulus/releases/tag/latest) page 1. Update apt: `sudo apt-get update` 1. Install the package: `sudo apt install /path/to/jamulus_latest_ubuntu_amd64.deb`. 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` From 68cb945ae64fa04b85dee570bda609d14108c122 Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Tue, 16 Feb 2021 20:02:39 +0100 Subject: [PATCH 09/13] Add direct link to deb file --- wiki/en/en-Server-Linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/en/en-Server-Linux.md b/wiki/en/en-Server-Linux.md index 7c700b921..5300be2cd 100644 --- a/wiki/en/en-Server-Linux.md +++ b/wiki/en/en-Server-Linux.md @@ -34,7 +34,7 @@ The following guide is for running Jamulus as a "pure" server on **hardware with If you're on amd64 Debian/Ubuntu, you may try the compiled .deb packages from GitHub Actions: -1. Download the `jamulus_headless_latest_ubuntu_amd64.deb` file from the Jamulus [GitHub release page](https://github.com/jamulussoftware/jamulus/releases/tag/latest) +1. Download the [jamulus_headless_latest_ubuntu_amd64.deb](https://github.com/jamulussoftware/jamulus/releases/download/latest/jamulus_headless_latest_ubuntu_amd64.deb) file from the Jamulus [GitHub release page](https://github.com/jamulussoftware/jamulus/releases/tag/latest) 1. Update apt: `sudo apt update` 1. Install the package: `sudo apt install /path/to/jamulus_headless_latest_ubuntu_amd64.deb` 1. Enable the headless server via systemd: `sudo systemctl enable jamulus-headless` From e6ffbc008a756491f155321eb4319110b6f51daa Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Tue, 16 Feb 2021 20:05:57 +0100 Subject: [PATCH 10/13] Add configuration of headless server --- wiki/en/en-Server-Linux.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/wiki/en/en-Server-Linux.md b/wiki/en/en-Server-Linux.md index 5300be2cd..ed0aa28b5 100644 --- a/wiki/en/en-Server-Linux.md +++ b/wiki/en/en-Server-Linux.md @@ -38,10 +38,12 @@ If you're on amd64 Debian/Ubuntu, you may try the compiled .deb packages from Gi 1. Update apt: `sudo apt update` 1. Install the package: `sudo apt install /path/to/jamulus_headless_latest_ubuntu_amd64.deb` 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. 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 [CLI page](Command-Line-Options). +**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 From 429fed6aa910793f893d6785c8cfcafbf0ba2126 Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Tue, 16 Feb 2021 20:08:29 +0100 Subject: [PATCH 11/13] Add daemon-reload --- wiki/en/en-Server-Linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/en/en-Server-Linux.md b/wiki/en/en-Server-Linux.md index ed0aa28b5..53331e473 100644 --- a/wiki/en/en-Server-Linux.md +++ b/wiki/en/en-Server-Linux.md @@ -39,7 +39,7 @@ If you're on amd64 Debian/Ubuntu, you may try the compiled .deb packages from Gi 1. Install the package: `sudo apt install /path/to/jamulus_headless_latest_ubuntu_amd64.deb` 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. Restart the headless server: `sudo systemctl restart jamulus-headless` +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! From 6bdc707bff30d2cb86dbb9a33e504d3d161e07c6 Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Wed, 17 Feb 2021 13:15:59 +0100 Subject: [PATCH 12/13] is will be -> is --- wiki/en/en-Installation-for-Linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index c1e59975f..e2d5b4c7b 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -31,7 +31,7 @@ If you're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages 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 will be [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`. +**Note:** Jamulus (with GUI) is [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`. --- From 7b2e7582597adac812251151c14edf567746f5c3 Mon Sep 17 00:00:00 2001 From: ann0see <20726856+ann0see@users.noreply.github.com> Date: Wed, 17 Feb 2021 17:29:18 +0100 Subject: [PATCH 13/13] Fix grammar mistake --- wiki/en/en-Installation-for-Linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/en/en-Installation-for-Linux.md b/wiki/en/en-Installation-for-Linux.md index e2d5b4c7b..14ed3e018 100644 --- a/wiki/en/en-Installation-for-Linux.md +++ b/wiki/en/en-Installation-for-Linux.md @@ -35,7 +35,7 @@ Afterwards you should look at the "[Set up your sound card](#set-up-your-sound-c --- -If you can't use one of above options, you need to compile Jamulus from source: +If you can't use one of the above options, you need to compile Jamulus from source: ## Compile from source