解锁个性化体验：Spicetify 改造你的 Spotify 客户端

舍不得如此灿烂的某人，照亮了一起走过的日子；忘不了有笑有泪的共同经历，你我之间的情谊是那么真挚；缘起缘灭，人海沉浮，相忘于江湖。几分怅惘，几许祝福，几丝江湖气。 ——@知乎网友

1. 前言

🌟 Spotify：音乐爱好者的天堂
Spotify 是全球领先的正版流媒体音乐服务商之一，汇聚数亿用户，覆盖全球。其音乐库包含超过 3,000 万首歌曲，涵盖 Sony Music、EMI、Warner Music Group 和 Universal Music Group 等四大唱片公司及众多独立厂牌的作品。这些音乐均受到数字版权管理（DRM）的保护，让用户可以通过搜索艺术家、歌曲、专辑或流派，轻松找到心仪的音乐。🎶

⚠️ 体验上的不足
尽管功能强大，Spotify 仍存在一些问题，例如广告频繁打扰（免费用户）、歌词功能不完善以及主题单一等。这些缺陷在一定程度上影响了用户体验。📉

🔧 Spicetify：个性化 Spotify 的神器
为解决上述问题，开源工具 Spicetify 应运而生！它支持用户自定义 Spotify 客户端的外观与功能，包括更改配色方案、安装自定义应用与扩展、屏蔽广告等，让你的音乐体验更自由、更独特！🎨🎵

2. Spicetify 是什么

Spicetify 是一个多平台的命令行工具，用于自定义官方的 Spotify 客户端。它允许用户更改 Spotify 客户端的外观和功能，包括调整用户界面的配色方案和主题、安装自定义应用程序和扩展、屏蔽广告以及删除 Spotify 桌面应用程序中的一些不必要功能[^1]。

https://spicetify.app/

3. Spicetify 安装

Spotify 在 Linux、Mac、Windows 桌面端都是 CEF (Chromium Embedded Framework) 架构，这给对客户端修改的修改提升了很大的便利和可行性。

Spicetify 有安装教程【点击跳转】，下面的命令也是基于官网文档的。

3.1 准备工作

step1：已经安装好了 Spotify；

Spotify 官网：https://open.spotify.com/

step2：保证计算机全局可以🪜🪜；

使用软路由进行网络代理🎈；
使用代理软件进行网络代理，在软件中开启全局代理 / Tun 模式。

若全局代理开启后不行的话，建议在终端单独开启代理，可在开始打开终端的时候，输入类似下面的命令：

 export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:789

之所以说是类似下面的命令，是因为命令中包含的端口「7897」或「789」参数，需要随着你在用的不同代理工具而变化。

3.2 Windows 平台

推荐安装方法

Powershell （预构建的二进制文件）

iwr -useb https://raw.githubusercontent.com/spicetify/cli/main/install.ps1 | iex

如果您想安装 Spicetify Marketplace，还可以运行以下命令，它使您可以访问 Spotify 侧边栏中的一个选项卡，该选项卡允许您搜索和安装主题、扩展和片段。

iwr -useb https://raw.githubusercontent.com/spicetify/marketplace/main/resources/install.ps1 | iex

分别复制命令到 powershell 里执行就能完成安装。

最好是以管理员身份打开 powershell，以免出现权限不足的问题。

本人以 Windows11 系统为例，进行演示：

图1 预构建二进制文件

图2 安装 Spicetify Marketplace

3.3 Mac 或 Linux 平台

Spicetify CLI

curl -fsSL https://raw.githubusercontent.com/spicetify/cli/main/install.sh | sh

Spicetify Marketplace

curl -fsSL https://raw.githubusercontent.com/spicetify/marketplace/main/resources/install.sh | sh

分别复制命令在终端里执行就能完成安装，在不同系统中粘贴的这 2 行命令，其实是从 GitHub 下载 Spicetify 和相关的文件，不出意外的话， Spicetify 和 Spicetify Marketplace 便可顺利安装。

4. 基本用法

