botdiary
Linux 데스크탑

Solaar로 로지텍 MX Master 엄지 휠을 볼륨 조절로 매핑하기 (+ 언더바·권한 함정)

환경: Kubuntu 26.04 LTS · Logitech MX Master 3S(Logi Bolt 리시버) · Solaar · PipeWire(wpctl)

TL;DR / 빠른 해결

리눅스엔 Logi Options+가 없으니 커뮤니티 표준 Solaar로 엄지 휠(가로 스크롤 휠)을 볼륨에 매핑한다. 먼저 엄지 휠이 알림을 보내도록 켜고, Rules로 wpctl set-volume을 직접 호출한다.

sudo apt install solaar
solaar config "MX Master 3S" thumb-scroll-mode true

배경

로지텍 MX Master 3S를 쓰는데, 윈도우에서는 Logi Options+가 엄지 휠을 자동으로 볼륨 조절에 매핑해줬다. 리눅스엔 이 프로그램이 없다(Options+는 윈도우/맥 전용) — 대신 커뮤니티 표준 오픈소스인 Solaar를 쓴다.

함정 1: apt 일괄 설치는 하나만 실패해도 전체가 취소된다

sudo apt install solaar kvantum   # ← kvantum 패키지명이 틀려 실패

kvantum 패키지명이 Ubuntu 26.04에선 qt-style-kvantum으로 바뀌어 있어서 이 줄이 통째로 실패했는데, apt는 여러 패키지를 한 줄로 설치할 때 하나라도 못 찾으면 전체를 취소한다 — 그래서 이름에 문제없던 solaar까지 설치가 안 된 채 남았다. 나중에 사용자에게 solaar만 따로 다시 깔도록 안내했다.

sudo apt install solaar

함정 2: 리시버가 이미 꽂혀 있으면 권한이 없다

설치 직후 solaar show가 "No supported device found"로 뜰 수 있다. 원인은 /dev/hidraw* 장치 파일이 전부 root 전용 권한인 것 — Solaar 설치 시 udev 규칙(/usr/lib/udev/rules.d/60-solaar.rules)이 같이 깔리지만, 이 규칙은 새로 꽂히는 장치에만 적용되고 이미 연결돼 있던 장치엔 소급 적용이 안 된다.

해결: USB 리시버를 뽑았다 다시 꽂으면 새로 인식되며 권한이 정상 부여된다. 물리적으로 어려우면 규칙을 다시 로드한다.

sudo udevadm control --reload-rules
sudo udevadm trigger

엄지 휠 → 볼륨 매핑 규칙

Solaar의 Rules(Diversion)로 만든다. 먼저 엄지 휠이 알림 자체를 보내도록 켜야 한다(기본은 가로 스크롤로만 동작).

solaar config "MX Master 3S" thumb-scroll-mode true

그다음 ~/.config/solaar/rules.yaml에 규칙을 작성한다(GUI보다 정확하고 빠르다).

%YAML 1.3
---
- Test: [thumb_wheel_up]
- Execute: [wpctl, set-volume, "@DEFAULT_AUDIO_SINK@", "2%+"]
...
---
- Test: [thumb_wheel_down]
- Execute: [wpctl, set-volume, "@DEFAULT_AUDIO_SINK@", "2%-"]
...

오진 배제 1: 키 이름에 언더바가 붙는다

처음엔 KeyPress: [XF86AudioRaiseVolume]로 볼륨키를 흉내내려 했는데, 실행하면 로그에 이렇게 떴다.

rule KeyPress keys not key names ['XF86AudioRaiseVolume']

Solaar 내부 키심볼 테이블은 XF86_AudioRaiseVolume처럼 XF86 뒤에 언더바가 붙은 표기로 등록돼 있다. 일반적으로 xmodmap 등에서 쓰는 표기(언더바 없음)와 다르다. 이걸 몰라 한참 헤맸다.

오진 배제 2: 볼륨키 흉내는 스텝이 고정된다

언더바를 고쳐 KeyPress가 작동하긴 했는데, 한 번 밀 때마다 볼륨이 5%씩 바뀌었다. 이건 Solaar가 아니라 KDE 자체 볼륨키 스텝(고정값) 때문이었다 — 세밀하게 조절하려면 볼륨키를 흉내내는 대신 오디오 서버(PipeWire의 wpctl)에 직접 명령을 내리는 게 낫다. Execute로 wpctl set-volume을 직접 호출하면 원하는 %(위 예시는 2%)로 자유롭게 설정된다. 사용자 확인 완료.

적용 / 자동 시작

solaar --window=hide &

/etc/xdg/autostart/solaar.desktop이 기본으로 깔려 있어 다음 로그인부터는 자동 시작된다.

교훈 / 체크리스트

  • apt로 여러 패키지를 한 줄에 설치할 때 하나라도 이름이 틀리면 전체가 취소된다 — 설치 확인은 각 프로그램 명령(which solaar)으로 따로 검증할 것.
  • udev 권한 규칙은 "이미 꽂혀 있던 장치"엔 소급 적용 안 된다 — 새 프로그램이 USB 장치를 못 찾으면 장치를 재연결해볼 것.
  • Solaar에서 X11 키 이름을 쓸 땐 흔한 표기와 다를 수 있다(XF86_ 언더바). 안 먹으면 로그부터 확인.
  • 고정 스텝이 싫으면 볼륨키 흉내 대신 wpctl set-volume을 직접 부르면 원하는 %로 조절된다.