스포티파이에서 모든 곡에 한국어 번역을! Lyrics Plus Korean

 

 

Spotify(Spicetify) 가사 번역 확장 프로그램 : Lyrics Plus Korean

 

개요

Spotify의 가사 표시 기능을 확장하여 실시간 한국어 번역을 제공하는 Spicetify 확장앱을 개발했다. 기존 Lyrics Plus의 포크 버전으로, Google Gemini API를 통합하여 고품질 번역 기능을 구현했다.

 

기술 스택

• Base Framework: Spicetify CustomApps
• Translation API: Google Gemini API
• Frontend: JavaScript, CSS
• Target Platform: Spotify Desktop (Web Version)

 

주요 기능

1. AI 기반 실시간 번역

Google Gemini API를 활용하여 음악적 맥락을 고려한 번역을 제공한다. 단순 직역이 아닌 곡의 의미와 감정을 보존하는 번역 알고리즘을 적용했다.

 

2. 다중 표기법 지원

• 일본어 → 로마지 변환
• 한국어 → 로마자 표기
• 중국어 → 병음 변환
• 각 언어별 한국어 번역 동시 표시

 

3. UI/UX 최적화

• 투명 배경 처리로 Spicetify 테마와의 일관성 유지
• 마우스 호버 시에만 컨트롤 표시로 시각적 방해 최소화
• 가사 라인 전환 시 부드러운 애니메이션 효과 적용

 

4. 중복 처리 로직

원문과 번역이 동일한 경우 자동으로 번역 표시를 숨김 처리하여 불필요한 중복을 방지한다.

 

설치 방법

1. Spicetify 설치 (Microsoft Store 버전 Spotify는 지원하지 않음)
2. 프로젝트 저장소에서 소스코드 다운로드
3. lyrics-plus 폴더를 Spicetify CustomApps 디렉토리에 복사
4. 터미널에서 다음 명령 실행:

spicetify config custom_apps lyrics-plus
spicetify apply

 

기술적 구현 사항

번역 품질 향상을 위해 Gemini API 호출 시 음악 장르, 아티스트 정보 등의 컨텍스트를 함께 전달하여 보다 정확한 번역 결과를 도출하도록 구현했다. 또한 API 호출 최적화를 통해 실시간 재생에 영향을 주지 않도록 비동기 처리를 적용했다.

 

향후 개선 계획

• 다국어 번역 지원 확대
• 오프라인 캐싱 기능 추가
• 번역 품질 피드백 시스템 구현
• 성능 최적화 및 메모리 사용량 개선

 

소스코드

프로젝트는 오픈소스로 공개되어 있으며, 다음 저장소에서 확인 가능하다:
https://github.com/ivLis-Studio/lyrics-plus