Piper 0.8 무료 다운로드·설치, 리눅스 게이밍 마우스 DPI 바꾸기·버튼 설정

리눅스에서 게이밍 마우스를 연결했는데 움직임이 지나치게 빠르거나 측면 버튼을 원하는 동작으로 바꿀 수 없다면 Piper를 확인해 보세요. Piper는 지원되는 마우스의 DPI, 버튼, LED와 프로필을 화면에서 조정하는 무료 프로그램입니다. 다만 마우스와 직접 통신하는 프로그램은 아닙니다. 시스템에 libratbag의 ratbagd가 설치되어 실행 중이어야 하며, 쓰는 마우스가 libratbag의 지원 대상이어야 합니다.

공식 Flathub는 Piper 0.8의 Linux x86_64·aarch64 배포를 무료로 표시합니다. 설치 파일을 받기 전에 모델 지원과 ratbagd 준비 상태를 먼저 확인하면, 화면만 설치해 놓고 마우스가 나타나지 않는 일을 줄일 수 있습니다. 아래에서는 제품 이름과 앱 ID를 대조하는 방법부터 DPI·버튼·LED 설정 화면에서 무엇을 확인해야 하는지 순서대로 정리했습니다.

Piper

libratbag developers

0.8버전

Linux x86_64·aarch64지원 환경

Flathub Flatpak공식 배포 경로

무료·GPL-2.0-or-later이용

Piper 0.8 Linux 마우스 설정 무료 다운로드

Piper는 마우스 설정을 어디에 전달하나요?

Piper는 마우스 설정을 보여 주고 바꾸는 그래픽 화면입니다. 공식 GitHub 설명에 따르면 Piper가 ratbagd라는 시스템 서비스와 통신하고, ratbagd가 libratbag을 통해 실제 장치에 접근합니다. 따라서 Piper 창이 열린다는 사실만으로 모든 기능을 쓸 수 있는 것은 아닙니다. 서비스가 없거나 멈춰 있으면 장치를 찾지 못할 수 있고, 지원 목록에 없는 마우스라면 설치만으로 새 기능이 생기지 않습니다.

설정을 시작하기 전에 마우스의 정확한 모델명을 확인하세요. 같은 브랜드라도 모델과 펌웨어에 따라 가능한 작업이 다를 수 있습니다. libratbag의 공식 장치 파일 목록은 알려진 장치를 확인하는 출발점입니다. 목록에 모델이 있더라도 버튼이나 조명 기능이 제조사 소프트웨어와 완전히 같다고 단정하면 안 됩니다. 공식 프로젝트도 장치별 프로토콜이 다르고 제공 기능이 달라질 수 있다고 안내합니다.

Piper는 DPI를 바꾸는 작업, 버튼에 다른 동작을 배정하는 작업, LED 색을 고르는 작업을 한곳에 모아 둡니다. 지원 장치에서는 프로필도 추가하거나 제거할 수 있습니다. 이 글에서는 화면에 보이는 항목을 설명하되, 실제로 표시되는 메뉴와 저장 가능한 값은 연결한 마우스에 따라 달라진다는 점을 전제로 합니다.

Piper의 버튼·LED·DPI 설정 화면

공식 Flathub에 게시된 예시 화면입니다. 버튼별 동작, LED 항목, DPI 목록과 Apply 버튼이 보입니다. 게시 이미지가 현재 0.8 버전의 정확한 화면이라는 뜻은 아니며, 실제 항목은 마우스 지원 범위에 따라 달라집니다.

Piper 0.8 Linux 마우스 설정 무료 다운로드

프로그램	Piper 0.8
제작	libratbag developers
배포 경로	Flathub Linux Flatpak
앱 ID	org.freedesktop.Piper
지원 환경	Linux x86_64·aarch64
필수 서비스	libratbag의 ratbagd
라이선스	GPL-2.0-or-later
설치 참조 파일	org.freedesktop.Piper.flatpakref

마우스 모델과 ratbagd를 먼저 확인하기

Piper를 설치할 생각이라면 먼저 마우스의 제품명과 모델 번호를 확인하세요. 제조사 이름만으로 지원 여부를 판단하기 어렵습니다. libratbag 공식 저장소의 data/devices 장치 파일을 찾고, 모델이나 식별 정보가 있는지 살펴보는 편이 정확합니다. 목록은 알려진 장치에 대한 자료이며, 해당 기기의 모든 기능을 보장하는 표는 아닙니다. 특히 버튼 수와 LED 영역은 하드웨어마다 다를 수 있습니다.

다음으로 리눅스 배포판의 패키지 관리 화면에서 libratbag과 ratbagd를 확인하세요. 공식 Flathub 설명은 ratbagd가 설치되고 실행 중이어야 Piper가 마우스와 통신한다고 분명히 말합니다. Piper용 Flatpak 설치 참조 파일을 받는 것만으로 호스트 시스템의 ratbagd까지 준비된다고 생각하면 안 됩니다. 배포판마다 서비스 준비 방법이 달라 특정 명령 한 줄을 모든 환경의 정답처럼 쓰지 않는 편이 안전합니다.

