프로젝트 소개

DM Note는 DJMAX RESPECT V를 위해 만들어진 키뷰어로, 다른 게임에서도 설정이 간단해 스트리밍이나 플레이 영상에 키 입력을 바로 표시할 수 있습니다. Windows 10/11과 macOS를 지원하며, 리눅스에서는 커뮤니티 포크 버전 사용을 권장합니다. 주요 기능은 크게 입력/표시, 꾸미기, 오버레이로 나뉩니다. 입력과 표시 측면에서는 실시간 시각화, 키 매핑, 노트 효과, 키 카운터, KPS 통계와 그래프, 키음을 제공합니다. 꾸미기 측면에서는 그리드에서 키를 편집하고 키마다 이미지를 지정할 수 있으며, 사용자 정의 CSS, 플러그인, 프리셋을 지원합니다. 오버레이는 항상 위에 표시, 위치 고정, 리사이즈 기준점, OBS 브라우저 소스 기능을 갖추고 있습니다. 그 밖에 다국어 5종, 단축키, 설정 초기화, 자동 업데이트를 지원합니다. 설치는 릴리스에서 최신 버전을 내려받아 압축을 풀고 실행하면 됩니다. macOS는 별도 권한 설정이 필요해 설치 가이드를 먼저 확인해야 하며, 설정은 %appdata%/com.dmnote.desktop 폴더에 저장됩니다. 스트리밍이나 녹화에만 사용한다면 게임 프레임 부담이 적은 OBS 모드를 권장하고, 게임용과 방송용 컴퓨터가 분리된 환경에서는 OBS 브라우저 소스로 연결하는 방식을 제안합니다. 일부 게임이 전체화면에서 오버레이를 가릴 때는 테두리 없는 창 모드를 사용해야 합니다. 사용자 정의 CSS로 인터페이스와 오버레이 스타일을 바꿀 수 있고, 공식 플러그인과 CSS 예제는 assets.zip에 포함되어 있습니다. 신뢰할 수 없는 플러그인은 불러오지 말 것을 경고하고 있습니다. 기술 스택은 프론트엔드에 React 19, TypeScript, Vite 7, 스타일링에 Tailwind CSS 3, 백엔드에 Tauri를 사용하며, 입력 감지는 Windows에서 Raw Input API, macOS에서 전역 입력 이벤트를 사용합니다. 개발 환경은 git clone 후 npm install, npm run tauri:dev로 실행합니다. Windows에서는 키음 ASIO 출력이 기본 포함되며 LLVM/Clang과 ASIO SDK가 필요하고, ASIO 없이 빌드하려면 별도 npm 스크립트를 사용합니다. 라이선스는 GPL-3.0입니다.