Spicetify カスタムアプリ：インストール・設定・削除

Spicetify カスタムアプリとは？

既存画面の一部だけを変更するのではなく、Spotify のナビゲーションに独立したページを追加します。

カスタムアプリはカスタマイズされた Spotify デスクトップクライアント内で動く JavaScript アプリです。公式ドキュメントの例には、歌詞を表示する Lyrics Plus、フォロー中のアーティストやポッドキャストの新着を表示するリリース情報アプリ、音楽関連のフィードを扱う Reddit があります。

テーマは色や外観、拡張機能は既存の操作や動作、snippet は小さな CSS 変更、カスタムアプリは大きなサイドバー体験を担当します。種類を分けて考えると、Spotify の更新後に問題の原因を絞りやすくなります。

Spicetify カスタムアプリのインストール方法

Marketplace にある場合は Marketplace を使い、手動の場合は公式の CustomApps フォルダーにアプリを置いてから有効化します。

まず CLI が動くことを確認します。新しいターミナルで `spicetify --version` を実行し、設定を apply する前に 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

   フォルダー名を登録

   表示名ではなく実際のフォルダー名を指定します。この例では reddit を登録します。

   spicetify config custom_apps reddit
4. 4

   apply と再起動

   Spotify を閉じた状態で apply し、再起動してサイドバーを確認します。

   spicetify apply

公式例を設定して動作確認する

最初は1つだけ有効にし、確認できてから次のアプリを追加します。

公式ドキュメントの例は `lyrics-plus`、`new-releases`、`reddit` です。コマンドの名前はフォルダー名と完全に一致させてください。変更を apply する間は Spotify を終了します。

複数のアプリも設定できますが、少ない構成の方が問題を切り分けやすくなります。サイドバーのリンク、ページ内容、通常の再生をアプリごとに確認してください。

リストを変更したら `spicetify apply` を実行します。アプリによっては Spotify のプロフィールメニューに独自設定がありますが、項目はメンテナーによって異なるため、別のアプリにも同じ設定があるとは限りません。

Spicetify のカスタムアプリを削除する方法

まず最近追加したアプリ、または問題のあるアプリを設定から外し、その後にフォルダーを削除するか判断します。

公式の削除パターンでは、フォルダー名の前にマイナスを付けます。これは有効な `custom_apps` リストから外す操作であり、CLI のアンインストールとは別です。Spotify を閉じて apply し、再起動してサイドバーを確認してください。

設定から名前を外してもローカルファイルが自動的に消えるとは限りません。再び使う可能性があるならフォルダーを残し、不要になったことを確認してから削除します。

1. 1

   フォルダー名を外す

   登録されている正確なフォルダー名を指定します。この例では reddit を外します。

   spicetify config custom_apps -reddit
2. 2

   小さい構成を apply

   Spotify を閉じ、apply 後に再起動します。

   spicetify apply
3. 3

   基本動作を確認

   サイドバー、検索、再生、残りのカスタマイズを確認します。

表示されない、または空白になる場合

CLI 全体を再インストールする前に、症状を説明できる最小の層から確認します。

サイドバーに表示されない場合は、CustomApps の場所、フォルダー名、`manifest.json` を確認します。`spicetify config custom_apps` で有効な値を確認し、Spotify を閉じて再度 apply してください。通常の再起動も行います。

ページが表示されても空白の場合は、完全なエラーを保存し、`index.js` を確認します。構文エラー、古いアプリ、Spotify 側の変更によって1つのアプリだけが影響を受けることがあります。

Spotify 更新後は、先に更新と backup apply のガイドを確認します。公式の互換性情報が必要と示す場合だけ、クリーンなバックアップの再適用や CLI 更新を行い、その後にアプリを1つずつ戻します。

• 公式の CustomApps パスを確認する。
• index.js と manifest.json の名前を確認する。
• 別のインストーラーを使う前に custom_apps の値を見る。
• 最後に追加したアプリだけを外して確認する。
• 完全なエラーをメンテナーに渡す。

Spicetify カスタムアプリ：よくある質問