Fedora 43 KDE Plasma Wayland - fcitx5 최적화 가이드

Fedora 43 KDE Plasma Wayland
fcitx5 최적화 가이드

작성일 2025-12-29

대상 Fedora 43 KDE Plasma Desktop (Wayland)

목적 fcitx5 한글 입력기 최상의 성능 구성

목차

• 개요
• 패키지 설치
• 환경변수 설정
• KDE Plasma 통합
• fcitx5 설정
• 검증 및 테스트
• 문제 해결
• 성능 비교
• 참고 자료

개요

왜 이 가이드인가?

Fedora 43 KDE Plasma Wayland 환경에서 fcitx5를 설정할 때 다음과 같은 문제들이 발생합니다:

• 공식 문서 대로만 하면 버벅거림 발생
• 환경변수 설정이 복잡하고 혼란스러움
• Wayland 네이티브 프로토콜 활용이 불명확

이 가이드의 목표

fcitx5 공식 권장사항과 KDE Plasma 6 Wayland 베스트 프랙티스를 통합하여 최적의 성능을 제공합니다.

핵심 원칙

1. Wayland 네이티브 우선: IM 모듈 대신 text-input 프로토콜 사용
2. KDE 통합: 가상 키보드 방식으로 fcitx5 실행
3. 최소 설정: 필요한 것만 설정하여 충돌 방지

📊 입력 프로토콜 아키텍처

Wayland text-input 프로토콜을 통한 직접 통신

패키지 설치

1단계: 필수 패키지 설치

$ # fcitx5 코어 패키지

$ sudo dnf install -y \

fcitx5 \

fcitx5-hangul \

fcitx5-configtool \

kcm-fcitx5

$ # Qt/GTK 통합 패키지

$ sudo dnf install -y \

fcitx5-qt5 \

fcitx5-qt6 \

fcitx5-gtk3 \

fcitx5-gtk4

설치 확인

$ fcitx5 --version

5.1.16

✓ 설치 성공

버전 5.1.16 이상이 출력되면 정상적으로 설치된 것입니다.

환경변수 설정

Wayland 네이티브 방식 (권장)

파일 생성: ~/.config/environment.d/fcitx5.conf

$ mkdir -p ~/.config/environment.d

$ cat > ~/.config/environment.d/fcitx5.conf << 'EOF'

# Fcitx5 Wayland Native Configuration

# Optimized for KDE Plasma 6 Wayland + Qt 6.8+ + GTK3/4

# XWayland applications only (필수)

# X11 기반 레거시 앱들을 위한 설정

XMODIFIERS=@im=fcitx

# QT_IM_MODULE과 GTK_IM_MODULE은 의도적으로 설정하지 않음

# 이유:

# - KDE Plasma Wayland는 text-input 프로토콜을 네이티브로 지원

# - GTK3/4는 text-input-v3 프로토콜을 자동으로 사용

# - IM 모듈을 우회하여 입력 지연과 버벅거림 최소화

EOF

중요 사항

⚠️ 절대 설정하지 말 것:

• QT_IM_MODULE=fcitx ← KDE Wayland에서 불필요
• GTK_IM_MODULE=fcitx ← 현대 GTK는 자동 처리
• XMODIFIERS=@im=fcitx5 ← 잘못된 값 (fcitx가 맞음)

✅ 설정해야 할 것:

• XMODIFIERS=@im=fcitx ← XWayland 앱 지원용

Legacy

IM Module

❌

Modern

text-input-v3

✓

Result

No Lag

KDE Plasma 통합

KDE 시스템 설정에서 가상 키보드 활성화

방법 1: GUI 설정 (권장)

1. 시스템 설정 열기 (systemsettings)
2. 입력 장치 → 가상 키보드
3. Fcitx 5 선택
4. 적용 클릭

⚙️ KDE 시스템 설정 경로

System Settings → Input Devices → Virtual Keyboard → Fcitx 5

방법 2: 명령줄 설정

$ # KWin 설정에 fcitx5 가상 키보드 등록

$ kwriteconfig6 --file kwinrc --group Wayland \

--key InputMethod "/usr/share/applications/org.fcitx.Fcitx5.desktop"

$ # KWin 재시작 (로그아웃 없이 적용)

$ qdbus org.kde.KWin /KWin reconfigure

설정 확인

$ cat ~/.config/kwinrc | grep -A2 "\[Wayland\]"

[Wayland]

InputMethod=/usr/share/applications/org.fcitx.Fcitx5.desktop

fcitx5 설정

입력기 추가

GUI 설정

$ # fcitx5 설정 도구 실행

$ fcitx5-configtool

