Musebase for Windows

Windows 데스크톱에 실시간 이중언어 가사를.

구 LyricsX for Windows에서 이름을 바꿨습니다.

English · 한국어

Musebase는 재생 중인 곡의 가사를 자동으로 찾아 줄 단위(그리고 글자 단위)로 동기화하고, 원문과 번역을 함께 투명한 데스크톱 오버레이로 보여줍니다. macOS 앱 LyricsX의 Windows 네이티브 재작성판입니다.

기능

자동 재생 감지 — Windows SMTC 기반. Spotify, Apple Music, YouTube Music 등 미디어 키를 지원하는 모든 플레이어 대응. 자동 모드는 브라우저 세션을 제외하며, 특정 플레이어 고정도 가능.
다중 소스 가사 검색 — LRCLIB, NetEase, Kugou(酷狗), QQ Music(QQ音乐)을 통합 검색하고 품질 랭킹으로 최적 가사 자동 선택. 설정에서 소스별 켬/끔 가능.
글자 단위 노래방 — 인라인 타이밍이 있는 소스(Kugou/QQ/NetEase)는 글자 단위로 채움, 없으면 줄 단위 폴백.
이중언어 표시 — 원문과 번역을 2단으로. 가사 소스의 번역을 우선하고, 없으면 기계번역 — MyMemory(무료·키 불필요), DeepL, Google Cloud Translation, LibreTranslate(키/엔드포인트 입력형).
데스크톱 오버레이 — 투명·클릭스루·항상 위. 이동/크기 조절, 페이드 인/아웃, 배경 판(선택), 전체화면·일시정지·마우스오버 시 자동 숨김. 마우스를 올리면 재생 컨트롤(이전/재생·일시정지/다음) 표시.
편집·내보내기 — 현재 가사를 앱에서 무손실 수정, .lrc 내보내기, 틀린 가사 표시로 억제.
가사 캐시 — 한 번 찾은 가사(번역 포함)를 SQLite에 저장해 재재생 시 즉시·오프라인 표시.
다국어 UI — 19개 언어 — 시스템 언어를 따르며(영어 폴백) 설정에서 선택 가능. 번역 기여 »
개인정보 — DeepL API 키는 암호화(Windows DPAPI) 저장, UI에서 마스킹 표시.
자동 업데이트 — GitHub Releases 기반 Velopack 델타 업데이트.

다운로드 & 설치

Releases 에서 최신 빌드를 받으세요:

Musebase-win-Setup.exe — 자동 업데이트 포함 설치(권장)
Musebase-win-Portable.zip — 설치 없이 압축 해제 후 실행

아직 코드 서명을 하지 않아 첫 실행 시 Windows SmartScreen 경고가 뜰 수 있습니다 — 추가 정보 → 실행을 선택하세요.

LyricsX for Windows(≤ 0.9.x)에서 넘어오는 경우: 개명으로 자동 업데이트 연결이 끊겨 Musebase를 한 번 수동 설치해야 합니다. 설정·캐시·암호화된 API 키는 첫 실행 시 자동으로 이전됩니다.

요구 사항

Windows 10 버전 2004(20H1) 이상 또는 Windows 11
.NET 설치 불필요(빌드는 self-contained)

사용법

Musebase.exe 실행 → 트레이(숨김 아이콘 ^ 영역)에 녹색 M 아이콘 생성
음악 재생 → 화면 하단에 가사 자동 표시
트레이 아이콘 우클릭:
- 가사 검색… — 자동 매칭이 틀렸을 때 직접 검색·교체
- 현재 가사 편집… / 내보내기(.lrc)…
- 재생 소스 — 자동(브라우저 제외) 또는 특정 플레이어 고정
- 오버레이 위치 이동 모드 — 드래그로 이동 후 다시 해제
- 설정… — 표시 언어, 번역 엔진, 가사 소스, 오버레이 스타일
오버레이만 확인(재생 없이): Musebase.exe --demo

기계번역 (선택)

기본 상태에서는 대상 언어 번역이 없는 줄을 MyMemory(무료·키 불필요)로 자동 번역합니다. 더 높은 품질을 원하면 설정에서 엔진을 고르고 그 엔진의 키를 넣으세요(키 입력란은 선택한 엔진을 따라갑니다) — DeepL API 무료 키(월 50만 자) 또는 Google Cloud Translation(Google Cloud 콘솔에서 API 사용 설정 후 API 키 발급, 사용량 기반 유료). 선택한 엔진이 실패(할당량·네트워크)하면 무료 엔진으로 자동 전환하는 옵션도 있습니다. 번역은 줄 단위로 캐시됩니다(같은 곡은 1회만 번역). 키는 암호화되어 저장됩니다.

가사 서버 (선택)

여러 기기를 쓴다면 가사·번역 캐시를 서버 한 대에 모아 함께 쓸 수 있습니다. 한 기기가 찾아 둔 가사를 다른 기기가 그대로 받아 검색과 유료 번역을 반복하지 않습니다. 설정 [소스] 탭에 주소와 토큰을 넣으면 되고, 넣지 않으면 아무것도 달라지지 않습니다(서버가 꺼져 있어도 평소대로 동작).

→ 가사 서버 사용 가이드 · 설치·배포

UI 번역

인터페이스는 19개 언어로 제공됩니다(영어 + 한국어 손번역, 나머지는 DeepL 시드). 누구나 GitHub에서 바로 번역을 개선할 수 있습니다 — TRANSLATING.md (English) 참고.

빌드

dotnet build src/Musebase.Windows          # 개발 빌드
dotnet test  tests/Musebase.Core.Tests     # 유닛 테스트

릴리스(Velopack + GitHub Releases) 절차는 RELEASING.md 참고.

구조

src/Musebase.Core/     # UI 무관 도메인: LRC 파서, 제공자, 랭킹, 번역, 캐시
src/Musebase.Engine/   # UI 무관 오케스트레이션: 재생 계약, 코디네이터, 표시 상태
src/Musebase.Windows/  # WPF 앱: SMTC 감지, 동기화, 오버레이, 트레이, 설정, 다국어
contracts/             # 플랫폼 공유 직렬화 계약 (PlaybackViewState)
tools/                 # mt-bootstrap.ps1 (DeepL 번역 시드)
spikes/                # 기술 검증 스파이크 (SMTC/오버레이/검색)

라이선스

Musebase for Windows는 Mozilla Public License 2.0(MPL-2.0)로 배포됩니다.

ddddxxx의 LyricsX와 LyricsKit(둘 다 MPL-2.0)을 기반으로 합니다 — src/Musebase.Core의 가사 파싱·검색 로직은 LyricsKit에서 포팅했으며, 포팅된 파일은 MPL-2.0을 그대로 따릅니다(각 파일 헤더에 출처 표기).

FilesExpand file tree

README.ko.md

Latest commit

History