最初に spicetify --version を実行します。PowerShellにバージョンが表示されればCLIはPATHから利用できます。認識されない場合は、applyやrestoreの前にインストールまたはPATHを修正します。
設定確認は spicetify config、通常の変更は spicetify apply、初回導入やSpotifyのリソース更新後は spicetify backup apply、保存済みのクリーンなリソースへ戻す場合は spicetify restore を使います。ファイルを変更する前にSpotifyを終了してください。
目的別Spicetify コマンド早見表
必要な結果からコマンドを選びます。ただし、出力、実行中のバージョン、Spotifyの配布形式、復旧手順も必ず確認してください。
| 目的 | PowerShell コマンド | 動作 | 注意点 |
|---|---|---|---|
| CLI確認 | spicetify --version | 実行中のバージョンを表示 | PowerShellが見つけた実体を確認 |
| 設定確認 | spicetify config | 設定とパスを表示 | パス変更前に確認 |
| 設定を適用 | spicetify apply | テーマや拡張機能を適用 | Spotifyを終了 |
| バックアップして適用 | spicetify backup apply | 対応リソースを保存して適用 | 初回やリソース更新後に使用 |
| 復元 | spicetify restore | 保存済みのクリーンな状態へ戻す | CLI自体は削除しない |
| 更新 | spicetify update | 対応する導入方式を更新 | 元の導入方式を確認 |
| ヘルプ | spicetify --help | 現行版のコマンドとオプションを表示 | 古い一覧より優先 |
CLIコマンドはPowerShell、コマンドプロンプト、macOS/Linuxのターミナルでほぼ同じです。導入方法、パス、権限、パッケージ管理方法は異なります。
PowerShellを安全に開いてSpicetifyを確認する
通常のユーザー権限でPowerShellを開きます。管理者実行を標準にすると、Spotify、Spicetify、通常のデスクトップセッションの間で所有権やアクセス権がずれることがあります。
復旧作業の前に spicetify --version を実行します。コマンドが認識されない場合、第三者の実行ファイルを入れたりPATHを推測で変更したりせず、PowerShellを開き直して公式の導入手順を確認します。
重複した導入が疑われる場合は Get-Command spicetify を使います。PATHの前方に古い実行ファイルがあると、更新後も別のバージョンが動くことがあります。
- 1
バージョンを確認
CLIが見つかることと完全なバージョンを確認します。
spicetify --version - 2
実行ファイルを確認
重複または古い導入がある場合にパスを調べます。
Get-Command spicetify - 3
組み込みヘルプを読む
インストール済みバージョンのコマンドとオプションを確認します。
spicetify --help
Spicetify 設定コマンドとパスを確認する
引数なしの spicetify config で現在の設定を表示できます。Spotifyのパス、テーマ、配色、拡張機能、カスタムアプリ、動作オプションが含まれます。
基本形は spicetify config キー 値 です。テーマでは current_theme や color_scheme を設定してから spicetify apply を実行します。一度に一項目だけ変更すると原因を追いやすくなります。
prefs_path と spotify_path は対応するデスクトップ版Spotifyを指す必要があります。Webプレーヤー、任意のキャッシュ、未確認のパッケージフォルダーは指定しないでください。
spicetify config
変更の適用、バックアップ、復元
動作中の環境で通常の変更を反映する場合は spicetify apply、クリーンな基準がない場合やSpotifyがリソースを置換した場合は spicetify backup apply、保存状態へ戻す場合は spicetify restore を使います。
apply、backup、restoreの前にSpotifyを完全終了します。同じコマンドを繰り返すのではなく、最初の明確なエラーを保存し、互換性、パス、権限、拡張機能、古いリソースを切り分けます。
restoreはアンインストールではありません。CLI、設定、テーマ、拡張機能が残ることがあります。完全削除にはアンインストールガイドを使います。
| 状況 | コマンド | 次の確認 |
|---|---|---|
| テーマや拡張機能を変更 | spicetify apply | Spotifyを開いて一項目を確認 |
| 初回または有効なバックアップなし | spicetify backup apply | 完了までSpotifyを開かない |
| クリーンな状態と比較 | spicetify restore | カスタマイズなしで確認 |
| Spotify更新後に消えた | spicetify backup apply | 先にCLI互換性を確認 |
正しいSpicetify 更新コマンドを選ぶ
更新方法は導入方式で決まります。対応するインストーラー経由なら spicetify update、パッケージ管理ツール経由なら通常は同じ管理ツールを使います。
更新後は spicetify --version を実行し、公式GitHubと比較します。このガイドで確認した最新版は2026年7月4日UTC公開のv2.44.0です。今後のリリースで変わる可能性があります。
Spicetifyの更新とSpotifyの更新は別です。Spotifyがリソースを置換すると、新しいbackup/applyが必要になる場合があります。非公式の古いインストーラーを使う前に互換性を確認してください。
spicetify update
PowerShell、PATH、管理者、プロセスのエラー対処
最初の明確なエラーを手掛かりにします。認識されないコマンドは導入やPATH、管理者警告は不適切な昇格、アクセス拒否は実行中のプロセスや権限のずれが主な原因です。
| 症状 | 主な原因 | 安全な対処 |
|---|---|---|
| spicetifyが認識されない | PATHにない、または古いPowerShell | 開き直し、Get-Command、公式導入の修復 |
| 管理者で実行しないよう警告 | 管理者PowerShell | 閉じて通常権限で実行 |
| アクセス拒否 | Spotifyが開いている、権限が不一致 | プロセスを終了し昇格を避ける |
| Spotifyが見つからない | 配布形式またはパスが不正 | デスクトップ版を開きspicetify configを確認 |
| 更新後に変更が消えた | Spotifyがリソースを置換 | 互換性確認後にbackup/apply |
管理者・互換性チェックを回避するオプションは、黒い画面、PATH不足、ロック中のファイルに対する通常の修正方法ではありません。
Spicetify PowerShell コマンドのよくある質問
最初に実行するSpicetify PowerShell コマンドは？
spicetify --version でPowerShellがCLIを見つけることと実行中のバージョンを確認します。
管理者としてSpicetifyを実行しますか？
通常は不要です。現在の公式手順が特定の作業で求める場合を除き、通常権限を使います。
applyとbackup applyの違いは？
applyは既存の基準を使い、backup applyは対応するクリーンな基準を作成または更新してから適用します。
Spotifyを復元するコマンドは？
spicetify restore で保存済みのクリーンなリソースへ戻します。CLI全体は削除されません。
全コマンドを確認する方法は？
spicetify --help とインストール済みバージョンに対応する公式CLIリファレンスを使います。
spicetifyコマンドが認識されない理由は？
CLIまたはPATHの問題、PowerShellの再起動不足が考えられます。Get-Command spicetify と公式導入手順を確認します。
参照した公式ソース
- Spicetify CLI コマンドリファレンス — コマンドとオプションの公式文書。
- Spicetify Getting Started — インストール、更新、バックアップ、適用の公式手順。
- Spicetify v2.44.0 — 2026年7月4日UTC公開の確認済み最新版。