Canberra GTK 모듈은 리눅스 환경에서 GTK+ 2 및 GTK+ 3 애플리케이션에 사운드 이벤트 피드백을 제공하는 라이브러리입니다. 이 모듈을 활용하면 버튼 클릭, 대화 상자 열기, 메뉴 선택과 같은 사용자 인터페이스(UI) 이벤트에 효과음을 손쉽게 연동할 수 있습니다.
그런데 리눅스에서 애플리케이션이 canberra-gtk 모듈을 불러오려고 할 때 "failed to load module canberra-gtk-module" 오류가 발생하는 경우가 있습니다.
이 글에서는 해당 오류가 발생하는 원인과 이를 해결하는 구체적인 방법을 배포판별로 단계별로 안내합니다.
canberra-gtk-module 로드 실패 오류의 원인
이 오류가 나타나는 주요 원인은 다음과 같습니다.
- 프로그램(주로 GTK 기반 애플리케이션)이 gtk 모듈을 필요로 하지만 시스템이 해당 모듈을 불러오지 못할 때
- 시스템에 모듈 자체가 설치되어 있지 않을 때
- 터미널에서 "canberra-gtk" 관련 명령을 실행했을 때 동일한 오류가 출력된다면, 시스템이 모듈을 찾지 못한다는 확실한 증거입니다.
해결 방법 1. canberra-gtk-module 설치하기
이 오류의 가장 근본적인 해결책은 시스템에 gtk 모듈을 설치하는 것입니다. 모듈은 대부분의 유명 리눅스 배포판 기본 저장소에서 제공되므로, 아래 절차에 따라 설치하면 됩니다.
1단계. 패키지 목록 업데이트
먼저 패키지 목록을 최신 상태로 갱신합니다.
Debian/Ubuntu:
sudo apt update
Arch 계열:
sudo pacman -Syu
CentOS/RHEL:
sudo yum check-update
Fedora:
sudo dnf check-update
2단계. 모듈 설치
패키지 목록이 갱신되면 아래 명령으로 모듈을 설치합니다. Fedora/CentOS에서는 패키지 이름이 libcanberra-gtk3이며, Debian/Ubuntu 계열에서는 libcanberra-gtk-module을 설치합니다.
Debian/Ubuntu:
sudo apt install libcanberra-gtk-module
Arch:
sudo pacman -Syu libcanberra
CentOS/RHEL:
sudo yum install libcanberra-gtk3
Fedora:
sudo dnf install libcanberra-gtk3
3단계. 환경 변수 설정
마지막으로 export 명령으로 GTK_MODULES 환경 변수를 지정하면 시스템이 모듈을 올바르게 불러올 수 있습니다.
export GTK_MODULES=canberra-gtk-module
해결 방법 2. canberra-gtk 모듈 재설치하기
설치된 모듈 파일이 손상되어 시스템이 모듈을 인식하지 못하는 경우도 있습니다. 이때는 기존 모듈을 완전히 제거한 뒤 새로운 복사본을 재설치해야 합니다.
1단계. 기존 모듈 완전히 제거
사용 중인 배포판에 맞는 명령으로 모듈을 삭제합니다.
Debian/Ubuntu:
sudo apt autoremove canberra-gtk-module
CentOS:
sudo yum autoremove canberra-gtk-module
Fedora:
sudo dnf autoremove canberra-gtk-module
2단계. 모듈 재설치
모듈을 제거했다면 위의 [해결 방법 1]의 1~3단계를 그대로 따라 최신 버전을 다시 설치하고, 환경 변수 설정까지 마쳐 주세요.
마무리
"failed to load module canberra-gtk-module" 오류는 리눅스 시스템이 GTK 모듈을 찾거나 사용하려 할 때 해당 모듈을 불러오지 못해 발생합니다. 해결 방법은 크게 두 가지로, canberra-gtk 모듈을 새로 설치하거나 기존 모듈을 삭제한 후 재설치하는 것입니다. 설치 후에는 반드시 환경 변수까지 등록해야 모듈이 정상적으로 작동합니다.
저자 소개
Kevin Arrows
Kevin Arrows는 10년 이상의 업계 경력을 보유한 베테랑 기술 전문가입니다. Microsoft Certified Technology Specialist(MCTS) 자격증을 보유하고 있으며, 최신 기술 동향을 꾸준히 학습하는 데 큰 열정을 가지고 있습니다. 소프트웨어 개발, 사이버 보안, 클라우드 컴퓨팅 등 다양한 IT 분야에서 폭넓게 집필해 왔으며, 복잡한 기술 개념을 명확하고 간결하게 설명하는 능력으로 동료들에게 폭넓은 신뢰와 인정을 받고 있습니다.