ivLyrics가이드Guide

ivLyrics 가이드ivLyrics guide

설치부터 처음 설정, 사용 팁과 문제 해결까지 한곳에 모았어요. 쓰는 기기를 골라 시작해 보세요.Installing, first-time setup, tips and fixes, all in one place. Pick your device to get started.

Desktop v6.6.24 Android v1.3.21 iOS v1.3.17 Overlay v1.2.11 Helper v0.2.1

GET STARTED

어떤 걸 설치하나요?What should I install?

ivLyrics는 Spotify 데스크톱 앱에서는 Spicetify 커스텀 앱으로, Android와 iOS에서는 독립 앱으로 동작해요. 모두 무료 오픈소스이고, 버전은 GitHub에서 바로 불러와요.On the Spotify desktop app, ivLyrics runs as a Spicetify custom app; on Android and iOS it's a standalone app. Everything is free and open source, and the versions below come straight from GitHub.

앱App방식How it runs필요한 것You need최신Latest
DesktopSpicetify 커스텀 앱Spicetify custom appSpotify 데스크톱 앱 · Windows, macOS, LinuxSpotify desktop app · Windows, macOS, Linuxv6.6.24
Android독립 앱 (APK) · Spotify용 LSPosed 모듈Standalone app (APK) · LSPosed module for SpotifyAndroid 기기 · Spotify 앱An Android device · the Spotify appv1.3.21
iOSAltStore로 설치하는 앱 (IPA)App installed with AltStore (IPA)iOS 17 이상 · AltServer를 켤 컴퓨터iOS 17+ · a computer to run AltServerv1.3.17
Overlay데스크톱 앱 (선택)Desktop app (optional)Windows · macOS (Apple Silicon)v1.2.11
Helper데스크톱 앱 (선택)Desktop app (optional)Windows · macOS (Apple Silicon)v0.2.1
비공식 오픈소스 프로젝트예요An unofficial open-source project

ivLyrics는 Spotify 및 그 계열사와 제휴하거나 승인받은 앱이 아니에요. 소프트웨어는 “있는 그대로” 제공되고, 가사·번역 같은 제3자 콘텐츠의 저작권과 각 플랫폼의 약관은 쓰는 사람이 직접 확인하고 지켜야 해요.ivLyrics is not affiliated with or endorsed by Spotify or its affiliates. The software is provided “as is”, and you are responsible for respecting the copyright of third-party content such as lyrics and translations, and each platform's terms.

DESKTOP

Desktop에 설치하기Install on desktop

Spotify 데스크톱 앱 위에서 Spicetify로 동작해요. 설치 스크립트가 최신 릴리스를 받아 SHA-256으로 확인한 뒤 설치하고, Spicetify가 없으면 함께 설치할지 물어봐요.ivLyrics runs on the Spotify desktop app through Spicetify. The install script downloads the latest release, checks its SHA-256 and installs it — and if Spicetify is missing, it offers to set that up too.

  • Spotify 데스크톱 앱 (spotify.com 버전)Spotify desktop app (from spotify.com)
  • Spicetify (없으면 같이 설치)Spicetify (installed for you if missing)
  • 인터넷 연결An internet connection
Microsoft Store 버전 Spotify는 안 돼요The Microsoft Store version of Spotify won't work

Spicetify는 스토어 버전의 파일을 고칠 수 없어요. 스토어 버전을 지우고 spotify.com에서 받은 설치 버전을 써 주세요. Spotify의 ‘정보’ 화면에서 어떤 버전인지 확인할 수 있어요.Spicetify can't patch the Store build. Remove it and install Spotify from spotify.com instead — Spotify's About screen shows which one you have.

  1. PowerShell을 열어요Open PowerShell

    시작 메뉴에서 PowerShell을 찾아 평소처럼 열어요. 관리자 권한으로 열면 Spicetify 설치가 꼬일 수 있어요.Find PowerShell in the Start menu and open it normally. Running it as administrator can break the Spicetify install.

  2. 설치 명령을 실행해요Run the installer

    iwr -useb https://raw.githubusercontent.com/ivLis-Studio/ivLyrics/main/updater/install.ps1 | iex

  3. Spicetify가 없다고 나오면If Spicetify is missing

    “Would you like to install Spicetify now?”에서 Enter를 눌러 같이 설치해요. Spicetify를 막 설치했다면 PowerShell을 닫았다가 다시 열고 2번 명령을 한 번 더 실행해 주세요.Press Enter at “Would you like to install Spicetify now?” to install it as well. Right after installing Spicetify, close PowerShell, open it again and run step 2 once more.

  4. Spotify에서 ivLyrics를 열어요Open ivLyrics in Spotify

    설치가 끝나면 Spotify 왼쪽 메뉴에 ivLyrics가 생겨요. 처음 열면 설정 도우미가 시작돼요 — 처음 설정을 참고하세요.When it finishes, ivLyrics appears in Spotify's left menu. Opening it the first time starts the setup wizard — see First-time setup.

