Spicetify Marketplace가 보이지 않으면 Spotify를 완전히 종료하고 spicetify --version을 실행하세요. CLI가 정상이라면 Marketplace를 재설치하기 전에 spicetify backup apply를 실행하고 Spotify를 다시 여세요. 이 순서가 깨끗한 Spotify 리소스를 복구하고 현재 설정을 다시 적용하는 기본 복구 방법입니다.
사이드바 항목이 계속 없으면 사용 중인 플랫폼의 공식 Marketplace 설치 방법을 사용하세요. 명령어를 찾지 못하거나 패널이 비어 있거나 Spotify 업데이트 직후 문제가 시작됐다면 각각 다른 해결책이 필요합니다.
먼저 Marketplace 증상을 구분하세요
Marketplace가 보이지 않는다는 말은 여러 문제를 뜻할 수 있습니다. 파일을 바꾸거나 재설치하기 전에 가장 가까운 행을 선택하세요.
| 보이는 상태 | 가능성 높은 원인 | 첫 조치 |
|---|---|---|
| 사이드바에 Marketplace 항목이 없음 | Marketplace가 설치되지 않았거나 마지막 apply가 복구하지 못함 | CLI를 확인한 뒤 backup apply 실행 |
| 항목은 열리지만 내용이 비어 있음 | Spotify 리소스가 오래됐거나 패널이 내용을 불러오지 못함 | Spotify 종료 후 재적용하고 공식 소스 확인 |
| Spotify 업데이트 후 항목이 사라짐 | 업데이트가 Spicetify가 수정한 리소스를 교체함 | 지원 버전 확인 후 재적용 |
| 테마나 확장 하나만 사라짐 | 개별 항목이 오래됐거나 비활성화됨 | Marketplace 전체가 아니라 해당 항목을 점검 |
CLI와 Spotify 데스크톱 클라이언트를 확인하세요
Marketplace는 정상 작동하는 Spicetify 설치 위에 올라갑니다. CLI가 없거나 Spotify 경로가 잘못된 상태에서는 Marketplace 재설치가 문제를 고치지 못합니다.
새 터미널을 열어 현재 PATH를 확인하고 spicetify --version을 실행하세요. Spicetify Marketplace는 Spotify Web Player나 모바일 앱을 대상으로 하지 않습니다.
Spotify 데스크톱을 한 번 열어 로그인한 뒤 변경 작업 전에 완전히 종료하세요. Spotify 프로세스가 남아 있으면 파일이 잠겨 apply가 성공한 것처럼 보여도 사이드바가 바뀌지 않을 수 있습니다.
처음부터 백신을 끄거나 모든 명령어를 관리자 권한으로 실행하지 마세요. 공식 소스, 실제 사용 중인 실행 파일과 예상한 데스크톱 설치를 먼저 확인하세요.
spicetify --version
- 1
새 터미널 열기
PowerShell 또는 설치에 사용한 셸에서 실제 PATH를 확인하세요.
- 2
데스크톱 클라이언트 확인
지원되는 Spotify 데스크톱 앱을 사용하고 Web Player나 모바일 앱은 사용하지 마세요.
- 3
Spotify 완전히 종료
앱을 종료하고 파일을 잡고 있는 Spotify 프로세스가 없는지 확인하세요.
재설치 전에 spicetify backup apply 실행
일반 업데이트나 불완전한 apply 후 사이드바가 사라졌다면 이 방법이 위험이 가장 낮은 다음 단계입니다.
spicetify backup apply는 호환되는 Spotify 데스크톱 리소스의 깨끗한 백업을 만들거나 갱신하고 현재 Spicetify 설정을 적용합니다. 다운로드 명령어가 아니며 Spotify 계정 데이터를 삭제하지 않습니다.
Spotify가 완전히 종료된 뒤 실행하세요. 명령어가 끝나면 Spotify를 다시 열고 테마, 확장 프로그램 또는 커스텀 앱을 재설치하기 전에 사이드바를 확인하세요.
지원되지 않는 Spotify 버전이라는 메시지가 나오면 같은 명령어를 반복하지 말고 공식 호환성 안내와 릴리스를 확인하세요.
spicetify backup apply
- 1
Spotify 종료
데스크톱 앱과 보조 프로세스를 모두 닫으세요.
- 2
깨끗한 apply 실행
중간에 Spotify를 다시 열지 말고 명령어가 끝날 때까지 기다리세요.
- 3
사이드바 테스트
다른 항목을 재설치하기 전에 Spotify를 열고 Marketplace를 확인하세요.
사이드바가 계속 없을 때만 Marketplace 재설치
CLI가 정상이고 Spotify가 지원되며 backup apply도 끝났는데 항목이 없을 때만 공식 프로젝트 소스에서 Marketplace 계층을 다시 설치하세요.
Windows에서는 공식 문서에 PowerShell 설치 명령어가 있습니다. macOS와 Linux에서는 해당 플랫폼의 공식 문서에서 명령어를 복사하세요. 미러, 단축 URL 또는 출처가 불명확한 스크립트는 사용하지 마세요.
설치가 끝나면 Spotify를 닫았다가 다시 열고 기본 카테고리 하나부터 확인하세요. 새 테마나 확장은 한 번에 하나씩 추가해야 문제가 생긴 항목을 추적할 수 있습니다.
설치 프로그램이 명령어를 찾지 못하거나 파일을 쓰지 못하면 멈추세요. PATH, 중복 CLI 설치, 권한 또는 지원되지 않는 Spotify 경로가 원인일 수 있습니다.
iwr -useb https://raw.githubusercontent.com/spicetify/marketplace/main/resources/install.ps1 | iex
- 공식 Spicetify Marketplace 저장소와 문서만 사용하세요.
- 사이드바가 복구됐는지 판단하기 전에 Spotify를 닫고 다시 여세요.
- Marketplace를 여러 개 설치하거나 알 수 없는 스크립트를 섞지 마세요.
- 한 항목만 사라졌다면 해당 테마, 확장 또는 앱을 별도로 점검하세요.
Spotify 업데이트 후 Marketplace 복구
Spotify 업데이트는 Spicetify가 수정한 데스크톱 리소스를 교체할 수 있습니다. CLI가 설치되어 있어도 Marketplace, 테마와 확장이 사라질 수 있습니다.
무작정 재설치하지 말고 버전 관계부터 확인하세요. Spicetify 버전, Spotify 데스크톱 버전과 공식 CLI 릴리스 노트를 비교하세요. 최신 Spotify 빌드가 아직 지원되지 않는다면 같은 Spicetify 버전을 다시 설치해도 호환성이 생기지 않습니다.
버전이 호환되면 Spotify를 종료하고 backup apply를 실행하세요. 이 페이지에서 확인한 안정 버전은 v2.44.0이며 beta를 기본 안정 다운로드로 취급하면 안 됩니다.
apply로 해결되지 않으면 터미널의 정확한 오류를 보존하고 설치 프로그램을 반복하는 대신 호환성 또는 오류 가이드를 사용하세요.
- 1
호환성 확인
Spotify 버전을 공식 Spicetify 호환성 및 릴리스 정보와 비교하세요.
- 2
기본 상태 재적용
Spotify를 완전히 종료한 뒤 backup apply를 한 번 실행하세요.
- 3
증거와 함께 확장
터미널 출력을 저장하고 오류에 맞는 안내를 선택하세요.
PATH, 권한, 빈 패널 오류를 구분하세요
오류의 형태가 다음 확인 단계를 알려 주는 경우가 많습니다. 여러 변수를 한꺼번에 바꾸지 마세요.
- 가능하면 현재 실행 파일에는 하나의 설치 방법만 유지하세요.
- Spotify를 실행하는 동일한 사용자 계정과 환경을 사용하세요.
- 지원 요청 전에 버전, 운영체제와 정확한 출력 내용을 기록하세요.
- Marketplace에 표시된다는 이유만으로 커뮤니티 항목을 공식 기능으로 간주하지 마세요.
| 메시지 또는 상태 | 다음 확인 | 피할 것 |
|---|---|---|
| spicetify를 찾을 수 없음 | 새 터미널에서 PATH와 중복 설치 확인 | 설치 프로그램을 반복 실행 |
| 재설치 후에도 Marketplace 없음 | backup apply와 Spotify 호환성 확인 | 타사 복사본 설치 |
| Marketplace 패널이 비어 있음 | Spotify 종료 후 재적용하고 공식 소스 테스트 | 패널 안정화 전에 확장 추가 |
| 일반 오류 메시지 | 전체 출력, 네트워크와 출처 확인 | 진단 없이 보안 도구 비활성화 |
| 테마나 확장 하나만 사라짐 | 해당 항목의 문제 해결 경로 확인 | 전체 Marketplace 문제로 간주 |
Windows, macOS, Linux 플랫폼 참고
데스크톱 플랫폼마다 진단 흐름은 비슷하지만 셸, Spotify 경로와 패키지 관리자가 달라질 수 있습니다.
| 플랫폼 | 확인할 내용 | 유용한 기준 |
|---|---|---|
| Windows | PowerShell PATH, 데스크톱 설치와 실제 실행 파일 | 재설치할 때 공식 PowerShell 설치 방법 사용 |
| macOS | 셸 PATH, Intel 또는 Apple Silicon과 앱 경로 | 셸과 아키텍처에 맞는 공식 안내 사용 |
| Linux | 패키지 관리자, 권한과 Spotify 패키지 경로 | 실행 파일을 확인하지 않고 수동 설치와 패키지 설치를 섞지 않기 |
| 모든 플랫폼 | Spotify 종료, 지원되는 CLI와 공식 소스 접근 | Web Player와 모바일은 대상이 아님 |
자주 묻는 질문: Spicetify Marketplace가 보이지 않음
Spotify에서 Spicetify Marketplace가 보이지 않는 이유는 무엇인가요?
불완전한 apply, Marketplace 계층 누락, Spotify 업데이트로 인한 리소스 교체, 비활성 PATH 또는 지원되지 않는 Spotify 버전이 흔한 원인입니다. Spotify를 종료하고 CLI를 확인한 뒤 backup apply를 실행하고 그 후에만 재설치를 고려하세요.
Spotify가 업데이트될 때마다 Marketplace를 재설치해야 하나요?
항상 그렇지는 않습니다. 먼저 호환성을 확인하고 Spotify를 종료한 뒤 spicetify backup apply를 실행하세요. CLI가 정상이고 사이드바가 계속 없을 때만 Marketplace를 재설치하세요.
재설치 후에도 Marketplace 버튼이 보이지 않으면 어떻게 하나요?
터미널이 사용하는 Spicetify 실행 파일을 확인하고 Spotify를 종료한 뒤 backup apply를 실행하세요. 설치 프로그램을 여러 번 실행하지 말고 공식 릴리스 안내와 터미널 출력을 보존하세요.
Marketplace 패널이 비어 있다는 것은 무슨 뜻인가요?
오래된 Spotify 리소스, 불완전한 apply, 네트워크 또는 호환되지 않는 클라이언트 때문일 수 있습니다. 한 번 재적용하고 공식 소스를 테스트한 뒤 네트워크와 버전을 분리해 확인하세요.
Spotify Web Player나 모바일에서도 Marketplace를 사용할 수 있나요?
아니요. Spicetify Marketplace는 지원되는 Spotify 데스크톱 리소스를 수정하며 Web Player와 모바일 앱은 대상이 아닙니다.
Marketplace 없이 테마나 확장을 사용할 수 있나요?
예. Marketplace는 선택 사항입니다. 파일과 설정이 올바르면 CLI로 수동 구성한 테마, 확장 프로그램과 커스텀 앱을 적용할 수 있습니다.
사용한 공식 소스
- 공식 Spicetify Marketplace 문서 — 설치, 사이드바, 관리와 문제 해결.
- Spicetify 공식 시작하기 문서 — 지원되는 데스크톱 설정과 CLI 및 Spotify 관계.
- 공식 Marketplace 저장소 — Marketplace 계층의 소스와 릴리스 정보.
- 공식 CLI 릴리스 — 호환성과 릴리스 노트; 안정 버전 v2.44.0을 2026년 8월 11일 확인했습니다.