1. 입력기 탭
2. 추가 버튼
3. 검색 제한 해제 체크
4. Hangul 검색 후 추가
5. 적용

🎯 fcitx5 설정 도구

한글 입력기를 추가하고 기본 입력기로 설정

한글 입력기 세부 설정

파일: ~/.config/fcitx5/conf/hangul.conf

# 키보드 자판
Keyboard=Dubeolsik

# 자동 재배열
AutoReorder=True

# Combine on Double Stroke
CombiOnDoubleStroke=False

# Combine Non Choseong
NonChoseongCombi=True

# 단어 단위 입력
WordCommit=False

# 한자 모드
HanjaMode=False

[HanjaModeToggleKey]
0=Hangul_Hanja
1=F9

[PrevPage]
0=Up

[NextPage]
0=Down

[PrevCandidate]
0=Shift+Tab

[NextCandidate]
0=Tab

검증 및 테스트

로그아웃/로그인 후 진단

$ fcitx5-diagnose | grep -A20 "환경 변수"

✅ 올바른 설정:

환경 변수 XMODIFIERS는 "@im=fcitx"입니다.

❌ 잘못된 설정 (수정 필요):

환경 변수 XMODIFIERS는 "@im=fcitx5"입니다.  # 틀림!
환경 변수 QT_IM_MODULE이(가) "fcitx"로 올바르게 지정되었습니다.  # 불필요!

fcitx5 상태 확인

$ fcitx5-remote -r # 재시작

$ fcitx5-remote # 상태 확인 (2 = 활성화)

2

앱별 테스트

앱	카테고리	입력 방식
Kate	KDE 네이티브	Wayland text-input
Firefox	GTK/Wayland	text-input-v3
Chromium	Qt/Wayland	text-input-v3
LibreOffice	GTK	text-input-v3
XWayland 앱	X11 호환	XMODIFIERS

테스트 방법

1. 각 앱 실행
2. 한영 전환 (Right Alt)
3. 한글 입력 테스트
4. 버벅거림 없이 부드러운 입력 확인

문제 해결

Q1: 일부 앱에서 한글 입력이 안 됨

원인: 오래된 Qt5 앱이 IM 모듈을 요구하는 경우

$ # 해당 앱만 IM 모듈로 실행

$ QT_IM_MODULE=fcitx 앱이름

Q2: 환경변수가 적용 안 됨

$ # 확인

$ env | grep -E "(XMODIFIERS|QT_IM|GTK_IM)"

$ systemctl --user show-environment | grep -E "(XMODIFIERS|QT_IM|GTK_IM)"

$ # 해결: systemd 환경 초기화

$ systemctl --user unset-environment XMODIFIERS GTK_IM_MODULE QT_IM_MODULE

# 재로그인

Q3: fcitx5가 자동 시작 안 됨

$ # 확인

$ cat ~/.config/kwinrc | grep InputMethod

$ # 수정

$ kwriteconfig6 --file kwinrc --group Wayland \

--key InputMethod "/usr/share/applications/org.fcitx.Fcitx5.desktop"

Q4: XMODIFIERS가 @im=fcitx5로 나옴

원인: 다른 스크립트나 설정이 재정의

$ # 검색

$ grep -r "XMODIFIERS.*fcitx5" ~/.bash* ~/.profile ~/.config 2>/dev/null

# 제거 후 재로그인

성능 비교

레거시 방식

IM Module

• 입력 지연 발생
• 버벅거림 빈번
• 프로토콜 미활용

→

Wayland 네이티브

text-input-v3

• 입력 지연 최소화
• 부드러운 입력
• KDE 최적화

레거시 방식 (IM 모듈)

GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx

문제점:

• IM 모듈 레이어를 거쳐 입력 지연 발생
• Wayland 네이티브 프로토콜 미활용
• 버벅거림 빈번

Wayland 네이티브 방식 (권장)

XMODIFIERS=@im=fcitx
# QT_IM_MODULE, GTK_IM_MODULE 미설정

장점:

• IM 모듈 우회, Wayland 컴포지터와 직접 통신
• text-input-v3 프로토콜 활용
• 입력 지연 최소화
• KDE Plasma 6 / Qt 6.8+ 최적화

⚡ 성능 개선 효과

~50ms

IM Module 지연

→

~10ms

Wayland Native

참고 자료

Fcitx5 Wayland Wiki Fcitx5 Setup Guide Fedora Fcitx5 Wiki Fcitx5 ArchWiki Fcitx5 GitHub Wayland Protocol KDE Wayland

작성일: 2025-12-29 | 버전: 1.0 | 라이선스: CC0 1.0 Universal

이 가이드는 실제 Fedora 43 KDE Plasma Wayland 환경에서 테스트되고 검증되었습니다.