解锁个性化体验：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]。
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 | shSpicetify 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 applyNote：使用命令添加扩展时，总是将文件名附加到现有的扩展列表中。它不会替换整个键的值
4.2.3 卸载插件
如果你想从当前的扩展列表中移除一个扩展，你可以在文件名后面添加一个 -。
spicetify config extensions <file name>-
spicetify apply5. 推荐插件
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 apply6. 更换主题
换主题最简单就是在插件市场搜索直接应用即可；
若要使用第三方主题，将主题文件下载到本地后进行解压，将解压得到的多个主题文件放到 .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/ThemesMac
git clone https://github.com/spicetify/spicetify-themes.git
cd spicetify-themes
cp -r * ~/.config/spicetify/Themes6.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\spicetify7.2 Linux and MacOS
spicetify restore
rm -rf ~/.spicetify
rm -rf ~/.config/spicetify8. 🎵歌词软件-Lyricify🎶✨
Lyricify 是一款专为 Spotify 等音乐平台提供滚动歌词的工具！🎤 Lyricify 支持 Spotify、iTunes、Apple Music、Music Center、QQ 音乐、网易云音乐 和 YesPlayMusic。不过需要注意的是，Lyricify 3 已进入 EOL（生命周期终止）阶段，如果你是 Spotify 用户，强烈建议切换到功能更强大的 Lyricify 4！🚀
Lyricify 提供多种显示方式，包括桌面歌词、全屏歌词和独特的“灵动岛”歌词显示。灵动岛可以拖动到屏幕中央，并在光标靠近时自动隐藏，提供更加沉浸式的音乐体验。
对于 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
