qbittorrent可通过五种方式更换主题：一、加载内置.qbtheme深色主题；二、用vuetorrent替换web ui；三、通过stylus注入catppuccin css；四、部署qui并切换其内置主题；五、手动编辑qbittorrent.conf注入qss样式。
如果您正在使用qBittorrent，但希望摆脱默认界面的单调感，提升视觉体验与操作舒适度，则可能是由于当前未启用自定义主题或Web UI。以下是更换界面主题和皮肤的具体方法：
一、应用内置深色主题（qBitTorrent-fluent-theme）
该方法通过加载预编译的.qbtheme文件，直接修改客户端本地UI样式，适用于桌面版qBittorrent 4.4+，无需重启系统即可生效，且完全兼容Qt样式系统。
1、访问GitHub镜像仓库：git clone https://gitcode.com/gh_mirrors/qb/qBitTorrent-fluent-theme
2、打开qBittorrent客户端，依次点击工具 → 选项 → 外观
3、在“主题”区域点击加载主题按钮，从克隆目录的themes/子文件夹中选择fluent-dark.qbtheme或fluent-dark-no-mica.qbtheme
4、勾选启用主题，点击确定后关闭并重新启动qBittorrent
二、切换Web UI为VueTorrent（响应式移动端适配）
此方案替换的是浏览器访问qBittorrent Web界面所呈现的前端代码，支持深浅模式切换、PWA安装及触控优化，特别适合在手机、平板等设备上使用。
1、前往GitHub Releases页面：Releases · WDaan/VueTorrent，下载最新dist.zip压缩包
2、解压后获得vuetorrent/文件夹，将其放置于NAS或宿主机指定路径（如/opt/vuetorrent）
3、若运行于Docker环境，在docker-compose.yml中添加卷映射：- /opt/vuetorrent:/vuetorrent
4、登录qBittorrent Web界面，进入设置 → Web UI → 启用备用Web UI，在Root folder字段填入挂载路径（如/vuetorrent或/opt/vuetorrent）
5、保存设置后刷新浏览器，新UI将立即加载
三、通过Stylus插件注入Catppuccin CSS样式
该方式不修改服务端任何配置，仅在浏览器层叠加CSS变量覆盖，实现轻量级主题美化，适用于无法控制服务器或Docker配置的用户，但效果仅限当前浏览器与设备。
1、在Chrome或Edge浏览器中安装扩展Stylus
2、打开qBittorrent Web界面（如http://localhost:8080），点击地址栏右侧Stylus图标，选择编写新样式
3、在编辑器中粘贴Catppuccin官方提供的qBittorrent CSS代码（来源：catppuccin/qbittorrent）
4、设置样式名称（如“Catppuccin-Mocha”），点击保存
5、页面自动重载，深色紫调UI即刻呈现
四、使用qui替代Web UI并切换内置主题
qui是基于React构建的现代化qBittorrent WebUI替代方案，其主题系统基于CSS变量动态注入，支持免费/高级主题分类、颜色变体实时切换，且所有更改均无需刷新页面。
1、部署qui服务（可独立运行或反向代理至/qui路径）
2、登录qui界面，点击右上角齿轮图标 → 外观 → 主题
3、在主题选择面板中浏览卡片式预览，识别标有Free标签的主题
4、点击任意主题卡片（如autobrr或Napster），界面即时渲染对应风格
5、若主题支持变体，点击卡片底部颜色圆点切换主色调（如blue/coral/emerald）
五、手动编辑qBittorrent.conf启用自定义QSS样式
此方法直接干预qBittorrent配置文件，通过注入Qt Style Sheets（QSS）代码控制控件外观，适用于熟悉CSS语法且需精细控制UI细节的高级用户。
1、关闭qBittorrent进程，定位配置文件路径（Linux通常为~/.config/qBittorrent/qBittorrent.conf；Windows为%APPDATA%\qBittorrent\qBittorrent.conf）
2、用文本编辑器打开该文件，在[General]节下方新增一行：GUI/StyleSheet=@/path/to/custom.qss
3、创建custom.qss文件，写入合法QSS规则（例如：QMenuBar { background: #2d2d2d; color: #f0f0f0; }）
4、保存所有更改，重新启动qBittorrent，样式将按QSS规则渲染