安装 Spicetify 和 Spicetify Marketplace 后，您可以使用它来自定义您的 Spotify 使用 Marketplace 中找到的所有可用扩展和主题。

图5 Markertplace安装成功

4.1 spicetify 常见命令

spicetify                                # 初始化 Spicetify
spicetify backup                         # 备份当前配置
spicetify apply                          # 应用自定义设置
spicetify restore                        # 将 Spotify 客户端恢复到默认状态，移除所有通过 Spicetify 进行的自定义设置。
spicetify upgrade                        # 更新 Spicetify
spicetify config extensions <extension_name>            # 安装扩展
spicetify config current_theme <theme_name>             # 设置主题
spicetify reset                          # 重置 Spicetify 的配置文件，清除所有自定义设置。

有关其他命令和其他标志信息，请运行：spicetify --help命令查看。

4.2 插件安装与卸载

4.2.1 扩展存储路径

Extensions文件夹

平台	路径
Windows	`%appdata%\spicetify\Extensions\`
Linux/MacOS 操作系统	`~/.config/spicetify/Extensions`

Extensions文件夹中的文件夹。

如果有 2 个同名的扩展，则 Home 目录中的扩展将被优先考虑。

一些Spotify API端点已公开，可以在global对象中找到。查看API文档：Spicetifyglobal.d.ts。

将扩展文件放入正确的文件夹后，运行以下命令进行安装（有的插件可以直接用插件安装）：

4.2.2 安装插件

spicetify config extensions <file name>
spicetify apply

Note：使用命令添加扩展时，总是将文件名附加到现有的扩展列表中。它不会替换整个键的值

4.2.3 卸载插件

如果你想从当前的扩展列表中移除一个扩展，你可以在文件名后面添加一个 -。

spicetify config extensions <file name>-
spicetify apply

5. 推荐插件

5.1 Adblock

"Spicetify 扩展用于阻止所有音频广告和界面广告。只需运行该扩展，它就会开始工作！"

5.2 Full App Display

Full App Display 是 Spicetify 提供的插件，允许用户在 Spotify 客户端中启用全屏显示模式。虽然 Spotify 官方客户端不支持此功能，但通过 Spicetify，用户可以隐藏或显示播放控制、歌曲信息和播放列表等元素，实现简洁的全屏播放体验。这对于喜欢在大屏幕上欣赏专辑封面和歌词的用户来说非常实用。

若要安装，请运行以下命令：

 spicetify config extensions fullAppDisplay.js     
 spicetify apply

full App Display 也能实现优雅全屏的播放（full App Display和FullScreen功能差不多），其实插件市场也可以安装本插件

图7 安装Full-App-Display插件

5.3 lyrics-plus

安装歌词增强（lyrics-plus）的插件，从各种歌词提供商（Musixmatch、Netease、Genius）获取当前曲目的歌词。

 spicetify config custom_apps lyrics-plus   
 spicetify apply

图8 安装lyrics-plus插件

搞定之后，重启 Spotify，点击 Spotify 中类似下面的小图标，就能进入全屏播放的界面啦。

鼠标右击界面，会弹出下图的面板，可启用/关闭多个选项：

此外，点击界面右下角的按钮，还可以调整歌词的字号大小、歌词滚动的延迟时间，切换显示部分歌词/全部歌词(Compact)。

图9 全屏歌词效果1

图10 全屏歌词效果2

5.4 New Releases

汇总来自最喜欢的艺术家、播客的所有新版本。时间范围、发布类型和其他过滤器可以在配置菜单中自定义（在配置文件菜单中，右上角带有您的用户名的按钮）。

 spicetify config custom_apps new-releases
 spicetify apply

6. 更换主题

换主题最简单就是在插件市场搜索直接应用即可；

若要使用第三方主题，将主题文件下载到本地后进行解压，将解压得到的多个主题文件放到 .spicetify 下的 Themes 文件夹中。

网上有很多 Spicetify 主题，也有整理好的 Spicetify 主题库，这里推荐下载 Spicetify 官方主题库。

6.1 命令实现

如果安装了git的话，直接复制下面的命令完成添加。

Windows

 git clone https://github.com/spicetify/spicetify-themes.git    #从GitHub上克隆（即复制）spicetify-themes仓库到您的本地计算机
 cd spicetify-themes                                            #克隆仓库后，使用这个命令切换到仓库的目录中
 cp * "$(spicetify -c | Split-Path)\Themes\" -Recurse           #将spicetify-themes目录中的所有文件和目录复制到Spicetify的主题目录中

Linux

 git clone https://github.com/spicetify/spicetify-themes.git
 cd spicetify-themes
 cp -r * ~/.config/spicetify/Themes

Mac

 git clone https://github.com/spicetify/spicetify-themes.git
 cd spicetify-themes
 cp -r * ~/.config/spicetify/Themes

6.2 手动实现

不想安装git也可以，直接复制主题文件到 Spicetify 主题文件夹目录即可，详情可以参考文章设置即可。

您可以在 2 个地方放置主题：

Themes文件夹

平台	路径
窗户	`%appdata%\spicetify\Themes`
Linux/Mac操作系统	`~/.config/spicetify/Themes`

ThemesSpicetify 可执行文件目录中的文件夹

如果有 2 个同名主题，则优先选择 Home 目录中的主题。

每个主题都应包含：

color.ini：存储稍后将转换为 CSS 变量的颜色值
user.css：一组自定义CSS规则，用于操作、隐藏、移动UI元素。

6.3 切换主题

官方仓库提供了 BurntSienna、Default、Dreary、Dribbblish、Flow、Glaze、Onepunch、Sleek、Turntable、Ziro 这几个主题，只需要在终端里执行下命令就能切换主题。

比如切换到 Onepunch 主题：

 spicetify config current_theme Onepunch
 spicetify apply

图11 切换主题

想要恢复默认就在powershell中输入spicetify restore backup回车。

spicetify restore backup ：用于恢复之前备份的 Spotify 客户端配置文件。

需要注意的是：spotify客户端自动升级后皮肤多半会失效，需要重新应用输入spicetify apply，有时 Spotify 客户端会更新，这是我们还需要输入spicetify update升级 spicetify 。

图12 Onepunch主题效果

7. spicetify 卸载

7.1 Windows

spicetify restore
rmdir -r -fo $env:APPDATA\spicetify
rmdir -r -fo $env:LOCALAPPDATA\spicetify

7.2 Linux and MacOS

 spicetify restore
 rm -rf ~/.spicetify
 rm -rf ~/.config/spicetify

8. 🎵歌词软件-Lyricify🎶✨

Lyricify 是一款专为 Spotify 等音乐平台提供滚动歌词的工具！🎤 Lyricify 支持 Spotify、iTunes、Apple Music、Music Center、QQ 音乐、网易云音乐 和 YesPlayMusic。不过需要注意的是，Lyricify 3 已进入 EOL（生命周期终止）阶段，如果你是 Spotify 用户，强烈建议切换到功能更强大的 Lyricify 4！🚀

Lyricify 提供多种显示方式，包括桌面歌词、全屏歌词和独特的“灵动岛”歌词显示。灵动岛可以拖动到屏幕中央，并在光标靠近时自动隐藏，提供更加沉浸式的音乐体验。

https://github.com/WXRIW/Lyricify-App

对于 Spotify 用户来说，Lyricify 能够为那些在 Spotify 上没有提供歌词的歌曲适配歌词，并且支持桌面歌词显示。

图13 Lyricify 歌词软件效果

9. 常见问题

9.1 配置文件在哪里？

配置文件通常位于：

平台	路径
Windows	`%appdata%\spicetify\config-xpui.ini`
Linux/MacOS 操作系统	`~/.config/spicetify/config-xpui.ini`

但是，您可以通过以下方式具体知道它的位置：

 spicetify -c

或者，您可以通过在终端中输入以下内容来打开它所在的文件夹：

 spicetify config-dir

有关每个配置字段的详细信息，请运行：

 spicetify --help config