Spicetify 커스텀 앱 설치, 설정, 삭제

Spicetify 커스텀 앱이란?

기존 화면의 일부만 변경하는 대신 Spotify 탐색 영역에 독립적인 페이지를 추가합니다.

커스텀 앱은 사용자 지정된 Spotify 데스크톱 클라이언트 안에서 실행되는 JavaScript 앱입니다. 공식 문서에는 가사를 위한 앱, 팔로우한 아티스트와 팟캐스트의 신작을 위한 앱, 음악 관련 피드를 위한 커뮤니티 앱 예시가 있습니다.

테마는 색상과 외관을 바꾸고, 확장 기능은 기존 동작과 컨트롤을 바꾸며, snippet은 작은 CSS 변경을 적용합니다. 커스텀 앱은 더 큰 사이드바 경험을 추가하므로 각 유형을 분리하면 업데이트 후 원인을 찾기 쉽습니다.

Spicetify 커스텀 앱 설치 방법

Marketplace에 등록된 앱은 Marketplace를 사용하고, 수동 설치는 문서에 나온 CustomApps 폴더에 넣은 뒤 활성화합니다.

먼저 기본 CLI가 작동하는지 확인합니다. 새 터미널에서 `spicetify --version`을 실행하고 설정을 적용하기 전에 Spotify를 완전히 종료하세요. Marketplace는 필수가 아니며 수동으로 설치한 앱도 CLI로 활성화할 수 있습니다.

수동 설치에서는 공식 문서가 안내하는 `index.js`와 `manifest.json` 등의 파일을 유지해야 합니다. Windows 경로는 `%appdata%\spicetify\CustomApps\`, macOS와 Linux 경로는 `~/.config/spicetify/CustomApps/`입니다. 폴더 이름이 설정 값이 됩니다.

1. 1

   CLI와 Spotify 준비

   CLI 버전을 확인하고 Spotify를 한 번 실행한 뒤 변경 전에 종료합니다.

   spicetify --version
2. 2

   앱 폴더 설치 또는 복사

   사이드바의 Marketplace에서 선택하거나 index.js와 manifest.json이 있는 폴더를 올바른 위치에 둡니다.

3. 3

   폴더 이름 등록

   표시 제목이 아니라 실제 폴더 이름을 사용합니다. 이 예시는 lyrics-plus를 등록합니다.

   spicetify config custom_apps lyrics-plus
4. 4

   적용 후 재시작

   Spotify를 닫고 적용한 뒤 다시 열어 사이드바를 확인합니다.

   spicetify apply

공식 예시 설정 및 테스트

앱 하나부터 시작해 확인한 다음 다른 폴더를 추가하세요.

공식 문서의 예시는 `lyrics-plus`, `new-releases`, `reddit`입니다. 명령의 이름은 폴더 이름과 정확히 같아야 하며 적용할 때 Spotify를 종료해야 합니다.

여러 앱을 함께 설정할 수 있지만 목록이 작을수록 문제를 쉽게 찾을 수 있습니다. 변경할 때마다 사이드바 링크, 페이지 내용, 일반 재생을 확인하세요.

목록을 바꾼 뒤 `spicetify apply`를 실행하세요. 앱에 따라 Spotify 프로필 메뉴에 자체 설정이 있을 수 있지만, 옵션은 관리자가 정하므로 한 앱의 설정이 다른 앱에도 있다고 가정하면 안 됩니다.

Spicetify 커스텀 앱 삭제 방법

최근 추가했거나 문제가 있는 앱을 먼저 설정에서 제거한 뒤 폴더를 지울지 결정합니다.

공식 삭제 방식은 폴더 이름 앞에 마이너스를 붙이는 것입니다. 이렇게 하면 CLI를 삭제하지 않고 활성 `custom_apps` 목록에서 앱만 제외할 수 있습니다. Spotify를 닫고 적용한 뒤 재시작하여 링크가 사라졌는지 확인하세요.

설정에서 이름을 제거해도 로컬 파일이 자동으로 삭제되지는 않습니다. 다시 사용할 가능성이 있다면 폴더를 남겨 두고, 더 이상 설정이 필요 없다는 것을 확인한 뒤 삭제하세요.

1. 1

   폴더 이름 제거

   등록된 정확한 이름을 사용합니다. 이 예시는 lyrics-plus를 제거합니다.

   spicetify config custom_apps -lyrics-plus
2. 2

   줄어든 설정 적용

   Spotify를 닫고 적용한 후 다시 엽니다.

   spicetify apply
3. 3

   기본 상태 테스트

   사이드바, 검색, 재생, 남은 커스텀 기능을 확인합니다.

커스텀 앱이 없거나 빈 화면일 때

전체 CLI를 다시 설치하기 전에 증상을 설명할 수 있는 가장 작은 계층부터 확인합니다.

사이드바에 나타나지 않으면 CustomApps 경로, 정확한 폴더 이름, `manifest.json`을 확인합니다. `spicetify config custom_apps`로 활성 값을 확인한 다음 Spotify를 닫고 다시 적용하세요. 이후 클라이언트를 재시작합니다.

페이지는 보이지만 비어 있으면 전체 오류를 저장하고 `index.js`를 확인합니다. 문법 오류, 오래된 앱, Spotify 변경은 한 앱에만 영향을 줄 수 있으며 CLI 전체가 고장 났다는 뜻은 아닙니다. 오류를 확인할 때는 먼저 앱 하나만 남겨 재현 범위를 줄이고, Spotify를 종료한 뒤 `spicetify config custom_apps` 결과와 CustomApps 폴더 이름을 함께 기록하세요. 앱 저장소의 README와 최근 이슈에서 현재 Spotify 버전과 호환되는지 확인하되, 출처가 불분명한 설치 스크립트나 실행 파일을 바로 추가하지 마세요. 같은 문제가 반복되면 앱 폴더를 백업한 후 설정에서 해당 이름을 제거하고 `spicetify apply`를 실행해 기본 Spotify와 CLI가 정상인지 분리해서 테스트합니다.

Spotify 업데이트 후에는 먼저 update와 backup apply 안내를 따르세요. 공식 호환성 정보가 요구할 때만 깨끗한 백업을 다시 적용하거나 CLI를 업데이트하고, 이후 앱을 하나씩 추가합니다.

• 문서에 나온 CustomApps 경로 확인
• index.js와 manifest.json 확인
• 다른 설치 도구를 쓰기 전에 custom_apps 확인
• 마지막 앱부터 제거하고 테스트
• 전체 오류를 유지보수자에게 전달

Spicetify 커스텀 앱 자주 묻는 질문