DmNote-App/DmNote：随心定制

项目介绍

DmNote-App/DmNote 是一个托管在 GitHub 上的开源项目，主要使用 TypeScript 编写，采用 GNU General Public License v3.0 许可证，目前获得 4.2k 个 Star、247 次 Fork。

仓库全名: DmNote-App/DmNote

README 摘要

한국어 | English | 中文 DM Note Make it yours 나만의 스타일로 완성하는 키뷰어 개요 DM Note는 DJMAX RESPECT V에서 사용하기 위해 만들어진 키뷰어입니다. 다른 게임에서도 자유롭게 사용할 수 있고 설정이 간단해서 스트리밍이나 플레이 영상에 키 입력을 바로 띄울 수 있습니다. 지원 환경 · Windows 10/11 · macOS 리눅스 환경이라면 커뮤니티 포크 버전을 사용해 보시는 것을 추천합니다. DM NOTE v2.1.0 다운로드 Code signing policy 주요 기능 입력과 표시: 실시간 시각화 · 키 매핑 · 노트 효과 · 키 카운터 · KPS 통계와 그래프 · 키음 꾸미기: 그리드에서 키 편집 · 키마다 이미지 지정 · 사용자 정의 CSS · 플러그인 · 프리셋 오버레이: 항상 위에…

完整内容见 GitHub 原始 README 或本页。

常见问题

DmNote 用什么语言开发？

主要使用 TypeScript 编写，采用 GNU General Public License v3.0 许可证，目前有 4.2k 个 Star。

DmNote 可以免费商用吗？

仓库标注的许可证为 GNU General Public License v3.0，商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 DmNote 的源码？

可以直接克隆仓库：git clone https://github.com/DmNote-App/DmNote.git；安装与运行步骤见仓库 README。

DmNote 最近还在维护吗？

仓库最近一次更新为 2 天前，当前有 7 个未关闭 Issue；Star 数为 4.2k，可作为社区活跃度的参考。

关于

GitHub 原始描述（英文）

Make it yours. A customizable key viewer for DJMAX RESPECT V and any game.

djmax dmnote keyboard keyoverlay keyviewer kps obs overlay rhythm-game

GNU General Public License v3.0
4.2k Stars
247 Forks
90 Watching

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

4777

价值分

2598

活跃状态

活跃

GitHub

语言占比

CSS

HTML

JavaScript

Python

Rust

Shell

Swift

TypeScript

Release

贡献者

한국어 | English | 中文

DM Note

Make it yours

나만의 스타일로 완성하는 키뷰어

개요

DM Note는 DJMAX RESPECT V에서 사용하기 위해 만들어진 키뷰어입니다.

다른 게임에서도 자유롭게 사용할 수 있고 설정이 간단해서 스트리밍이나 플레이 영상에 키 입력을 바로 띄울 수 있습니다.

지원 환경 · Windows 10/11 · macOS 리눅스 환경이라면 커뮤니티 포크 버전을 사용해 보시는 것을 추천합니다.

DM NOTE v2.1.0 다운로드

Code signing policy

주요 기능

입력과 표시: 실시간 시각화 · 키 매핑 · 노트 효과 · 키 카운터 · KPS 통계와 그래프 · 키음

꾸미기: 그리드에서 키 편집 · 키마다 이미지 지정 · 사용자 정의 CSS · 플러그인 · 프리셋

오버레이: 항상 위에 표시 · 위치 고정 · 리사이즈 기준점 · OBS 브라우저 소스

그 밖에 다국어 5종, 단축키, 설정 초기화, 자동 업데이트를 지원합니다. 자세한 사용법은 문서를 확인해 주세요.

설치

위 다운로드 링크에서 최신 버전을 받아 압축을 풀고 실행하면 바로 사용할 수 있습니다.

macOS는 별도 권한 설정이 필요합니다. macOS 설치 및 권한 설정 가이드를 먼저 확인해 주세요.

설정은 %appdata%/com.dmnote.desktop 폴더에 저장됩니다.

스트리밍이나 플레이 영상 제작에 자유롭게 사용하셔도 됩니다.

사용 팁

Tip 提示

오버레이를 직접 볼 필요 없이 스트리밍이나 녹화에만 사용한다면 OBS 모드를 권장합니다.

일반 오버레이 모드보다 게임 프레임에 주는 부담이 적습니다.

게임용 컴퓨터와 스트리밍/녹화용 컴퓨터가 따로 있다면 게임용 컴퓨터에서 DM Note를 실행하고 스트리밍/녹화용 컴퓨터에서 OBS 브라우저 소스로 연결하는 방법을 추천합니다.

키뷰어 때문에 생기는 게임 프레임 저하를 거의 없앨 수 있습니다.

오버레이가 게임에 가려질 때

항상 위에 표시를 켜도 일부 게임은 전체화면에서 오버레이를 덮습니다. 이때는 테두리 없는 창 모드를 사용해 주세요.

플러그인과 CSS

Warning 警告

신뢰할 수 없는 플러그인은 절대 불러오지 마세요.

비공식 플러그인을 사용할 때는 ChatGPT 같은 도구로 안전한지 반드시 확인한 뒤 사용해 주세요.

사용자 정의 CSS로 프로그램 인터페이스와 오버레이 스타일을 원하는 대로 바꿀 수 있습니다.

공식 플러그인과 CSS 예제는 assets.zip에 들어 있습니다.

클래스명은 선택자 없이 이름만 입력해 주세요. (blue ✅, .blue ❌)

개발

기술 스택

프론트엔드: React 19 + TypeScript + Vite 7
백엔드: Tauri
스타일링: Tailwind CSS 3
입력 감지: Raw Input API (Windows), 전역 입력 이벤트 (macOS)
패키지 매니저: npm

설치와 실행

터미널에서 다음 명령어를 순서대로 입력해 주세요.

git clone https://github.com/DmNote-App/DmNote.git
cd DmNote
npm install
npm run tauri:dev

Windows ASIO 빌드

Windows에서는 npm run tauri:dev / npm run tauri:build에 키음 ASIO 출력이 기본으로 포함됩니다 (npm 스크립트가 asio-backend 피처를 활성화합니다).

ASIO 빌드에는 일반 종속성 외에 다음이 필요합니다.

LLVM/Clang: ASIO 헤더 바인딩 생성(bindgen)에 사용됩니다. LLVM을 설치하고(winget install LLVM.LLVM 또는 scoop install llvm) 환경 변수 LIBCLANG_PATH를 LLVM의 bin 폴더 경로로 설정해 주세요.
ASIO SDK: Steinberg ASIO SDK가 저장소에 포함되어 있어(src-tauri/vendor/asio-sdk) 자동으로 사용됩니다. 별도 설정이나 네트워크 연결은 필요 없고 다른 SDK를 사용하려면 CPAL_ASIO_DIR 환경 변수로 바꾸시면 됩니다.

ASIO 없이 빌드하려면(LLVM 불필요, 기여할 때 편합니다) npm run tauri:dev:no-asio / npm run tauri:build:no-asio를 사용해 주세요. src-tauri에서 직접 실행하는 cargo check / cargo build도 기본은 ASIO를 포함하지 않으며 ASIO 코드 경로까지 검사하려면 --features asio-backend를 붙여 주세요.

이 저장소는 Steinberg ASIO SDK를 듀얼 라이선스 중 GPLv3 옵션으로 사용합니다. 자세한 내용은 THIRD_PARTY_NOTICES.txt를 참고해 주세요. ASIO is a trademark of Steinberg Media Technologies GmbH, registered in Europe and other countries.