Home

ivLyrics 안팎으로 살펴보기 🚀

ivLyrics 위키에 오신 것을 환영합니다. 이 문서는 ivLyrics 최신 버전(v5.2.2 기준)의 설치, 초기 설정, 주요 기능을 빠르게 이해할 수 있도록 정리되어 있습니다.

ivLyrics는 Spicetify용 가사 확장 프로그램입니다. 노래방 스타일 가사, 번역/발음 표기, 전체화면 가사, NowPlaying 패널 가사, 유튜브 배경 영상, 커뮤니티 싱크 데이터, 학습 모드, 애드온 기반 제공자 확장을 지원합니다.

AI 번역 및 발음 표기: Gemini, OpenAI ChatGPT, Claude, Groq, OpenRouter, Perplexity, Pollinations.ai 등 여러 AI 제공자를 설정하고 우선순위를 지정할 수 있습니다.
노래방/싱크/일반 가사 표시: Spotify와 LRCLIB 제공자를 기반으로 곡에 맞는 가사를 불러오며, 제공자별 허용 가사 유형을 조절할 수 있습니다.
가상 노래방(Virtual Karaoke): 줄 단위 싱크 가사만 있는 곡도 Spotify audio analysis를 기반으로 노래방 스타일 하이라이트를 합성합니다.
NowPlaying 패널 가사: Spotify 우측 "지금 재생 중" 패널에 현재 가사를 표시하고 폰트, 배경, 테두리를 조정할 수 있습니다.
전체화면 및 데스크탑 오버레이: 전체화면 가사 화면과 별도 오버레이 앱 연동을 지원합니다.
유튜브 비디오 배경: 곡에 맞는 영상을 배경으로 표시하고, 커뮤니티 비디오 선택기로 직접 추천/선택할 수 있습니다.
Sync Creator: 직접 노래방 싱크 데이터를 만들고 제출할 수 있으며, 라인 오프셋, LRCLIB 검색/ID 불러오기, AI 글자별 발음 생성, 여러 보컬 파트 작업을 지원합니다.
애드온 마켓플레이스: ivlyrics-addon GitHub 토픽 기반으로 서드파티 AI/가사/스타일 애드온을 찾아 설치할 수 있습니다.

Spicetify가 먼저 설치되어 있어야 합니다.

Spicetify 설치 직후라면 PowerShell(Windows) 또는 터미널(macOS/Linux)을 재시작한 후 진행하세요.

Windows (PowerShell)

iwr -useb https://ivlis.kr/ivLyrics/install.ps1 | iex

macOS / Linux (터미널)

curl -fsSL https://ivlis.kr/ivLyrics/install.sh | bash

업데이트도 같은 명령어로 진행할 수 있습니다. 자동 설치를 사용하면 ivlyrics-updater:// 업데이트 도우미가 함께 등록되어 앱 안의 업데이트 버튼에서도 최신 버전으로 갱신할 수 있습니다.

Windows

iwr -useb https://ivlis.kr/ivLyrics/uninstall.ps1 | iex

macOS / Linux

curl -fsSL https://ivlis.kr/ivLyrics/uninstall.sh | bash

Spotify를 실행하고 좌측 메뉴에서 ivLyrics를 선택합니다.
우측 하단의 설정 버튼을 엽니다.
설정 마법사 또는 AI 제공자 탭에서 사용할 AI 제공자를 활성화하고 API 키를 입력합니다.
- Gemini 키는 Google AI Studio에서 발급받을 수 있습니다.
- OpenAI, Claude, Groq, OpenRouter, Perplexity 등은 각 제공자의 API 키가 필요합니다.
가사 제공자 탭에서 Spotify/LRCLIB 제공자 우선순위와 허용 가사 유형을 확인합니다.
음악을 재생하고 가사 영역의 변환 버튼으로 원문, 발음, 번역, 모두 표시 모드를 전환합니다.

문제가 생기면 spicetify apply를 다시 실행하거나 Spotify를 새로고침하세요. 자세한 기능은 주요 기능(Features), 설정은 상세 설정(Settings)을 참고하면 됩니다.