Piper를 연 뒤 장치가 보이지 않으면 무작정 DPI 값을 다시 입력하기보다 서비스 상태, 모델 지원, 연결 상태를 차례로 나눠 확인하세요. 공식 Piper 프로젝트의 설명에 나오는 쥐덫 화면은 ratbagd가 실행되지 않거나 버전이 맞지 않는 경우 등에 나타날 수 있습니다. 원인이 한 가지로 고정된 오류 문구는 아니므로, 정확한 오류를 보고 시스템 설정을 확인해야 합니다.

마우스의 정확한 모델명을 확인합니다.
libratbag 장치 목록에서 해당 모델의 정보를 찾습니다.
배포판에서 ratbagd가 설치되고 실행 중인지 확인합니다.

공식 Flatpak 경로에서 Piper 설치하기

공식 Flathub 페이지에서 Piper 이름과 org.freedesktop.Piper 앱 ID를 확인하세요. 현재 확인한 표시 버전은 0.8이며 Linux x86_64와 aarch64가 제공됩니다. Flathub의 이 패키지는 커뮤니티가 제공하며 개발자 인증 배포가 아니라는 안내도 함께 보입니다. 따라서 배포 주체를 혼동하지 말고 설치 화면에서 출처와 앱 ID를 다시 대조하세요.

연결된 파일은 org.freedesktop.Piper.flatpakref입니다. .flatpakref는 앱 전체가 들어 있는 실행 파일이 아니라 Flatpak에 앱과 저장소 정보를 알려 주는 참조 파일입니다. 리눅스에 Flatpak 및 Flathub 저장소가 준비돼 있어야 설치 도구가 실제 앱을 가져올 수 있습니다. 참조 파일을 저장한 시점과 프로그램 설치가 끝난 시점을 구분하고 설치 완료 표시까지 기다리세요.

앱 목록에 Piper가 나타나면 실행해 연결된 마우스가 화면에 보이는지 확인합니다. 화면이 열려도 장치가 없다면 앞에서 확인한 ratbagd와 모델 지원을 다시 점검해야 합니다. 이 설치 경로는 Linux Flatpak을 위한 것이므로 Windows나 macOS에서 같은 파일을 열어 사용하는 방법으로 소개하지 않습니다. 버전 표시는 나중에 바뀔 수 있어 설치 직전 다시 확인하는 것이 좋습니다.

Linux x86_64·aarch64와 Flatpak 사용 가능 여부를 확인합니다.
Flathub의 Piper 0.8과 org.freedesktop.Piper 앱 ID를 대조합니다.
.flatpakref를 열어 설치를 마친 뒤 장치 인식 상태를 확인합니다.

DPI와 프로필을 목적에 맞게 바꾸기

마우스가 인식되면 먼저 Resolutions 화면의 현재 DPI를 확인해 보세요. 공식 화면에는 여러 DPI 값과 Active 표시가 보입니다. 화면에서 쓰는 값을 바꿀 수 있는지는 해당 마우스의 지원 기능에 달려 있습니다. 포인터가 지나치게 빨라 세밀한 선택이 어렵다면 평소 사용하던 값과 변경값을 적어 두고 조금씩 조정하세요. 숫자를 크게 올리는 것이 항상 좋은 설정은 아닙니다.

게임과 문서 작업에서 다른 감도가 필요하다면 프로필을 나누는 방법을 생각할 수 있습니다. Piper의 공식 소개에는 프로필을 추가하고 제거하는 기능이 포함되어 있습니다. 다만 프로필 개수, 저장 위치, 마우스 자체 전환 기능은 장치별로 다를 수 있습니다. 변경 전에 기존 프로필과 값을 기록해 두면 원하는 설정을 찾지 못했을 때 다시 돌아가기 쉽습니다.

공식 예시 화면에는 프로필 이름과 Apply 버튼이 나타납니다. 조정한 뒤 적용 동작이 필요한지 화면을 확인하고, 실제 포인터를 움직여 변경이 반영됐는지 살펴보세요. 설정 화면의 수치만 바뀌었는데 사용 느낌이 같다면 연결한 장치가 그 값을 지원하는지, 다른 프로필이 활성화돼 있는지, ratbagd 연결이 유지되는지를 차례로 확인해야 합니다.

현재 활성 DPI와 프로필을 적어 둡니다.
작은 폭으로 DPI를 바꾸고 적용합니다.
실제 포인터 움직임을 확인한 뒤 필요한 프로필을 정리합니다.

측면 버튼과 LED 동작 조정하기

측면 버튼을 자주 누르는 작업에 쓰고 싶다면 Buttons 화면에서 각 버튼에 배정된 현재 동작부터 읽어 보세요. 공식 이미지에는 앞으로, 뒤로와 해상도 전환 같은 동작이 버튼 위치에 연결되어 보입니다. 기능을 바꾸기 전에 원래 배정을 기록하면 웹 브라우저 뒤로 가기 같은 익숙한 동작이 갑자기 사라졌을 때 되돌리기 쉽습니다. 버튼이 화면에 없다면 그 위치가 지원되지 않는 기기일 수 있습니다.