업데이트는 앱 안에서Updates happen inside the app

자동 설치를 쓰면 업데이트 도우미(ivlyrics-updater://)가 함께 등록돼서, ivLyrics 안의 업데이트 버튼으로 새 버전을 설치할 수 있어요. 같은 설치 명령을 다시 실행해도 돼요.The installer also registers an update helper (ivlyrics-updater://), so the update button inside ivLyrics installs new versions. Running the same command again works too.

직접 설치하기 (수동)Manual install

스크립트를 쓸 수 없는 환경이라면 직접 설치할 수 있어요.If you can't use the script, you can install it by hand.

  1. 릴리스 받기Download the release

    GitHub 릴리스에서 ivLyrics.zip을 받아 압축을 풀고, 폴더 이름을 ivLyrics로 바꿔요.Get ivLyrics.zip from GitHub Releases, unzip it and rename the folder to ivLyrics.

  2. CustomApps 폴더에 넣기Copy it into CustomApps

    Windows: spicetify -c로 나오는 config-xpui.ini와 같은 폴더의 CustomApps · macOS / Linux: ~/.config/spicetify/CustomAppsWindows: the CustomApps folder next to the config-xpui.ini that spicetify -c prints · macOS / Linux: ~/.config/spicetify/CustomApps

  3. Spicetify에 등록하고 적용하기Register it and apply

    spicetify config custom_apps ivLyrics spicetify apply

ANDROID

Android에 설치하기Install on Android

Spotify에서 재생 중인 곡을 감지하고, ivLyrics 커뮤니티 싱크와 LRCLIB 가사로 노래방 스타일 가사를 보여줘요. 릴리스에는 APK가 두 개 있으니 쓰려는 쪽을 골라 받으세요.It detects what Spotify is playing and shows karaoke-style lyrics from ivLyrics community sync and LRCLIB. Each release ships two APKs — pick the one you want.

파일File용도What it is
ivLyrics-Android-…-release.apk따로 실행하는 ivLyrics 앱이에요. 대부분은 이걸 받으면 돼요.The standalone ivLyrics app. This is the one most people want.
ivLyrics-LSPatch-….apkSpotify 안의 가사 화면을 ivLyrics로 바꾸는 LSPosed 모듈이에요. 아래 안내를 보세요.An LSPosed module that replaces the lyrics inside Spotify with ivLyrics. See below.

  1. APK를 받아요Download the APK

    GitHub 릴리스에서 최신 APK를 받아요. Obtainium에 추가해 두면 새 버전을 알아서 확인하고 설치해 줘요.Get the latest APK from GitHub Releases. Add it to Obtainium and it checks for and installs new versions for you.

    최신 릴리스Latest release(새 창에서 열림)(opens in a new tab) Obtainium에 추가Add to Obtainium(새 창에서 열림)(opens in a new tab)

  2. 설치해요Install it

    받은 파일을 열어 설치해요. 보안 안내가 나오면 APK를 받은 브라우저나 파일 앱에만 ‘알 수 없는 앱 설치’를 허용해 주세요.Open the file to install it. If Android warns you, allow “Install unknown apps” for just the browser or file app you used.

  3. 권한과 Spotify API를 설정해요Grant access and add Spotify API details

    현재 곡을 알 수 있도록 알림 접근을 허용하고, 앱 안내에 따라 Spotify API 정보(Client ID, Client Secret)를 넣어요. 만드는 방법은 여기에 있어요.Allow notification access so it can see the current track, then enter your Spotify API details (Client ID and Client Secret) as the app guides you. Here's how to create them.

  4. (선택) 플로팅 아이콘(Optional) Floating icon

    ‘다른 앱 위에 표시’를 허용하면 Spotify 재생 화면에 ivLyrics로 바로 가는 아이콘이 떠요.Allow “Display over other apps” to get an icon on Spotify's player screen that jumps straight to ivLyrics.

공식 릴리스의 APK만 설치하세요Only install APKs from the official releases

ivLis-Studio GitHub 릴리스 말고 다른 곳에서 받은 APK는 설치하지 않는 걸 권해요. 업데이트할 때도 같은 곳에서 받은 APK를 기존 앱 위에 설치하세요.We recommend not installing APKs from anywhere other than the ivLis-Studio GitHub releases. When updating, install the new APK from the same place over the existing app.

Spotify 안에서 쓰기 (LSPosed 모듈)Inside Spotify (LSPosed module)

ivLyrics-LSPatch APK는 Spotify의 플레이어 가사 카드와 전체 가사 화면을 ivLyrics로 바꿔 줘요. 독립 앱과 같은 가사·번역 엔진을 쓰고, Spotify APK나 로그인 정보는 건드리지 않아요.The ivLyrics-LSPatch APK swaps Spotify's player lyrics card and full lyrics page for ivLyrics. It uses the same lyrics and translation engine as the app and doesn't touch the Spotify APK or your login.

  • 모듈을 설치하고 LSPosed에서 ivLyrics for Spotify를 켠 뒤, 적용 범위(scope)로 Spotify(com.spotify.music)를 골라요.Install the module, enable ivLyrics for Spotify in LSPosed and choose Spotify (com.spotify.music) as its scope.
  • 모듈을 업데이트할 땐 Spotify를 강제 종료한 다음 설치하고, Spotify를 다시 열어요.To update the module, force-stop Spotify first, install it, then reopen Spotify.
  • 지원하는 Spotify 버전은 9.1.80.2221과 9.1.42.2058이에요. 다른 버전에서는 아무것도 바꾸지 않아요.Supported Spotify versions are 9.1.80.2221 and 9.1.42.2058. Other versions are left untouched.
  • 9.1.80.2221에서는 전체 가사 화면 오른쪽 아래 마이크 버튼으로 Spotify의 보컬 줄이기(OFF → LOW → HIGH)도 쓸 수 있어요. 이 기능을 지원하는 곡에서만 나타나요.On 9.1.80.2221, a microphone button at the bottom right of the full lyrics page toggles Spotify's own vocal reduction (OFF → LOW → HIGH). It only appears on tracks that support it.
루팅된 기기의 LSPosed 기준이에요Tested with rooted LSPosed

LSPatch도 호환되지만 Spotify 앱을 패치해야 해요. 모듈 로더나 Android 버전에 따라 동작이 다를 수 있어요.LSPatch is a compatible path but requires patching the Spotify app. Behaviour can vary by module loader and Android version.

iOS

iOS에 설치하기Install on iOS

iOS 17 이상을 지원해요. GitHub의 IPA는 서명되지 않은 파일이라, AltStore 같은 도구로 내 Apple ID로 서명해서 설치해요.Requires iOS 17 or later. The IPA on GitHub is unsigned, so you install it with a tool like AltStore that signs it with your own Apple ID.

7일마다 갱신해야 해요It needs a refresh every 7 days

무료 Apple ID로 서명한 앱은 7일마다 AltServer로 갱신해야 계속 열려요.Apps signed with a free Apple ID have to be refreshed through AltServer every 7 days to keep opening.

  1. AltStore를 준비해요Set up AltStore

    컴퓨터에 AltServer를 설치하고, 공식 안내(macOS · Windows)에 따라 iPhone에 AltStore Classic을 설치해요.Install AltServer on your computer, then follow the official guide (macOS · Windows) to put AltStore Classic on your iPhone.

  2. iPhone과 컴퓨터를 연결해요Connect your iPhone

    iPhone과 AltServer를 켠 컴퓨터를 같은 Wi-Fi에 두거나 USB로 연결해요.Keep the iPhone on the same Wi-Fi as the computer running AltServer, or connect it by USB.

  3. ivLyrics 소스를 추가해요Add the ivLyrics source

    iPhone에서 아래 버튼을 누르거나, AltStore의 Sources 탭에서 + 를 눌러 이 주소를 넣어요.Tap the button below on your iPhone, or open Sources in AltStore, tap + and paste this URL.

    https://raw.githubusercontent.com/ivLis-Studio/ivLyrics-IOS/main/altstore-source.json
    AltStore에 추가Add to AltStore(새 창에서 열림)(opens in a new tab)

  4. ivLyrics를 설치해요Install ivLyrics

    추가한 소스에서 ivLyrics를 골라 설치하고, 처음 열 때 Spotify 계정 연결과 Spotify API 설정을 마쳐요.Pick ivLyrics from the source and install it. On first launch, connect your Spotify account and finish the Spotify API setup.

AltStore 설치 과정은 OS, Apple ID, 개발자 모드와 네트워크 환경에 따라 달라질 수 있어요. 막히면 AltStore 문제 해결 문서를 먼저 보고, 그래도 안 되면 나오는 오류 문구를 그대로 검색해 보세요. 무서명 IPA는 GitHub 릴리스에서도 받을 수 있고, 직접 빌드하려면 저장소를 클론해 Xcode에서 ivLyrics-IOS.xcodeproj를 열면 돼요.AltStore setup varies with your OS, Apple ID, developer mode and network. If you get stuck, check the AltStore troubleshooting guide first, then search for the exact error message. The unsigned IPA is also on GitHub Releases; to build it yourself, clone the repository and open ivLyrics-IOS.xcodeproj in Xcode.

SETUP

처음 설정하기First-time setup

Desktop

Spotify 왼쪽 메뉴에서 ivLyrics를 처음 열면 설정 도우미가 떠요. 언어, 가사 정렬과 배경, 번역 안내, 데스크톱 오버레이, 패널 가사, 가상 노래방을 차례로 고를 수 있고 나중에 언제든 바꿀 수 있어요.The first time you open ivLyrics from Spotify's left menu, a setup wizard walks you through language, lyric alignment and background, translation, the desktop overlay, panel lyrics and pseudo-karaoke. You can change everything later.

  • 번역은 키 없이 바로: 기본으로 Google·Bing 번역을 써요. 더 자연스러운 번역과 발음 표기가 필요하면 설정 → AI 제공자에서 Gemini, ChatGPT, Claude, DeepL 등을 추가하세요. Gemini API 키는 Google AI Studio에서 무료로 받을 수 있어요.Translation works without a key: Google and Bing Translate are used out of the box. For more natural translations and pronunciation, add Gemini, ChatGPT, Claude, DeepL and others under Settings → AI providers. You can get a Gemini API key for free from Google AI Studio.
  • 번역·발음 켜기: 곡을 틀고 가사 위에 마우스를 올리면 나오는 변환 버튼에서 켜요. 설정은 곡 언어마다 따로 저장돼요 — K-POP에서 켠 번역이 J-POP에는 적용되지 않아요.Turning on translation and pronunciation: play a song, hover over the lyrics and use the conversion button that appears. It's saved per song language — turning translation on for K-pop doesn't turn it on for J-pop.
  • 설정 열기: 가사 화면 오른쪽 아래 설정 버튼을 누르거나 S 키를 눌러요. 위쪽 검색창에 설정 이름을 치면 바로 찾아가요.Opening settings: use the settings button at the bottom right of the lyrics page, or press S. Type in the search box at the top to jump to any setting.
설정 탭Settings tab여기서 하는 일What's there
일반General언어, 데스크톱 오버레이, 기본 동작Language, desktop overlay, basic behaviour
외관Appearance배경, 글꼴, 모션, 레이아웃Background, typography, motion, layout
성능Performance프레임, 모션, GPU를 많이 쓰는 효과Frame rate, motion and GPU-heavy effects
동작Behaviour싱크, 번역, 가사 처리 흐름Sync, translation and lyric processing
가사 제공자Lyrics providers가사 제공자 우선순위와 연결Provider order and connections
AI 제공자AI providers번역·발음·리서치에 쓸 AI와 API 키The AI and API keys used for translation, pronunciation and research
전체화면 · 패널 가사Fullscreen · Panel lyrics전체 화면 레이아웃, ‘지금 재생 중’ 패널 가사의 배치와 크기Fullscreen layouts; placement and size of lyrics in the Now Playing panel
고급 · 디버그Advanced · Debug감지, 캐시, 헬퍼 연동 · 진단과 복구 도구Detection, cache, helper connection · diagnostics and recovery
정보About버전, 업데이트, 기여자, 패치 노트Version, updates, contributors, release notes

Android · iOS

  • Android: 알림 접근을 허용하고 Spotify API 정보를 넣은 뒤 Spotify에서 음악을 틀어요.Android: allow notification access, enter your Spotify API details, then play something in Spotify.
  • iOS: Spotify 계정을 연결하고 Spotify API 정보를 넣은 뒤 Spotify에서 음악을 틀어요.iOS: connect your Spotify account, enter your Spotify API details, then play something in Spotify.

Spotify API 정보 만들기 (모바일)Creating Spotify API details (mobile)

  1. 대시보드에서 앱 만들기Create an app on the dashboard

    Spotify for Developers 대시보드에 로그인해 Create app을 눌러요.Sign in to the Spotify for Developers dashboard and choose Create app.

  2. Web API 선택Select Web API

    사용할 API로 Web API를 꼭 선택해요. Redirect URI 같은 나머지 값은 ivLyrics 앱 안내를 따르세요.Make sure Web API is selected. For the other fields, such as the redirect URI, follow what the ivLyrics app tells you.

  3. Client ID·Secret 붙여 넣기Paste the Client ID and secret

    앱의 Settings에서 Client ID와 Client Secret을 복사해 ivLyrics 설정에 넣고 저장해요.Copy the Client ID and Client Secret from the app's Settings into ivLyrics and save.

API 키와 Client Secret은 비밀번호처럼Treat API keys and client secrets like passwords

스크린샷, GitHub 이슈, 디스코드 메시지에 올리지 마세요. 실수로 공개했다면 대시보드에서 새로 발급받으세요.Never post them in screenshots, GitHub issues or Discord messages. If one leaks, rotate it on the dashboard.

TIPS

알아두면 좋은 기능Good to know

공통All platforms

번역·발음은 곡 언어마다Per-language translation

일본어 곡은 번역과 발음, 영어 곡은 번역만 — 이런 식으로 언어마다 따로 저장돼요. 감지된 언어가 틀리면 가사 설정에서 곡 언어를 직접 고르고, 일본어 곡엔 후리가나도 켤 수 있어요.Translation and pronunciation are saved per language — say, both for Japanese songs and translation only for English ones. If the detected language is wrong, set it in the lyric settings. Japanese songs can show furigana too.

Desktop

표시 방식 고르기Pick a sync style

가사 화면에서 글자 단위, 단어 단위, 동기화, 일반가사를 바로 바꿀 수 있어요. 자주 쓰는 방식은 우클릭해서 고정해요.Switch between letter, word, line-synced and plain lyrics right on the lyrics page. Right-click a style to lock it.

공통All platforms

싱크가 밀리면 오프셋Fix timing with the offset

가사가 조금 빠르거나 느리면 가사 설정에서 오프셋을 맞춰요(모바일은 10·50·100ms 단위). 데스크톱은 다른 사람들이 맞춘 커뮤니티 싱크 오프셋을 받아 쓰고 공유할 수도 있어요.If lyrics run early or late, adjust the offset in the lyric settings (in 10, 50 or 100 ms steps on mobile). On desktop you can also use and share community sync offsets.

Desktop

싱크 제작기Sync creator

가사 타이밍을 직접 찍어 커뮤니티에 올릴 수 있어요. 여러 보컬 파트와 글자 구간별 보컬 스타일을 지원하고, 기여한 만큼 포인트가 쌓여요.Tap out lyric timings yourself and share them. Multiple vocal parts and per-span vocal styles are supported, and your contributions earn points.

Desktop

전체 화면 · LP · TV 모드Fullscreen, LP and TV modes

일반, 전체 LP, 컴팩트 LP, 비디오 스테이지 같은 화면 구성을 골라요. 배경은 앨범 색, 블러, 단색, 유튜브 뮤직비디오 중에서 고를 수 있어요.Choose a presentation such as standard, full LP, compact LP or video stage, with album-colour, blurred, solid or YouTube music-video backgrounds.

Desktop

패널 가사Panel lyrics

Spotify 오른쪽 ‘지금 재생 중’ 패널에 현재 가사를 띄워요. 전체 화면을 열지 않아도 가사를 볼 수 있고, 줄 수와 크기를 바꿀 수 있어요.Shows the current lines in Spotify's Now Playing panel, so you can follow along without going fullscreen. Line count and size are adjustable.

Desktop

리서치 · 학습 모드 · 가사 이미지Research, learning mode, lyric images

AI 리서치로 곡과 아티스트 이야기를 읽고(앨범 아트를 우클릭하거나 길게 누르기), 학습 모드에서 가사 속 단어를 퀴즈와 단어장으로 익혀요. 좋아하는 가사는 이미지로 만들어 공유해요 — 개인적인 용도로만 써 주세요.Read AI research about the song and artist (right-click or long-press the album art), learn a lyric's words with quizzes and a word list, and turn favourite lines into a shareable image — for personal use only.

모바일Mobile

가사 화면 조작Getting around the lyrics page

제목·아티스트를 한 번 누르면 Spotify로, 길게 누르면 가사 설정 메뉴가 열려요. 가사를 누르면 그 위치로 가고, 재생바를 끌어 원하는 구간으로 이동해요.Tap the title or artist to open Spotify, long-press it for the lyric settings menu. Tap a line to jump there, or drag the progress bar.

단축키 (Desktop)Keyboard shortcuts (desktop)

키Key동작Action
S가사 설정 열기Open lyric settings
설정에서 지정Set in Settings전체 화면 켜고 끄기 · 전체 화면에서 TV 모드 전환Toggle fullscreen · switch to TV mode while in fullscreen
1–9전체 화면에서 화면 구성 빠르게 바꾸기Switch presentation quickly in fullscreen
↑ ↓싱크 제작기에서 가사 줄 이동Move between lines in the sync creator

COMPANION APPS

함께 쓰면 좋은 앱Companion apps

둘 다 선택 사항이에요. 필요할 때만 설치하세요.Both are optional — install them only if you need them.

데스크톱 오버레이Desktop overlay v1.2.11

다른 프로그램을 쓰는 동안에도 가사와 번역을 화면 위에 띄워 두는 앱이에요. Windows와 macOS(Apple Silicon)를 지원해요.Keeps lyrics and translations floating above whatever you're doing. Available for Windows and macOS (Apple Silicon).

  1. 설치 파일 받기Download it

    릴리스에서 Windows는 …_x64-setup.exe(또는 MSI), macOS는 …_aarch64.dmg를 받아 설치해요.From the releases, get …_x64-setup.exe (or the MSI) on Windows, or …_aarch64.dmg on macOS.

  2. ivLyrics에서 켜기Turn it on in ivLyrics

    오버레이 앱을 실행한 뒤 ivLyrics 설정 → 일반에서 데스크톱 오버레이를 켜요. 연결 포트는 기본값 그대로 두면 되고, 바꿨다면 두 앱을 같은 값으로 맞춰 주세요.Start the overlay app, then enable the desktop overlay under ivLyrics Settings → General. Leave the port at its default — if you change it, use the same value in both apps.

macOS에서 ‘손상된 앱’이라고 나오면If macOS says the app is damaged

앱을 응용 프로그램 폴더로 옮긴 뒤 터미널에서 아래 명령을 실행하고 다시 열어요.Move the app to Applications, run this in Terminal and open it again.

xattr -cr /Applications/lyrics-plus-overlay.app

ivLyrics Helper v0.2.1

유튜브가 로그인 없는 재생을 막아서 영상 배경이 안 나올 때 쓰는 도우미예요. 영상을 로컬에서 받아(yt-dlp) 재생하고, 최대 화질(최고·2160p·1440p·1080p·720p·480p)을 고를 수 있어요.For when YouTube blocks signed-out playback and video backgrounds won't load. It fetches the video locally (with yt-dlp) and lets you cap the quality (best, 2160p, 1440p, 1080p, 720p or 480p).

  1. 설치하고 실행하기Install and run it

    릴리스에서 Windows 설치 파일이나 macOS DMG를 받아 설치하고 실행해요.Get the Windows installer or the macOS DMG from the releases, install it and run it.

  2. ivLyrics에서 켜기Turn it on in ivLyrics

    설정 → 고급에서 ‘헬퍼 프로그램 사용’을 켜요. 설정 도우미의 동영상 배경 테스트로 잘 되는지 확인할 수도 있어요.Enable “Use helper program” under Settings → Advanced. The setup wizard's video background test can confirm it works.

MAINTENANCE

업데이트와 삭제Updating and uninstalling

업데이트Updating

  • Desktop: ivLyrics 설정 → 정보의 업데이트 버튼을 눌러요. 설치할 때 쓴 명령을 다시 실행해도 최신 버전으로 바뀌어요.Desktop: use the update button in ivLyrics Settings → About, or run the install command again.
  • Android: 새 APK를 기존 앱 위에 설치해요(Obtainium을 쓰면 알아서). 모듈은 Spotify를 강제 종료한 뒤 업데이트해요.Android: install the new APK over the old one (Obtainium does it for you). For the module, force-stop Spotify first.
  • iOS: AltStore의 ivLyrics 소스에서 업데이트해요.iOS: update from the ivLyrics source in AltStore.

삭제Uninstalling

데스크톱 삭제 스크립트는 ivLyrics와 업데이트 도우미를 지우고, 마지막에 Spicetify까지 완전히 지울지 물어봐요(기본은 ‘아니요’).The desktop uninstaller removes ivLyrics and its update helper, then asks whether to remove Spicetify completely as well (the default is no).

iwr -useb https://raw.githubusercontent.com/ivLis-Studio/ivLyrics/main/updater/uninstall.ps1 | iex

모바일은 다른 앱처럼 지우면 돼요. LSPosed 모듈은 LSPosed에서 먼저 끈 뒤 삭제하세요.On mobile, remove it like any other app. For the LSPosed module, disable it in LSPosed before uninstalling.

TROUBLESHOOTING

문제가 생겼나요?Something not working?

Desktop

왼쪽 메뉴에 ivLyrics가 없어요ivLyrics isn't in the left menu

Spotify를 완전히 종료한 뒤 다시 열어 보세요. 그래도 없으면 설치 명령을 한 번 더 실행하고 출력된 오류를 확인해요. Microsoft Store 버전 Spotify라면 spotify.com 버전으로 바꿔야 해요.Fully quit Spotify and reopen it. If it's still missing, run the install command again and read its output for errors. If you have the Microsoft Store version of Spotify, switch to the one from spotify.com.

Spotify가 업데이트된 뒤 사라졌거나 화면이 깨져요It vanished or broke after a Spotify update

Spotify가 업데이트되면 Spicetify를 다시 적용해야 해요. 아래 명령을 실행한 뒤 ivLyrics 설치 명령을 한 번 더 실행해 주세요.After a Spotify update, Spicetify has to be applied again. Run this, then run the ivLyrics install command once more.

spicetify backup apply

그래도 Spotify가 실행되지 않으면 spicetify restore 후 spicetify apply를 실행해요. 막 나온 Spotify 버전은 Spicetify가 아직 지원하지 않을 수도 있으니 Spicetify 이슈도 확인해 보세요.If Spotify still won't start, run spicetify restore and then spicetify apply. A brand-new Spotify version may not be supported by Spicetify yet — check the Spicetify issues.

가사가 나오지 않아요No lyrics show up

인터넷 연결을 확인하고 다른 곡도 틀어 보세요. 설정 → 가사 제공자에서 제공자 순서와 연결 상태를 확인하고, 필요하면 곡마다 다른 제공자를 골라요.Check your connection and try another song. Under Settings → Lyrics providers, check the provider order and connection status — you can also pick a different provider for a specific track.

번역이나 발음이 안 나와요Translation or pronunciation doesn't appear

먼저 그 곡 언어에서 번역·발음을 켰는지 확인해요(언어마다 따로 저장돼요). AI 제공자를 쓴다면 설정 → AI 제공자의 API 키와 사용량 한도, 제공자 장애를 확인하고, 여러 제공자를 순서대로 등록해 두면 한 곳이 막혀도 다음으로 넘어가요.First check that it's turned on for that song's language (it's saved per language). If you use an AI provider, check its API key, usage limits and status under Settings → AI providers. Add several providers in order so the next one takes over if one fails.

영상 배경이 안 나오거나 로그인하라고 나와요Video backgrounds don't load or ask me to sign in

유튜브가 로그인 없는 재생을 막는 경우예요. ivLyrics Helper를 설치하고 설정 → 고급에서 켜 주세요.YouTube is blocking signed-out playback. Install ivLyrics Helper and enable it under Settings → Advanced.

설정을 처음 상태로 되돌리고 싶어요I want to reset all settings

  1. 개발자 도구 켜기Enable developer tools

    spicetify enable-devtools

  2. 사이트 데이터 지우기Clear site data

    Spotify 창을 우클릭해 ‘Inspect Element’(개발자 도구)를 열고, Application 탭 → Storage → Clear site data를 눌러요.Right-click the Spotify window, choose “Inspect Element”, then Application → Storage → Clear site data.

  3. 새로고침Reload

    Spotify 화면을 한 번 누르고 Ctrl+Shift+R(macOS는 Cmd+Shift+R)을 눌러요.Click into Spotify and press Ctrl+Shift+R (Cmd+Shift+R on macOS).

Android

재생 중인 곡을 못 찾아요It can't find the song that's playing

Spotify에서 음악이 실제로 재생 중인지, Android 설정에서 ivLyrics의 알림 접근이 켜져 있는지 확인해요. Spotify 알림이 보이지 않으면 Spotify를 다시 열고 재생을 다시 시작해 보세요.Make sure music is actually playing in Spotify and that notification access is on for ivLyrics in Android settings. If Spotify shows no playback notification, reopen Spotify and start playback again.

가사나 앨범 이미지를 못 불러와요Lyrics or album art won't load

Spotify Client ID와 Client Secret이 맞는지, 대시보드에서 Web API를 선택했는지 확인하고 설정에서 다시 저장해 보세요. iOS도 똑같이 확인하면 돼요.Check that the Spotify Client ID and Client Secret are correct and that Web API is selected on the dashboard, then save them again in settings. The same applies on iOS.

다른 곡의 가사가 나와요It shows lyrics for a different song

제목·아티스트 영역을 길게 눌러 가사 설정 메뉴를 열고, LRCLIB 수동 검색으로 맞는 가사를 골라요. 필요하면 현재 곡의 캐시를 지운 뒤 다시 불러와요.Long-press the title and artist to open the lyric settings, run a manual LRCLIB search and pick the right lyrics. Clear the current track's cache and reload if needed.

플로팅 아이콘이 안 보여요The floating icon doesn't show

‘다른 앱 위에 표시’ 권한을 허용했는지 확인해요. 아이콘은 Spotify 재생 화면이 열려 있을 때만 나타나요.Check that “Display over other apps” is allowed. The icon only appears while Spotify's player screen is open.

Spotify 모듈이 동작하지 않아요The Spotify module doesn't do anything

Spotify 버전이 9.1.80.2221 또는 9.1.42.2058인지, LSPosed에서 모듈이 켜져 있고 범위에 Spotify가 선택됐는지 확인해요. 바꾼 뒤에는 Spotify를 강제 종료하고 다시 열어 주세요.Check that Spotify is version 9.1.80.2221 or 9.1.42.2058, and that the module is enabled in LSPosed with Spotify in its scope. Force-stop and reopen Spotify after any change.

iOS

‘Spotify에서 열기’가 안 돼요“Open in Spotify” doesn't work

Spotify 앱이 설치돼 있고 음악이 재생 중인지 확인해요. 곡 정보를 아직 못 불러왔다면 잠시 기다렸다가 다시 눌러 보세요.Make sure the Spotify app is installed and something is playing. If the track info hasn't loaded yet, wait a moment and try again.

AltStore에서 설치나 갱신이 안 돼요AltStore won't install or refresh

AltServer가 켜져 있는지, iPhone과 컴퓨터가 같은 Wi-Fi(또는 USB)로 연결됐는지 확인해요. 7일이 지나 만료됐다면 갱신부터 해 주세요. 그래도 안 되면 AltStore 문제 해결 문서를 보거나 오류 문구를 그대로 검색해 보세요.Check that AltServer is running and that the iPhone and computer share the same Wi-Fi (or are connected by USB). If 7 days have passed, refresh first. Still stuck? See the AltStore troubleshooting guide or search for the exact error message.

그래도 해결되지 않나요?Still stuck?

쓰는 기기와 앱 버전, 오류 메시지를 함께 알려 주면 더 빨리 볼 수 있어요. API 키와 비밀값은 꼭 가려 주세요.Share your platform, app version and the error message so we can help faster. Always hide API keys and secrets.

Discord(새 창에서 열림)(opens in a new tab) GitHub Issues(새 창에서 열림)(opens in a new tab)