Linux에서 Elgato Stream Deck 버튼에 방송 장면이나 소리 재생을 넣고 싶다면 Boatswain을 사용할 수 있습니다. 공식 Flathub에서 무료로 제공하는 앱으로, 연결된 장치의 버튼과 프로필을 화면에서 설정합니다.
앱을 설치하는 것과 실제 버튼을 누르는 것은 별개입니다. Elgato Stream Deck 장치가 있어야 버튼 동작을 확인할 수 있고, OBS Studio 장면 전환에는 obs-websocket 연결도 필요합니다. 이 조건을 먼저 확인한 뒤 설치하세요.
Boatswain은 어떤 프로그램인가요?
Boatswain은 Linux에서 Elgato Stream Deck의 물리 버튼에 동작을 배치하는 프로그램입니다. 화면 가운데에는 장치의 버튼 배열이, 왼쪽에는 장치와 프로필이, 오른쪽에는 선택한 버튼의 속성이 나타납니다. 따라서 어떤 버튼에 무슨 동작을 넣었는지 보면서 수정할 수 있습니다.
공식 GNOME 안내에는 페이지와 프로필로 동작 정리하기, 버튼 아이콘 변경, 음악 플레이어 제어, 효과음 재생, OBS Studio 제어, 네트워크 요청, 점수 관리, 파일 및 앱 열기가 소개돼 있습니다. 한 버튼으로 모든 일을 자동 처리한다기보다 필요한 동작을 버튼마다 지정해 쓰는 방식입니다.
공식 화면에는 Stream Deck Mini와 더 큰 Stream Deck의 버튼 배열이 각각 보입니다. 장치 크기에 따라 화면의 버튼 수가 다르므로 미리보기와 자신의 장치가 똑같이 보이지 않아도 됩니다. 화면에 보이는 방송 장면 이름과 색상도 제작자가 설정한 예시입니다.
OBS Studio용 기능은 OBS와 통신할 준비가 되어야 쓸 수 있습니다. Boatswain 공식 안내는 이 기능에 obs-websocket 확장이 필요하다고 명시합니다. OBS를 켜지 않았거나 연결 설정이 맞지 않으면 버튼 색이나 이름을 지정해도 실제 장면은 바뀌지 않습니다.
Boatswain의 프로필과 OBS의 장면은 서로 다른 설정입니다. 프로필은 Stream Deck 버튼 배치를 나누고, OBS 장면은 방송 화면의 구성을 가리킵니다. 예를 들어 회의용 프로필에 음소거 버튼을 두고 방송용 프로필에 장면 전환 버튼을 두더라도, 프로필 이름만 바꾼다고 OBS 장면이 자동 전환되는 것은 아닙니다.
버튼 배열·작업 목록·OBS 연결 화면
공식 GNOME 화면에서 장치별 버튼 배열, Actions의 Soundboard·OBS Studio 항목, Button Properties의 Scene과 Connection Settings를 확인했습니다. 화면의 프로필과 장면 이름은 예시이며 실제 장치와 설정에 따라 달라집니다.
| 프로그램 | Boatswain |
| 제작자 | Georges Basile Stavracas Neto |
| 표시 버전 | 6.0 |
| 지원 운영체제 | Linux |
| 공식 배포 | Flathub stable Flatpak |
| 필요 장치 | Elgato Stream Deck |
Linux에 Boatswain 설치하고 장치 확인하기
Flathub에서 앱 이름 Boatswain과 ID com.feaneron.Boatswain을 함께 확인하세요. 공식 페이지에는 Free와 Linux x86_64·aarch64 지원이 표시됩니다. GNOME 앱 페이지의 표시 버전은 6.0이며, stable 설치 참조 파일도 이 앱 ID를 가리킵니다.
Flatpak과 Flathub가 설정된 Linux라면 소프트웨어 센터에서 Boatswain을 찾아 설치할 수 있습니다. 공식 .flatpakref 파일을 받아 소프트웨어 센터에서 여는 방법도 있습니다. 참조 파일만 받은 상태는 설치 완료가 아니므로 앱 목록에 Boatswain이 생겼는지 확인하세요.
Elgato Stream Deck을 USB로 연결하고 Boatswain을 엽니다. 장치가 인식되면 화면 왼쪽의 장치 선택 영역에 모델 이름이 나타나고, 가운데 버튼 배열이 보입니다. 공식 화면에는 Stream Deck Mini, Stream Deck, Stream Deck + 예시가 있으며 실제 표시는 연결한 모델에 따라 달라집니다.
장치가 보이지 않을 때는 우선 USB 연결과 Linux의 장치 접근 권한을 확인하세요. 공식 프로젝트 README는 많은 Elgato 모델이 udev v250부터 지원되지만 일부 모델은 더 높은 버전이 필요하다고 설명하며, 구형 환경에서 적용할 udev 규칙도 제공합니다. 자신의 장치 모델과 udev 버전을 먼저 대조하세요.
장치 지원을 일반적인 Stream Deck이라는 이름 하나로 판단하지 마세요. 공식 README는 Stream Deck XL v2는 udev v252, Stream Deck Pedal은 v253이 필요하다고 따로 적습니다. 같은 제조사 장치라도 모델별 USB 식별자와 권한 조건이 다르므로, 장치를 고르거나 문제를 해결할 때 정확한 모델명을 확인해야 합니다.
- Flathub에서 Boatswain과 com.feaneron.Boatswain을 대조해 설치합니다.
- Elgato Stream Deck을 USB로 연결합니다.
- Boatswain을 열고 왼쪽 장치 목록과 가운데 버튼 배열을 확인합니다.
- 장치가 없다면 USB와 공식 README의 모델별 udev 조건을 확인합니다.
OBS Studio 장면 전환 버튼 만들기
장치가 인식됐다면 OBS Studio에서 사용할 장면을 먼저 만들어 이름을 확인하세요. OBS와 Boatswain이 통신하도록 obs-websocket을 준비하고 연결 정보를 맞춰야 합니다. OBS 장면 전환 기능은 화면만 꾸민다고 작동하지 않으므로 이 준비를 건너뛰지 마세요.
Boatswain 가운데 배열에서 비어 있는 버튼을 고른 다음 Actions 목록을 엽니다. 공식 화면에는 OBS Studio 아래에 Switch Scene, Record, Stream 등이 표시됩니다. Switch Scene을 선택하면 해당 버튼의 Button Properties에서 Scene과 Connection Settings를 볼 수 있습니다.
Scene에는 OBS에 실제로 있는 장면을 지정하고 Connection Settings를 열어 OBS 연결 정보를 맞추세요. 버튼 이름과 색을 바꿔 장면을 구분할 수도 있습니다. 화면에 보이는 Before, Main Scene 같은 이름은 예시이므로 자신의 OBS 장면 이름을 사용해야 합니다.
설정을 저장한 뒤 OBS가 실행 중인 상태에서 Stream Deck의 해당 물리 버튼을 누르세요. OBS 미리보기 또는 프로그램 화면이 지정한 장면으로 바뀌는지 확인합니다. 바뀌지 않으면 버튼에 Switch Scene이 배치됐는지와 연결 정보, OBS의 obs-websocket 상태를 순서대로 점검하세요.
공식 Actions 목록의 OBS Studio 영역에는 Switch Scene 외에 Record, Stream, Virtual Camera, Toggle Mute, Show / Hide Source도 보입니다. 처음에는 방송 송출이나 녹화에 영향을 주지 않는 장면 전환으로 연결을 시험하세요. 연결이 확인된 뒤 필요한 동작을 하나씩 추가해야 버튼이 무슨 일을 했는지 구분하기 쉽습니다.
장면 전환이 잘 되면 다른 버튼에 녹화나 송출 동작을 배치할 수 있습니다. 다만 방송 시작이나 녹화는 실제 작업에 영향을 주므로 먼저 시험용 장면에서 버튼 한 개만 설정해 동작을 확인한 뒤 확장하는 편이 안전합니다.
- OBS Studio에 전환할 장면을 만들고 obs-websocket 연결을 준비합니다.
- Boatswain에서 빈 버튼을 선택하고 Actions → OBS Studio → Switch Scene을 고릅니다.
- Button Properties의 Scene과 Connection Settings를 자신의 OBS 설정에 맞춥니다.
- 물리 버튼을 눌러 OBS 화면이 지정한 장면으로 바뀌는지 확인합니다.
프로필과 다른 버튼 동작 정리하기
왼쪽 프로필 목록은 방송 준비, 게임, 회의처럼 버튼 구성을 나누는 데 쓸 수 있습니다. 공식 화면에서는 기본 프로필과 새 프로필 항목이 보이며, 프로필을 바꾸면 각 프로필에 배치한 버튼 구성을 구분할 수 있습니다. 자주 쓰는 장면을 한 프로필에 모아 두면 버튼 이름을 찾기 쉽습니다.
효과음이 필요한 경우 Actions 목록의 Soundboard에서 Play Audio를 선택할 수 있습니다. 공식 목록에는 Music Player 항목도 있어 현재 음악 플레이어를 제어하는 동작을 찾을 수 있습니다. 어떤 파일과 플레이어가 실제로 동작하는지는 Linux의 오디오 환경과 선택한 작업 설정에 따라 확인해야 합니다.
버튼 아이콘과 배경색은 오른쪽 Button Properties에서 구분할 수 있습니다. 공식 화면에는 선택된 버튼의 Name, Background Color와 동작별 추가 항목이 보입니다. 같은 색으로 여러 장면을 만들면 헷갈릴 수 있으므로 이름과 색을 실제 동작에 맞춰 지정하세요.
점수를 화면에서 세고 싶다면 공식 화면의 SCORE 버튼 예시도 참고할 수 있습니다. 해당 Button Properties에는 Restore Score, Text Color, Save to File, File 항목이 보입니다. 텍스트 파일로 저장하려면 Save to File과 파일 위치를 별도로 정해야 하며, 이 항목을 켜지 않은 점수가 자동으로 파일에 기록된다고 생각하면 안 됩니다.
화면에서 여러 버튼을 설정할 때는 프로필 이름을 먼저 정하고 그 안에서 장면 전환, 소리 재생, 점수 관리처럼 목적별 버튼을 배치하세요. 처음부터 모든 기능을 채우기보다 실제 Stream Deck에서 쉽게 찾을 위치에 자주 쓰는 동작을 둔 다음 한 버튼씩 눌러 결과를 확인하는 흐름이 실수를 줄입니다.
설정 후에는 버튼 배열을 눈으로 확인하고 물리 장치에서도 같은 위치를 눌러 보세요. 화면에서 예쁘게 배치돼 있어도 장치가 연결되지 않았거나 대상 앱이 실행 중이지 않으면 기대한 결과가 나오지 않습니다.
장치나 OBS 동작이 안 될 때
Boatswain에 장치 이름이 보이지 않으면 USB 포트·케이블·전원을 먼저 확인하세요. 이어 프로젝트 README의 지원 모델과 udev 버전을 확인합니다. 예를 들어 README는 Stream Deck XL v2에 udev v252, Stream Deck Pedal에 v253이 필요하다고 구분합니다. 규칙 추가가 필요한 구형 환경은 README의 해당 모델 예시를 따라야 합니다.
장치는 보이지만 OBS 장면이 바뀌지 않으면 Stream Deck 자체 문제와 OBS 연결 문제를 나눠 보세요. 버튼에 Switch Scene이 설정됐는지, Scene이 실제 장면 이름과 맞는지, Connection Settings와 obs-websocket 상태가 맞는지 확인합니다.
다른 동작은 되는데 음악 플레이어 제어만 안 되면 재생할 앱이 실행 중인지부터 확인하세요. 공식 기능 설명은 음악 플레이어 제어를 지원한다고 하지만 모든 재생 앱의 동작을 보장하지는 않습니다. 사용하는 플레이어에서 실제로 한 버튼을 시험해 결과를 확인하는 것이 정확합니다.
자주 묻는 질문
Boatswain은 무료인가요?
네. 공식 Flathub에 Free로 표시되는 Linux 앱입니다.
Stream Deck 장치 없이 버튼을 사용할 수 있나요?
물리 버튼 동작을 쓰려면 Elgato Stream Deck 장치가 필요합니다. 앱 설치만으로 물리 버튼이 생기지는 않습니다.
OBS Studio 장면 전환에는 무엇이 필요한가요?
OBS에 전환할 장면을 만들고 obs-websocket 연결을 준비한 뒤 Boatswain의 Switch Scene과 Connection Settings를 설정해야 합니다.
장치가 목록에 없으면 무엇을 먼저 보나요?
USB 연결을 확인하고 공식 README의 모델별 udev 버전·규칙을 대조하세요.
Windows용 설치 파일인가요?
이 글에서 확인한 공식 Flathub 파일은 Linux x86_64·aarch64용입니다. Windows 설치 파일로 안내하지 않습니다.
장치 한 버튼으로 먼저 시험해 보세요
Boatswain을 설치하고 Stream Deck이 장치 목록에 나타나는지 확인한 뒤, OBS 장면 전환 버튼 하나를 만들어 보세요. Switch Scene과 연결 설정을 맞추고 물리 버튼을 눌러 OBS 화면이 바뀌면 기본 설정이 된 것입니다.
그다음 프로필과 다른 동작을 추가하면 됩니다. 장치가 아예 보이지 않을 때는 OBS 설정을 만지기 전에 USB와 udev 조건부터 확인하는 것이 빠릅니다.
공식 자료와 확인일
Boatswain 공식 GNOME 기능·화면 · Boatswain 공식 Flathub 무료 배포·버전 · Boatswain 공식 저장소 udev·장치 조건 · Flatpak 공식 설치 준비 안내 | 2026-10-29T14:02:39.384186+00:00
