설치 후 Spicetify 사용법

설치 후 Spicetify가 하는 일

설치는 CLI를 시스템에 배치하는 과정이고, 사용은 한 번에 여는 작업이 아니라 몇 가지 확인을 순서대로 진행하는 과정입니다.

Spicetify는 Spotify 데스크톱 클라이언트의 설정을 읽고 복구에 필요한 원본 리소스를 깨끗한 백업으로 보관한 뒤, 선택한 테마·확장 기능·Custom App·snippet을 적용합니다. 보통 PowerShell, Terminal 또는 다른 셸에서 실행하며, 이후 Spotify를 열었을 때 보이는 화면과 동작을 바꿉니다.

이 구분을 알면 문제를 쉽게 나눌 수 있습니다. 매일 여는 프로그램은 Spotify이고, Spicetify는 지원되는 데스크톱 클라이언트를 준비하고 수정하는 CLI 계층입니다. Marketplace는 그 위에 추가하는 선택적 카탈로그이며 CLI의 대체품이나 별도의 음악 플레이어가 아닙니다.

• Spotify Web Player나 모바일 앱이 아닌 지원되는 데스크톱 클라이언트를 사용하세요.
• PATH에서 오래된 복사본이 선택되지 않도록 CLI 설치 경로를 하나로 유지하세요.
• 커뮤니티 커스터마이징을 추가하기 전에 기본 backup과 apply 흐름을 먼저 테스트하세요.

첫 번째 동작 확인하기

새 터미널을 사용하면 현재 PATH를 다시 읽고 어떤 설치본이 실제로 실행되는지 확인하기 쉽습니다.

Windows에서는 PowerShell을, macOS와 Linux에서는 Terminal을 여세요. 먼저 버전 명령어를 실행합니다. command-not-found 오류나 다른 패키지 관리자의 예상하지 못한 실행 파일이 아니라 명확한 Spicetify 버전 하나가 출력되어야 합니다. 결과가 예상과 다르면 적용하기 전에 중복 설치를 정리하세요.

spicetify config를 실행하면 Spotify와 환경 설정 파일을 찾은 경로도 볼 수 있습니다. 낯선 경로라는 이유만으로 바로 바꾸지 마세요. 지원되는 데스크톱 클라이언트인지, 한 번 실행했는지, apply 전에 완전히 종료했는지를 먼저 확인합니다.

1. 1

   새 터미널 열기

   새 PowerShell 또는 Terminal 세션을 시작해 현재 PATH를 불러옵니다.

2. 2

   활성 CLI 확인

   셸이 의도한 Spicetify 실행 파일 하나를 찾는지 확인합니다.

   spicetify --version
3. 3

   필요할 때만 경로 확인

   나중에 Spotify나 환경 설정을 찾지 못할 때 구성 정보를 확인합니다.

   spicetify config
4. 4

   Spotify 완전히 종료

   백업이나 적용 전에 데스크톱 클라이언트와 트레이 프로세스를 종료합니다.

백업을 만들고 첫 설정 적용하기

첫 적용이 성공하면 복구 가능한 기준점이 생기고 Spicetify가 지원되는 Spotify 파일에 접근할 수 있음을 확인할 수 있습니다.

CLI를 설치했다고 Spotify가 즉시 바뀌는 것은 아닙니다. Spotify를 종료한 상태에서 spicetify backup apply를 실행하세요. backup 단계는 restore에 필요한 깨끗한 리소스를 저장하고 apply 단계는 현재 설정을 기록합니다. 이 명령 후에도 Spotify가 기본 화면처럼 보일 수 있으며, 기본 확인에 테마나 확장 기능은 필요하지 않습니다.

명령어가 끝나면 Spotify를 다시 열고 복구 화면이나 빈 창 없이 정상적으로 시작되는지 확인하세요. 문제가 생기면 터미널 출력을 저장합니다. apply를 계속 반복하거나 폴더를 삭제하거나 CLI를 하나 더 설치하기보다, 처음 나타난 구체적인 오류 줄을 확인하는 편이 더 유용합니다.

1. 1

   버전 확인

   같은 터미널에서 spicetify --version을 실행하고 문제 해결을 위해 결과를 보관합니다.

2. 2

   백업과 적용 실행

   Spotify를 종료하고 깨끗한 기준을 만든 뒤 현재 설정을 적용합니다.

   spicetify backup apply
3. 3

   다시 열고 확인

   테마나 확장 기능을 추가하기 전에 Spotify를 실행하세요. 변경을 되돌려야 하면 spicetify restore를 사용하고 원인을 확인합니다.

Marketplace를 열고 커스터마이징 하나 추가하기

기본 CLI가 정상 작동한 뒤에는 Marketplace에서 테마, 확장 기능, Custom App과 snippet을 찾아볼 수 있습니다.

Spotify를 열고 데스크톱 클라이언트의 사이드바에서 Marketplace 항목을 찾으세요. 보이지 않으면 출처가 불명확한 패키지를 다운로드하지 말고 공식 Marketplace 설치 절차를 사용합니다. 사이드바가 없는 원인은 오래된 apply, 지원되지 않는 Spotify 패키지, 종료되지 않은 프로세스 또는 불완전한 Marketplace 계층일 수 있으므로 기본 CLI 테스트와 선택적 단계를 분리하세요.

