Spicetify 업데이트: 버전, 복구, 호환성 확인

Spicetify 업데이트는 무엇을 의미하나요?

변경 유형을 먼저 구분하면 불필요한 재설치를 피할 수 있습니다.

Spotify가 업데이트되면 Spicetify가 수정한 애플리케이션 리소스가 교체될 수 있습니다. CLI와 설정은 남아 있지만 테마, 확장, Marketplace 항목만 사라질 수 있습니다. 이 경우에는 프로그램을 다시 다운로드하기보다 보통 spicetify backup apply를 실행합니다.

CLI 업데이트는 별도의 작업입니다. 설치된 CLI가 호환 릴리스보다 오래되었거나 공식 노트가 새 Spotify 구조에 필요한 새 매핑을 안내할 때 spicetify update를 사용합니다. 패키지 관리자로 설치했다면 같은 관리자로 업데이트하여 PATH에서 한 경로만 관리하게 하세요.

세 번째는 호환성 대기입니다. Spotify 버전이 최신 릴리스 노트의 범위를 넘었다면 apply를 반복해도 아직 공개되지 않은 지원이 생기지 않습니다. Spotify를 깨끗하게 유지하고 설정을 저장한 뒤 확인되지 않은 패치 대신 공식 릴리스를 기다리세요.

• Spotify만 바뀌었고 spicetify --version이 작동함: Spotify를 닫고 다시 적용합니다.
• CLI가 없거나 오래됨: 원래 설치 방법을 복구하거나 업데이트합니다.
• 클라이언트가 범위 밖임: 공식 호환 릴리스를 기다립니다.
• 한 테마나 확장만 실패함: 전체를 재설치하기 전에 해당 항목을 격리합니다.

Spotify를 바꾸기 전에 현재 릴리스를 확인하세요

버전과 호환성 판단에는 공식 릴리스 페이지를 기준으로 사용합니다.

공식 Spicetify CLI 릴리스 페이지에서 최신 제목, 날짜, 호환성 표, 인증 정보를 읽으세요. 이 글에서 확인한 페이지는 2026년 10월 26일의 v2.46.4를 가리킵니다. Windows와 Microsoft Store는 1.3.7까지, macOS는 1.3.7까지, Linux는 1.3.4까지로 표시됩니다. 이후 릴리스에서 범위가 바뀔 수 있으므로 이 표를 다시 확인 없이 복사하지 마세요.

설치된 Spotify 버전과 패키지 출처를 릴리스 노트와 비교하세요. Store, 데스크톱 설치 프로그램, Flatpak, AUR, 런처는 서로 다른 경로를 사용합니다. 경로 오류만으로 CLI가 오래되었다고 판단할 수 없습니다. 운영체제, 패키지 출처, 두 버전, 첫 번째 의미 있는 오류 줄을 기록한 뒤 변경하세요.

1. 1

   1. 활성 CLI 확인

   새 터미널을 열어 PATH에서 찾은 실행 파일을 확인하고 결과를 저장합니다.

   spicetify --version
2. 2

   2. Spotify 버전 확인

   정보 화면이나 패키지 관리자에서 버전과 설치 출처를 확인하고 공식 노트와 비교합니다.

3. 3

   3. 날짜 확인

   재배포 아카이브나 영상, 검색 요약이 아니라 공식 GitHub 릴리스를 사용합니다.

4. 4

   4. 한 경로 선택

   재적용, CLI 업데이트, 경로 수정, 호환성 대기 중 하나를 고르고 모든 명령을 무작정 실행하지 않습니다.

Spotify 업데이트 후 Spicetify를 다시 적용하세요

업데이트 후 테마가 사라졌다면 대부분 다시 적용하면 되며 다시 다운로드할 필요는 없습니다.

리소스를 수정하기 전에 트레이에 남은 프로세스까지 Spotify를 완전히 종료하세요. 일반 사용자 터미널에서 명령을 실행하고 끝날 때까지 기다립니다. backup 단계는 현재 클라이언트용 깨끗한 기준을 만들고 apply 단계는 호환 리소스에 설정을 적용합니다. 명령이 끝난 뒤 Spotify를 여세요.

Marketplace 항목을 모두 복구하기 전에 기본 클라이언트를 테스트하세요. 기본 모양에서 탐색, 검색, 라이브러리, 재생, 대기열을 확인합니다. 기능은 정상이고 모양만 단순하다면 핵심 복구가 성공한 것입니다. 테마와 확장은 한 번에 하나씩 추가하여 문제 원인을 남깁니다.

지원되지 않는 Spotify 버전이라는 메시지가 나오면 같은 명령을 계속 반복하지 마세요. 공식 범위와 비교하고 호환성 대기로 전환합니다. 백업이 손상되었다면 restore 후 새 백업을 만들고 깨진 기준 위에 패치를 쌓지 않습니다.

원래 설치 경로로 CLI를 업데이트하세요

Spicetify 실행 파일을 하나의 설치 채널로 관리하세요.

공식 스크립트로 Spicetify를 설치했고 내장 명령이 작동한다면 spicetify update가 적절할 수 있습니다. Winget, Scoop, Chocolatey, Homebrew, AUR, Nix 등으로 설치했다면 같은 관리자를 사용하세요. 설치 프로그램, 패키지 관리자, 수동 복사 파일을 섞으면 PATH에 중복 실행 파일이 생깁니다.

