ivLyricsGuide
ivLyrics/가이드

GETTING STARTED

ivLyrics 시작하기

사용할 기기를 선택하세요. Desktop, Android, iOS는 설치 방식과 필요한 권한이 서로 다릅니다.

▣
DesktopWindows · macOS · Linux
→ A
AndroidAPK · GitHub Releases
→ i
iOSiOS 17+ · AltStore
→
i
비공식 오픈소스 프로젝트

ivLyrics는 Spotify 및 그 계열사와 제휴하거나 승인을 받은 앱이 아닙니다. 사용자는 각 플랫폼 정책과 관련 법령을 확인하고 준수해야 합니다.

▣DESKTOP

Desktop 설치

Desktop 버전은 Spotify 데스크톱 앱과 Spicetify 위에서 동작하며 Windows, macOS, Linux를 지원합니다.

1Spotify 데스크톱 앱
2Spicetify CLI
3인터넷 연결
  1. 1

    PowerShell 열기

    시작 메뉴에서 PowerShell을 검색해 일반 권한으로 엽니다.

  2. 2

    Spicetify 설치

    아래 명령을 실행한 뒤 PowerShell을 닫았다가 다시 여세요.

    PowerShell
    iwr -useb https://raw.githubusercontent.com/spicetify/cli/main/install.ps1 | iex
  3. 3

    ivLyrics 설치

    새 PowerShell 창에서 설치 명령을 실행합니다. 같은 명령으로 나중에 업데이트할 수도 있습니다.

    PowerShell
    iwr -useb https://ivlis.kr/ivLyrics/install.ps1 | iex
✓
설치가 끝나면

Spotify를 열고 왼쪽 메뉴의 ivLyrics를 선택하세요. 보이지 않으면 Spotify를 완전히 종료한 뒤 다시 실행합니다.

AANDROID

Android 설치

Android 버전은 Spotify에서 재생 중인 곡을 감지하고 LRCLIB 및 ivLyrics 커뮤니티 데이터를 이용해 동기화 가사를 표시합니다.

  1. 1

    최신 APK 다운로드

    공식 GitHub Releases에서 최신 APK 파일을 받습니다.

    최신 Android 릴리스 ↗
  2. 2

    APK 설치

    다운로드한 파일을 열어 설치합니다. 보안 안내가 나오면 APK를 받은 브라우저나 파일 앱에 한해 ‘알 수 없는 앱 설치’를 허용하세요.

  3. 3

    권한과 초기 설정

    앱의 안내에 따라 알림 접근 권한을 허용하고 초기 설정을 완료합니다. Spotify 화면의 플로팅 아이콘을 사용하려면 ‘다른 앱 위에 표시’ 권한도 허용하세요.

!
APK 출처를 확인하세요

ivLis-Studio 공식 GitHub Releases 이외의 재배포 APK는 설치하지 않는 것을 권장합니다.

iiOS

iOS 설치

iOS 17 이상을 지원합니다. GitHub의 IPA는 무서명 파일이므로 AltStore 같은 도구에서 자신의 Apple ID로 서명해야 합니다.

!
7일마다 갱신이 필요할 수 있습니다

무료 Apple ID로 서명한 앱은 일반적으로 AltServer를 통해 7일마다 갱신해야 합니다.

  1. 1

    AltStore Classic 설치

    컴퓨터에 AltServer를 설치한 뒤 공식 안내에 따라 iPhone에 AltStore Classic을 설치합니다.

    AltStore ↗
  2. 2

    ivLyrics 소스 추가

    AltStore의 Sources 탭에서 + 버튼을 누르고 아래 URL을 추가합니다.

    AltStore Source
    https://raw.githubusercontent.com/ivLis-Studio/ivLyrics-IOS/main/altstore-source.json
  3. 3

    ivLyrics 설치

    추가된 소스에서 ivLyrics를 선택해 설치합니다. iPhone과 AltServer 컴퓨터는 같은 Wi-Fi에 연결하거나 USB로 연결하세요.

    IPA 릴리스 보기 ↗

SETUP

처음 실행한 뒤

