YAKC

두 가지 표시 스타일

• popups(기본): 누른 키와 클릭이 페이드 아웃되는 깔끔한 토큰 형태로 표시됩니다.
• keyboard: 실제 OS 레이아웃을 자동 감지해 해당 물리 키가 켜지는 화면상 가상 키보드를 보여주며, 설정에서 표시할 키만 골라 컴팩트하게 구성할 수 있습니다.

두 가지 팝업 모드

• text(기본): 텍스트 에디터처럼 동작해 입력한 문자만 나타나며 Backspace로 실제 삭제가 적용되고 단축키·이동 키는 숨겨집니다.
• raw: 조합 키(예: CTRL + ALT + H), ⌫, 화살표, F키 등 모든 키 입력을 그대로 보여줍니다.

마우스 입력 시각화

• 마우스 버튼 클릭(좌표 표시 옵션 포함)
• 마우스 이동(Wayland에서도 동작하는 dot-in-a-ring 형태의 위젯)
• 스크롤 휠 틱 표시

게임패드/컨트롤러 시각화

XInput, DualShock, DualSense 스타일 컨트롤러의 버튼을 토큰으로 표시하고 아날로그 스틱·트리거용 실시간 위젯을 함께 보여줍니다. Windows, macOS, Linux 모두에서 동작합니다.

OBS 브라우저 소스 연동

오버레이 전체를 http://localhost:<port>/overlay 형태의 투명 웹 페이지로 제공합니다. OBS의 Browser 소스에 추가하면 실시간으로 캡처되며, 자신의 화면에는 숨기고 OBS로만 송출하는 것도 가능합니다.

추가 편의 기능

• 계속 누르고 있는 키는 a (x13)처럼 카운터로 표시되어 팝업이 반복되지 않습니다.
• 팝업 크기·투명도·색상·폰트·모서리 둥글기 등 외형 세밀 조정
• 네 모서리 중 위치 선택 + 픽셀 오프셋, 멀티 모니터 지원, 드래그로 임의 위치 이동
• 부드러운 페이드 아웃 전환 효과
• 런타임 설정 GUI에서 모든 항목을 즉시 변경
• 전역 캡처 토글 단축키(기본 Ctrl+Alt+Y)
• 트레이 아이콘에서 캡처 토글·오버레이 이동·설정·종료
• 키 입력을 음성으로 읽어주는 TTS(텍스트 음성 변환)
• 특정 프로세스가 활성화되어 있을 때만 캡처하는 프로세스 필터

패키지 관리자로 설치

• Windows: winget install iammodev.YAKC
• Arch Linux(AUR): yay -S yakc

릴리스 페이지에서 직접 설치

• Windows: .msi 또는 -setup.exe 파일을 더블 클릭해 next-next-finish 방식으로 설치
• macOS(Intel + Apple Silicon): _universal.dmg 를 열고 YAKC를 Applications로 드래그
• Debian/Ubuntu: .deb 패키지 더블 클릭 또는 sudo apt install ./YAKC_*.deb
• Fedora/openSUSE: .rpm 패키지 더블 클릭 또는 sudo dnf install ./YAKC-*.rpm
• 기타 Linux 배포판: .AppImage 파일에 실행 권한을 부여한 뒤 실행

소스에서 빌드

Rust와 Tauri 시스템 의존성(예: Linux의 경우 webkit2gtk-4.1, libxkbcommon, TTS 사용 시 speech-dispatcher 헤더)이 준비된 환경에서 cargo tauri build 또는 cargo tauri dev 로 빌드합니다. Node.js나 npm 등 JavaScript 도구 체인은 필요하지 않습니다.

기본 사용 흐름

1. YAKC를 실행하면 트레이 아이콘이 나타나고, 키를 누르는 즉시 팝업이 표시됩니다.
2. 트레이 아이콘을 우클릭해 Toggle Capturing, Settings…, Quit 중 선택합니다.
3. 기본 Ctrl+Alt+Y 단축키로 어디서든 캡처를 켜고 끕니다.
4. Settings… 에서 외형, 위치, 모니터, 동작 등을 실시간으로 변경합니다.

YAKC는 어떤 운영체제에서 동작하나요?

Windows, macOS, Linux(X11 및 Wayland)를 모두 지원합니다. macOS는 Intel과 Apple Silicon을 모두 아우르는 유니버설 바이너리로, Windows와 Linux는 x64와 ARM64 빌드를 제공합니다.

Wayland에서도 키 입력 시각화가 가능한가요?

가능합니다. YAKC는 evdev로 입력을 읽고 컴포지터의 키맵을 그대로 사용하므로 GNOME(Mutter), KDE(KWin) 등 주요 Wayland 컴포지터에서 동작합니다.

OBS와 함께 스트리밍이나 화면 녹화에 사용할 수 있나요?

네, 두 가지 방식으로 사용할 수 있습니다. 기본 동작으로도 OBS 등 캡처 도구가 오버레이를 그대로 잡을 수 있고, 내장 브라우저 소스 기능을 켜서 OBS Browser 소스가 http://localhost:<port>/overlay 에 접속하도록 설정하면 투명한 라이브 피드를 받을 수 있습니다. 이때 자신의 화면에서는 오버레이를 숨기고 OBS로만 송출하는 것도 가능합니다.

키보드 언어와 레이아웃은 자동으로 인식되나요?

네, 운영체제(또는 Wayland의 경우 컴포지터)가 직접 문자를 변환해 주므로 QWERTY, QWERTZ, AZERTY, 터키어, 키릴 문자, 그리스어 등 별도의 설정 없이 그대로 표시됩니다.

화면으로 보는 주요 기능

YAKC 로고

검은색 배경에 흰색으로 'YAKC'라는 글자가 크게 표시된 로고입니다. 글자는 굵은 무襯线체로, 각 문자는 직사각형 형태의 테두리 안에 위치해 있습니다.