Boatswain 무료 다운로드·설치 방법, 리눅스에서 스트림덱 버튼 설정하기
Boatswain은 Elgato Stream Deck 버튼과 프로필을 Linux에서 설정하는 무료 앱입니다. 공식 Flathub stable의 com.feaneron.Boatswain.flatpakref를 받아 Flatpak을 지원하는 소프트웨어 센터에서 설치할 수 있습니다. 실제 버튼 동작에는 호환 장치가 필요합니다.
Boatswain Linux Flatpak 설치 참조 파일
Flathub에는 Free와 Linux x86_64·aarch64 지원이 표시됩니다. GNOME 앱 페이지의 표시 버전은 6.0입니다. stable 참조 파일은 버전을 고정하지 않으므로 설치 화면에서 앱 ID와 버전을 확인하세요.
받을 파일과 장치 조건 확인하기
Boatswain의 공식 Flathub 페이지에서 앱 ID com.feaneron.Boatswain, Free, Linux x86_64·aarch64 표시를 확인하세요. GNOME 앱 페이지에는 현재 표시 버전 6.0과 Elgato Stream Deck 제어 용도가 나옵니다.
com.feaneron.Boatswain.flatpakref는 Flathub stable 앱을 가리키는 설치 참조 파일입니다. 프로그램 본체와 필요한 런타임이 모두 들어 있는 오프라인 설치 파일은 아닙니다. 설치 과정에서 인터넷으로 앱 파일을 받아야 합니다.
버튼 설정을 실제 장치에서 사용하려면 호환 Elgato Stream Deck을 USB로 연결해야 합니다. OBS Studio 장면 전환까지 쓰려면 OBS와 obs-websocket 연결도 준비하세요. 장치가 없다면 설치는 가능해도 물리 버튼 동작을 시험할 수 없습니다.
- Linux x86_64·aarch64 환경과 Flatpak·Flathub 설정을 확인합니다.
- 사용할 Elgato Stream Deck 모델과 USB 연결 상태를 확인합니다.
- 공식 stable com.feaneron.Boatswain.flatpakref를 받습니다.
Boatswain 설치하고 첫 장치 보기
받은 .flatpakref를 Flatpak 참조 파일을 처리하는 소프트웨어 센터에서 엽니다. 설치 화면에 Boatswain과 com.feaneron.Boatswain가 표시되는지 확인한 뒤 설치하세요. 실제 제공 버전은 설치 화면에서 확인합니다.
설치가 끝나면 앱 목록에서 Boatswain을 열고 Stream Deck을 USB에 연결합니다. 화면 왼쪽에 장치 이름, 가운데에 버튼 배열이 나타나는지 확인하세요. 연결한 모델에 따라 버튼 수와 배열은 다릅니다.
장치가 표시되지 않으면 USB 연결을 확인한 뒤 공식 프로젝트 README의 udev 지원 조건을 모델별로 살펴보세요. 많은 Elgato 모델은 udev v250부터 지원하지만 XL v2와 Pedal 등은 더 높은 버전이 필요합니다.
- .flatpakref를 열고 앱 ID를 대조해 설치합니다.
- Stream Deck을 연결하고 Boatswain을 실행합니다.
- 장치 이름과 버튼 배열이 나오는지 확인합니다.
다운로드·설치 또는 버튼 연결이 막힐 때
.flatpakref를 열 앱이 없다고 나오면 Linux에 Flatpak과 이를 처리하는 소프트웨어 센터가 준비됐는지 확인하세요. Flathub 저장소를 설정한 뒤 소프트웨어 센터에서 com.feaneron.Boatswain을 직접 검색하는 방법도 있습니다.
설치 중 멈춘다면 네트워크와 저장 공간을 점검하세요. 작은 참조 파일을 받는 것과 앱 본체·런타임 설치는 다른 단계입니다. 설치가 끝나야 Boatswain이 앱 목록에 나타납니다.
앱은 열리는데 장치가 없으면 USB 연결과 프로젝트 README의 udev 조건을 확인하세요. 장치가 보여도 OBS 장면이 바뀌지 않는다면 obs-websocket, OBS의 장면 이름, Boatswain의 Connection Settings와 Scene을 확인합니다.
자주 묻는 질문
어떤 파일을 받나요?
공식 Flathub stable의 com.feaneron.Boatswain.flatpakref입니다. Linux용 설치 참조 파일입니다.
파일만 받으면 오프라인 설치가 되나요?
아니요. 실제 앱과 런타임은 설치 단계에서 받아야 합니다.
Elgato Stream Deck이 꼭 필요한가요?
실제 물리 버튼 동작을 쓰려면 호환 Stream Deck 장치가 필요합니다.
OBS Studio 장면 전환은 설치만 하면 되나요?
아니요. OBS의 obs-websocket 연결과 Boatswain의 Scene·Connection Settings도 설정해야 합니다.
설치 뒤 장치 인식부터 확인하세요
Flathub stable 참조 파일로 Boatswain을 설치한 뒤 Stream Deck을 연결하세요. 앱 왼쪽의 장치 이름과 가운데 버튼 배열이 보이면 첫 단계를 마친 것입니다.
OBS Studio를 사용할 계획이라면 obs-websocket과 장면 이름을 확인하고 버튼 하나에 Switch Scene을 설정해 실제 장치에서 눌러 보세요. 장치 인식이 먼저 안 된다면 USB와 udev 조건부터 점검하세요.