LEDs 화면은 지원 장치의 조명 항목을 다룹니다. 공식 이미지에는 마우스의 두 영역에 연결된 색 설정 항목이 보입니다. 하지만 모든 마우스에 조명이 있거나 영역을 따로 조정할 수 있는 것은 아닙니다. 색을 바꿨다면 저장 또는 적용 상태를 확인하고, 마우스를 다시 연결했을 때도 의도한 색이 남는지 살펴보세요. 지속 여부 역시 장치와 프로필 구현에 영향을 받습니다.

설정을 여러 개 동시에 바꾸면 어떤 조작이 문제를 일으켰는지 알기 어렵습니다. DPI, 버튼, LED 순서로 한 종류씩 변경하고 실제 사용 환경에서 확인하세요. 게임에서 버튼 입력이 다르게 작동한다면 먼저 Piper에 저장된 배정과 게임 자체의 키 설정을 각각 확인해야 합니다. 마우스 프로그램과 게임 설정은 서로 다른 곳에 보관되는 값입니다.

Buttons에서 원래 버튼 동작을 기록합니다.
한 버튼씩 바꾸고 실제 입력을 확인합니다.
LED가 지원되면 색을 적용하고 유지되는지 확인합니다.

장치가 보이지 않거나 설정이 적용되지 않을 때

Piper 창만 보이고 마우스가 목록에 없다면 프로그램 설치와 장치 연결 문제를 구분하세요. 공식 프로젝트는 Piper가 ratbagd의 앞단 화면이라고 설명합니다. ratbagd가 없거나 실행되지 않았다면 지원 마우스도 표시되지 않을 수 있습니다. 먼저 배포판에서 서비스를 확인하고, 마우스를 다시 연결한 뒤 같은 앱 ID의 Piper가 실행 중인지 살펴보세요.

서비스가 정상이어도 모델이 지원 목록에 없다면 Piper만 다시 설치해서 해결되지는 않습니다. libratbag의 장치 파일과 이슈에서 모델 식별 정보를 찾아보세요. 모델 이름이 비슷한 다른 제품을 같은 기기로 취급해서는 안 됩니다. 장치가 보이지만 특정 버튼이나 LED 메뉴가 없다면 앱 오류라고 단정하기 전에 그 모델에서 노출되는 기능 범위를 확인해야 합니다.

값을 바꿨는데 사용 중 원래대로 돌아오면 어느 프로필에서 저장했는지, 적용 버튼을 눌렀는지, 장치를 다시 연결했을 때도 같은지 확인하세요. 문제를 보고할 때는 배포판, Piper 버전, ratbagd 버전, 마우스 모델과 나타난 화면을 함께 적으면 원인을 좁히기 쉽습니다. 공식 도움말의 쥐덫 표시는 서비스 미실행뿐 아니라 버전 문제 등 여러 이유로 생길 수 있으므로 보이는 증상을 그대로 기록하는 것이 좋습니다.

ratbagd 설치·실행 상태를 확인합니다.
정확한 마우스 모델과 장치 지원 목록을 대조합니다.
프로필·Apply 상태와 재연결 후 결과를 확인합니다.

자주 묻는 질문

Piper는 무료인가요?

공식 Flathub에서 Piper 0.8은 Free로 표시되며 GPL-2.0-or-later 라이선스로 배포됩니다.

Piper만 설치하면 모든 게이밍 마우스가 작동하나요?

아닙니다. 시스템의 ratbagd가 실행 중이어야 하고 마우스가 libratbag에서 지원되어야 합니다. 장치별 기능 범위도 다릅니다.

마우스 DPI는 어디에서 확인하나요?

지원되는 마우스를 인식한 뒤 Resolutions 화면에서 현재 값과 활성 상태를 확인하세요. 변경 후 적용 여부도 살펴보세요.

버튼과 LED가 화면에 안 보이는 이유는 무엇인가요?

연결한 마우스가 해당 기능을 제공하지 않거나 libratbag이 그 기능을 지원하지 않을 수 있습니다. 모델별 지원과 ratbagd 상태를 확인하세요.

Windows에서 같은 파일을 사용할 수 있나요?

이 페이지의 .flatpakref는 Linux x86_64·aarch64용 Flatpak 설치 참조 파일입니다. Windows 설치 파일이 아닙니다.

모델 지원을 확인한 뒤 한 항목씩 바꾸세요

Piper는 지원되는 게이밍 마우스의 DPI·버튼·LED를 화면에서 조정하게 해 줍니다. 설치 전에 정확한 마우스 모델과 ratbagd 준비 상태를 확인하고, Flathub의 Piper 0.8 앱 ID를 대조하세요. 연결 뒤에는 원래 값을 적어 둔 다음 한 항목씩 바꾸고 실제 포인터와 버튼 입력으로 결과를 확인하는 편이 좋습니다.