-
-
Notifications
You must be signed in to change notification settings - Fork 12
Troubleshooting ko
ivLis edited this page Jan 22, 2026
·
1 revision
ivLyrics 사용 중 발생하는 일반적인 문제들의 해결 방법입니다.
설정이나 가사 표시에 문제가 있는 경우, 앱을 초기화해 보세요:
- 터미널에서
spicetify enable-devtools명령어를 실행합니다 - Spotify 창에서 우클릭 후 "Inspect Element" 또는 "개발자 도구"를 선택합니다
- Application 탭 > Storage > Clear site data를 클릭합니다
-
Ctrl+Shift+R(macOS:Cmd+Shift+R)을 눌러 Spotify를 새로고침합니다
증상: 어떤 노래에서도 가사가 나타나지 않음
해결 방법:
- 인터넷 연결 확인
- 설정에서 가사 제공자가 활성화되어 있는지 확인
- 다른 노래를 시도해 보세요 (일부 노래는 가사가 없을 수 있음)
- 설정 > 고급에서 가사 캐시 삭제
- 노래가 재생 중인지 확인 (가사는 재생 중인 트랙에만 표시됨)
증상: 번역 버튼이 작동하지 않거나 오류 표시
해결 방법:
- AI 제공자 설정에서 API 키가 올바르게 입력되었는지 확인
- API 키가 유효하고 만료되지 않았는지 확인
- AI 제공자가 활성화되어 있고 번역 기능이 활성화되어 있는지 확인
- API 할당량 확인 (무료 티어는 사용량 제한이 있음)
- 다른 AI 제공자를 시도해 보세요
증상: 예상과 다른 언어로 번역이 나타남
해결 방법:
- 설정 > 번역으로 이동
- 대상 언어가 올바르게 설정되어 있는지 확인
- 번역 캐시를 삭제하고 다시 시도
증상: 가사가 음악보다 빠르거나 늦음
해결 방법:
- 가사 위에 마우스를 올려 컨트롤 표시
- 싱크 오프셋 조정 사용
- 가능한 경우 커뮤니티 싱크 데이터 시도
- 수동으로 오프셋 조정 (늦은 가사는 +, 빠른 가사는 -)
증상: ivLyrics 설치 후 Spotify가 충돌하거나 열리지 않음
해결 방법:
- 터미널을 열고 다음 명령어를 실행합니다:
spicetify restore spicetify apply - 문제가 지속되면 재설치를 시도합니다:
spicetify config custom_apps ivLyrics- spicetify apply - 그 후 ivLyrics를 다시 설치합니다
증상: 전체 화면 모드가 작동하지 않거나 글리치 발생
해결 방법:
- 전체 화면 단축키를 다시 눌러보세요 (기본값
F12) - 단축키를 누르기 전에 먼저 Spotify 창을 클릭하세요
- 다른 확장 프로그램과 충돌하는지 확인하세요
- 설정에서 전체 화면을 비활성화했다가 다시 활성화하세요
증상: "API Error", "Rate Limited", "Quota Exceeded" 메시지
해결 방법:
| 오류 | 해결 방법 |
|---|---|
| Invalid API Key | API 키를 다시 입력하세요 |
| Rate Limited | 몇 분 기다렸다가 다시 시도하세요 |
| Quota Exceeded | 할당량이 리셋될 때까지 기다리거나 플랜 업그레이드 |
| Network Error | 인터넷 연결을 확인하세요 |
증상: Spotify가 느려지거나 메모리를 너무 많이 사용함
해결 방법:
- 설정 > 고급에서 모든 캐시 삭제
- 비디오 배경이 활성화되어 있다면 비활성화
- 애니메이션 효과 줄이기
- 주기적으로 Spotify 재시작
증상: 전체 화면에서 가사 없이 검은 화면만 표시됨
해결 방법:
- 콘텐츠가 로드될 때까지 몇 초 기다리세요
-
Esc를 눌러 종료하고 다시 시도하세요 - 브라우저 캐시 삭제 (위의 초기화 섹션 참조)
- 비디오 배경을 일시적으로 비활성화하세요
증상: F12 또는 기타 단축키가 반응하지 않음
해결 방법:
- 먼저 Spotify 창 안을 클릭하세요
- 다른 애플리케이션이 같은 단축키를 사용하고 있지 않은지 확인하세요
- 설정 > 키보드 단축키에서 단축키 설정 확인
- 다른 단축키로 변경해 보세요
위의 해결 방법으로 문제가 해결되지 않는 경우:
- 기존 이슈 확인: GitHub Issues
- Discord 참여: 커뮤니티 Discord
-
새 이슈 생성: 다음 정보를 포함해 주세요:
- ivLyrics 버전
- Spotify 버전
- 운영 체제
- 재현 단계
- 오류 메시지 (있는 경우)
디버그 정보를 수집하려면:
- 설정 > 고급에서 디버그 모드 활성화
- 문제를 재현
- 개발자 도구 열기 (
Ctrl+Shift+I또는 우클릭 > 검사) - Console 탭으로 이동
- 오류 메시지 복사