From 12f1ef98484f15197d9374fba927586467b9e95f Mon Sep 17 00:00:00 2001 From: jshipman42 Date: Sat, 22 Aug 2026 03:10:42 -0400 Subject: [PATCH 1/2] Software Manual: document the separate macOS input and output devices jamulussoftware/jamulus#3908 replaces the single "Audio Device" menu on macOS with separate "Input Device" and "Output Device" menus. Add a section describing them, and adjust the "Audio Device" section so it names both layouts up front instead of describing the Windows one and mentioning macOS as an aside. The screenshot follows in a separate commit. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_012i8guRg33BV5Prf7tqkkcH --- wiki/en/Software-Manual.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/wiki/en/Software-Manual.md b/wiki/en/Software-Manual.md index 09fe87063..3f0988773 100644 --- a/wiki/en/Software-Manual.md +++ b/wiki/en/Software-Manual.md @@ -224,8 +224,20 @@ This turns on a sound alert for when someone joins a Server, or when receiving a ### Audio Device +What you see here depends on your operating system. On macOS there are two menus, "Input Device" and "Output Device", described below. On every other platform there is a single "Audio Device" menu. + Under the Windows operating system the ASIO driver (sound card) can be selected using Jamulus. If the selected ASIO -driver is not valid an error message is shown and the previous valid driver is selected. Under macOS the input and output hardware can be selected. +driver is not valid an error message is shown and the previous valid driver is selected. + +### Input and output devices on macOS + +On macOS you choose your sound hardware in two menus rather than one. "Input Device" sets what Jamulus listens to, and "Output Device" sets what you hear through. They don't have to be the same piece of hardware, so you can play through an audio interface and listen through your computer's built-in output if you prefer. + +Each menu only lists hardware that can do that job, so a pair of speakers won't show up under "Input Device". + +Choose "System Default In Device" or "System Default Out Device" to use whatever is set in the macOS Sound settings when Jamulus starts. + +Changing one of the menus leaves the other one alone, along with its channel mapping. ### Input/output channel mapping From ee0607a333f1e71dfe01199923666e5d7b404f45 Mon Sep 17 00:00:00 2001 From: jshipman42 Date: Sat, 22 Aug 2026 03:43:59 -0400 Subject: [PATCH 2/2] Software Manual: add the macOS input/output device screenshot Uploaded to this pull request rather than to a discarded issue, because GitHub's user-attachments URLs are only published once the containing comment is saved. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_012i8guRg33BV5Prf7tqkkcH --- assets/img/en-screenshots/input-output-devices-macos.inc | 1 + wiki/en/Software-Manual.md | 2 ++ 2 files changed, 3 insertions(+) create mode 100644 assets/img/en-screenshots/input-output-devices-macos.inc diff --git a/assets/img/en-screenshots/input-output-devices-macos.inc b/assets/img/en-screenshots/input-output-devices-macos.inc new file mode 100644 index 000000000..1081f75cd --- /dev/null +++ b/assets/img/en-screenshots/input-output-devices-macos.inc @@ -0,0 +1 @@ +https://github.com/user-attachments/assets/c3a53a83-8617-4df5-8201-9b7777fd7c96 diff --git a/wiki/en/Software-Manual.md b/wiki/en/Software-Manual.md index 3f0988773..bddbb41a1 100644 --- a/wiki/en/Software-Manual.md +++ b/wiki/en/Software-Manual.md @@ -231,6 +231,8 @@ driver is not valid an error message is shown and the previous valid driver is s ### Input and output devices on macOS +
Image of the input and output device menus on macOS
+ On macOS you choose your sound hardware in two menus rather than one. "Input Device" sets what Jamulus listens to, and "Output Device" sets what you hear through. They don't have to be the same piece of hardware, so you can play through an audio interface and listen through your computer's built-in output if you prefer. Each menu only lists hardware that can do that job, so a pair of speakers won't show up under "Input Device".