플랫폼에 따라 필요한 연결과 권한을 설정하면 ivLyrics를 사용할 준비가 끝납니다.

Desktop

ivLyrics 설정 열기

Spotify 왼쪽 메뉴에서 ivLyrics를 열고 우측 하단 설정을 선택하세요. 번역 기능을 사용하려면 고급 설정에서 지원되는 AI API를 구성합니다.

Android

알림 접근 허용

현재 재생 중인 곡을 감지할 수 있도록 Android 설정에서 ivLyrics의 알림 접근을 허용하고, 앱 안내에 따라 Spotify API 정보를 설정합니다.

iOS

Spotify 연결

ivLyrics에서 Spotify 계정 연결과 Spotify API 설정을 완료한 뒤 Spotify에서 음악을 재생하세요.

i
API 비밀값은 공개하지 마세요

개인 API 키나 Client Secret을 스크린샷, 이슈, Discord 메시지에 올리지 마세요.

TIPS

알아두면 좋은 기능

01

번역·발음은 곡 언어별로

곡 언어에 따라 번역과 발음 표시 여부를 따로 저장할 수 있습니다. 일본어 곡에서는 후리가나도 사용할 수 있습니다.

02

가사를 눌러 이동

지원되는 가사에서는 원하는 줄을 누르면 해당 재생 위치로 이동합니다.

03

싱크가 밀리면 오프셋

가사 설정에서 오프셋을 미세 조정해 음악과 가사 타이밍을 맞추세요.

04

잘못된 가사는 다시 검색

모바일에서 다른 곡의 가사가 잡히면 제목 영역을 길게 눌러 LRCLIB 수동 검색을 실행하세요.

TROUBLESHOOTING

문제가 생겼나요?

Desktop에서 ivLyrics 메뉴가 보이지 않아요+

Spotify를 완전히 종료한 뒤 다시 실행하세요. 계속 보이지 않으면 설치 명령을 한 번 더 실행하고 출력된 오류를 확인합니다.

번역이 작동하지 않아요+

네트워크 연결과 설정에 입력한 API 정보를 확인하세요. API 사용량 제한이나 제공자 장애도 함께 확인합니다.

Android에서 현재 곡을 감지하지 못해요+

Spotify에서 실제로 음악이 재생 중인지 확인하고, Android 설정에서 ivLyrics의 알림 접근 권한이 켜져 있는지 확인하세요. Spotify 알림이 없다면 앱을 다시 열어 재생을 시작합니다.

iOS에서 Spotify 열기가 동작하지 않아요+

Spotify 앱 설치 여부와 음악 재생 상태를 확인하세요. 곡 정보가 아직 로드되지 않았다면 잠시 기다린 뒤 다시 시도합니다.

가사나 앨범 이미지가 나오지 않아요+

인터넷 연결과 Spotify API 설정을 확인하세요. 모바일에서는 현재 곡 캐시를 지운 뒤 다시 불러오는 것도 도움이 됩니다.

그래도 해결되지 않나요?

오류 메시지, 사용 플랫폼과 앱 버전을 함께 알려주면 더 빠르게 확인할 수 있습니다. API 키나 비밀값은 반드시 가려주세요.

GitHub Issues ↗Discord ↗

MAINTENANCE

업데이트와 삭제

Desktop 업데이트

설치할 때 사용한 명령을 다시 실행하면 최신 버전으로 업데이트됩니다.

Windows
iwr -useb https://ivlis.kr/ivLyrics/install.ps1 | iex
macOS / Linux
curl -fsSL https://ivlis.kr/ivLyrics/install.sh | sh

Desktop 삭제

사용 중인 운영체제의 명령을 실행하세요.

Windows
iwr -useb https://ivlis.kr/ivLyrics/uninstall.ps1 | iex
macOS / Linux
curl -fsSL https://ivlis.kr/ivLyrics/uninstall.sh | sh

모바일 업데이트·삭제

Android는 새 APK를 기존 앱 위에 설치해 업데이트하고, iOS는 AltStore 소스에서 업데이트합니다. 삭제는 각 운영체제의 일반적인 앱 삭제 방법을 사용하세요.