첫 테스트에서는 작은 커스터마이징 하나를 선택하고 이름을 기록합니다. 적용한 뒤 필요한 경우 Spotify를 재시작하고 변경이 보이는지 확인하세요. 여러 항목을 한 번에 설치하면 빈 화면이나 깨진 레이아웃을 만든 테마·확장 기능·Custom App을 찾기 어렵습니다.

1. 1

   Marketplace 열기

   지원되는 Spotify 데스크톱 클라이언트 안의 Marketplace 항목을 사용합니다.

2. 2

   항목 하나 선택

   테마, 확장 기능 또는 Custom App 하나로 시작하고 출처와 호환성을 확인합니다.

3. 3

   설정 적용

   항목을 설정한 뒤 apply 명령어를 실행합니다.

   spicetify apply
4. 4

   더 추가하기 전에 테스트

   Spotify의 주요 화면을 열어 보고 마지막으로 정상 작동한 변경을 기록합니다.

테마, 확장 기능, Custom App 중 선택하기

각 용어는 서로 다른 종류의 변경을 뜻합니다. 차이를 알면 가장 작은 테스트와 적절한 복구 방법을 선택할 수 있습니다.

테마는 주로 외관을 바꾸고, 확장 기능은 기존 Spotify 화면의 기능이나 동작을 추가·변경하며, Custom App은 사이드바에 별도 페이지를 추가합니다. snippet은 작은 CSS 또는 구성 변경입니다. Marketplace에서 쉽게 찾을 수 있어도 커뮤니티가 유지하는 코드일 수 있으므로 활성화 전에 저장소, 업데이트 기록, 제거 방법을 확인하세요.

• 활성화한 항목과 출처 URL을 짧게 기록하세요.
• 중요한 변경은 한 번에 하나씩 적용하고 Spotify의 주요 화면을 테스트하세요.
• 변경으로 클라이언트가 깨지면 CLI 전체를 의심하기 전에 해당 항목을 비활성화하거나 제거하세요.

Spotify 업데이트 후 해야 할 일

Spotify 업데이트는 시스템에서 CLI를 제거하지 않고 Spicetify가 수정한 리소스만 교체할 수 있습니다.

Spotify 업데이트 직후 테마나 Marketplace 항목이 사라졌다면 먼저 Spicetify를 다시 다운로드하지 마세요. Spotify를 종료하고 CLI 버전을 확인한 다음 spicetify backup apply를 실행합니다. 설치된 CLI가 새 Spotify 빌드를 지원하면 깨끗한 기준을 새로 만들고 현재 설정을 다시 적용합니다.

명령어에서 호환성 문제가 나온다면 공식 릴리스 노트와 업데이트 가이드를 확인해 spicetify update, 원래 사용한 패키지 관리자 또는 호환 버전을 기다리는 방법을 선택하세요. 새로 바뀐 Spotify 클라이언트에 오래된 빌드를 강제로 적용하지 마세요.

기본 클라이언트는 열리지만 특정 커스터마이징 하나만 깨졌다면 해당 항목을 복구하거나 제거하고 커스터마이징 없이 Spotify를 테스트하세요. 업데이트 후 문제는 CLI 전체보다 선택적 테마나 확장 기능 때문인 경우가 많습니다.

1. 1

   Spotify 종료

   데스크톱 클라이언트를 닫고 프로세스가 끝날 때까지 기다립니다.

2. 2

   CLI 확인

   터미널이 사용하는 Spicetify 실행 파일과 버전을 확인합니다.

   spicetify --version
3. 3

   깨끗한 기준에서 다시 적용

   릴리스가 지원되는 경우 backup apply를 실행합니다.

   spicetify backup apply
4. 4

   선택적 항목 분리

   테마나 확장 기능 하나만 실패하면 비활성화하고 설치를 바꾸기 전에 기본 클라이언트를 테스트합니다.

설정이 정상 작동하는지 확인하는 방법

정상적인 설정은 보이는 테마만이 아니라 반복할 수 있는 절차입니다.

새 터미널에서 명확한 버전 하나를 확인하고, Spotify를 닫고, 경로 또는 권한 오류 없이 backup apply를 완료한 다음 데스크톱 클라이언트를 정상적으로 다시 열 수 있어야 합니다. 의도한 커스터마이징을 추가하기 전이라면 기본 Spotify와 비슷한 화면이어도 괜찮습니다.

설치 방법, 현재 버전, Spotify 패키지 출처, 마지막으로 정상 작동한 커스터마이징을 짧게 기록하세요. 그러면 다음 업데이트 때 어떤 명령어와 폴더를 사용했는지 추측하지 않고 통제된 확인을 할 수 있습니다.

• PATH에서 활성 CLI 하나가 검색됩니다.
• backup과 apply 후 Spotify 데스크톱이 열립니다.
• Marketplace는 기본 확인을 통과한 뒤에 추가합니다.
• 각 커스터마이징에 출처와 되돌릴 수 있는 제거 방법이 있습니다.
• 복구 순서가 분명합니다: 버전 확인, 지원되면 재적용, 선택적 항목 분리.

Spicetify 자주 묻는 질문