CLI를 바꾼 뒤에는 Spotify를 닫고 현재 클라이언트의 기준을 다시 만듭니다. 일반 backup apply로 복구되지 않을 때 restore, backup, apply 순서를 사용할 수 있지만 필요할 때만 실행하세요. 터미널 출력을 저장하면 PATH, 권한, 패키지, 호환성 중 어디서 막혔는지 알 수 있습니다.

Marketplace, 테마, 확장을 복구하세요

선택적 설정은 CLI와 Spotify가 안정된 뒤에 돌려놓습니다.

Marketplace는 작동하는 Spicetify 위에 추가되는 선택적 계층입니다. 다시 설치하기 전에 CLI를 적용하고 Spotify를 테스트하세요. 사이드바 항목이 사라진 원인은 교체된 리소스, 호환되지 않는 클라이언트, 한 확장의 오류일 수 있으며 모든 파일이 삭제되었다는 뜻은 아닙니다.

기본 클라이언트가 안정되면 공식 Marketplace 문서를 사용해 항목을 하나씩 추가합니다. 테마가 레이아웃을 망가뜨리면 알고 있는 테마로 돌아갑니다. 확장이 한 화면을 망가뜨리면 경로를 바꾸거나 CLI를 재설치하기 전에 확장을 비활성화합니다. 이름, 출처, 버전, 날짜를 기록하면 되돌리기 쉽습니다.

노래 추출, Premium 해제, 비공식 Spotify 패치 파일을 약속하는 패키지는 피하세요. 이는 Spicetify 사용자 설정의 범위를 벗어나 업데이트 진단을 어렵게 합니다. 공식 링크와 Marketplace 가이드부터 시작하세요.

1. 1

   1. 기본 클라이언트 확인

   기본 모양에서 재생, 검색, 라이브러리, 대기열을 테스트합니다.

2. 2

   2. 필요할 때만 Marketplace 복구

   apply가 성공한 뒤 공식 절차를 사용하고 전체 설치를 먼저 바꾸지 않습니다.

3. 3

   3. 커스터마이징 하나 추가

   테마, 확장, 앱, snippet 중 하나를 적용하고 영향을 받은 화면을 확인합니다.

4. 4

   4. 되돌릴 기록 남기기

   마지막으로 작동한 버전과 가장 최근에 추가한 항목을 적어 둡니다.

호환성을 읽고 기다릴 시점을 판단하세요

공식 호환 범위가 비어 있으면 다른 설치 프로그램을 강제할 때가 아니라 멈출 때입니다.

Spicetify 패치는 Spotify 데스크톱 클라이언트의 구조에 맞춰집니다. Spotify가 구조를 바꾸면 프로젝트가 호환 릴리스를 내놓을 때까지 시간이 필요합니다. 이 페이지에서 확인한 v2.46.4 노트는 Windows와 Microsoft Store 1.3.7, macOS 1.3.7, Linux 1.3.4까지를 표시합니다. 설치한 패키지가 다를 수 있으므로 현재 결정은 공식 페이지를 기준으로 하세요.

모든 오류를 호환성 문제로 분류하지 마세요. 명령을 찾지 못하면 PATH나 설치 문제이고 Spotify를 찾지 못하면 패키지 경로 문제이며 권한 거부는 열린 프로세스나 소유권 문제일 수 있습니다. 먼저 이것들을 확인한 뒤 범위 밖인지 판단합니다.

기다려야 한다면 Spotify를 깨끗하게 유지하고 설정을 보관하며 공식 릴리스 채널을 확인하세요. 무작정 다운그레이드하거나 임의의 CSS 매핑과 서명 없는 미러를 사용하지 않습니다. 호환 릴리스가 나오면 원래 채널로 CLI를 업데이트하고 복구 명령을 실행한 뒤 선택적 항목을 되돌립니다.

반복 가능한 Spicetify 업데이트 기록을 남기세요

짧은 기록이 있으면 다음 업데이트를 추측이 아니라 비교로 진행할 수 있습니다.

업데이트 전에 Spotify와 Spicetify 버전, 운영체제, 패키지 출처, 현재 테마, 중요한 확장을 적습니다. 실패하면 첫 번째 의미 있는 오류 줄을 저장하세요. Spotify 파일 교체, CLI 변경, 관리자 변경, 특정 커스터마이징 중 무엇이 원인이었는지 비교할 수 있습니다.

복구 후에는 기본 클라이언트를 먼저 테스트하고 선택적 항목을 조금씩 추가합니다. 공식 릴리스 URL과 확인 날짜도 보관하세요. 페이지가 바뀌면 새로운 노트를 기록과 비교하고 기억만으로 모든 명령을 반복하지 않습니다.

1. 1

   버전 기록

   Spotify, Spicetify, 운영체제, 패키지 출처를 저장합니다.

2. 2

   작동하는 기준 기록

   backup apply, Marketplace, 테마와 확장의 상태를 적습니다.

3. 3

   한 가지 변경 기록

   업데이트 뒤 한 계층만 바꾸고 터미널 출력을 보존합니다.

4. 4

   출처 기록

   사용한 공식 릴리스와 문서 페이지를 북마크합니다.

Spicetify 업데이트 자주 묻는 질문