让直播间知道你现在在听什么。
我们做一款开源的桌面媒体桥接工具：把操作系统当前正在播放的媒体信息取出来， 通过本机 HTTP 服务交给 OBS 浏览器源渲染成浮层。主程序用 Rust 编写， 界面是 Tauri 2 + Vue 3，Windows 走 SMTC、Linux 走 MPRIS2，主题可换可热更新。
主播放歌时，直播画面里的手动改字、外挂插件、平台限定都很麻烦。
smtc2web 直接读取系统级的媒体会话，在本机起一个很小的 HTTP 服务，
OBS 里加一个浏览器源指过去就有了。不依赖直播平台，不上传数据，默认只听 127.0.0.1。
| 仓库 | 作用 |
|---|---|
| smtc2web | 主程序：Rust + Tauri 2 + Vue 3，Windows SMTC / Linux MPRIS2 → 本机 HTTP → OBS |
| smtc2web-website | 官网与内置 Wiki，文档、下载与捐赠入口都在这里 |
| smtc2web-dev | 面向 smtc2web 开发环境的命令行工具 |
| smtc2web-themes | 主题商店，可免费下载或发布主题 |
| theme-upload | 主题发布流水线，让主题的更新分发更省事 |
| r2-dir-list | Cloudflare R2 下载镜像的目录列表页（fork 自 cmj2002/r2-dir-list） |
| smtc2web-theme-spotify | Spotify 风格主题，在组织内作为公开模板维护；主程序子模块目前指向 AkarinLiu/smtc2web-theme-spotify |
| smtc2web-theme-default | 主题开发模板，从这里起步写自己的主题 |
- 到 Releases 下载对应平台的安装包 （Windows x64 / arm64，Linux amd64 / arm64 的 deb 与 rpm）， 也可以用镜像站 https://download.smtc2web.org。
- 启动 smtc2web，托盘出现图标后它会自动读取正在播放的内容。
- OBS 新建 浏览器 来源，URL 填
http://localhost:3030。改过监听端口的话同步改这里。 - 想换个样子，去主题页启用内置主题，或者从主题商店下载、从 Git 仓库安装。
构建与打包说明见 Wiki：https://smtc2web.org/wiki/compile。
- 主仓库的 Node 与 pnpm 版本由 mise 通过
.mise.toml锁定， Rust 仍使用 rustup 的 stable 工具链；进入目录后mise install && pnpm install即可开工。 - CI 在 Windows 与 Linux、x86_64 与 aarch64 四种组合上跑
cargo check与cargo clippy -- -D warnings，另有vue-tsc类型检查。 - 安装包经 minisign 签名，客户端通过更新端点校验后才安装。
- 参与方式见 CONTRIBUTING.md， 行为准则见 CODE_OF_CONDUCT.md。
- 提功能或问题：Issues 里已备好缺陷与功能请求两套模板。
- 实时交流：Zulip 社区，或写信到 hello@smtc2web.org。
- 长期贡献、修复过恶意漏洞或提供关键代码的参与者，会按贡献者指南的说明获得 Maintainer 权限。
- 本项目靠爱发电，欢迎捐赠支持。
请不要用公开 Issue 报告漏洞，走私密安全公告： https://github.com/smtc2web/smtc2web/security/advisories/new。 安全政策与响应时限见 SECURITY.md， 只有最新的补丁版本会获得安全更新。
smtc2web organization overview
smtc2web builds an open-source desktop media bridge. It reads the operating system's
current media session (SMTC on Windows, MPRIS2 on Linux) and exposes it over a small
local HTTP server so an OBS Browser source can render a now-playing overlay — no
platform lock-in, no telemetry, bound to 127.0.0.1 by default.
- Start here: grab the latest installer from Releases
or the R2 mirror, then point an OBS Browser source at
http://localhost:3030. - Repositories: the main app, the website and wiki, a dev CLI, a theme store with a publishing pipeline, an R2 directory listing, plus the embedded Spotify theme and a theme template.
- Tooling: Node and pnpm are pinned by mise in the app repo, Rust comes from rustup; CI covers Windows and Linux on x86_64 and aarch64.
- Security: report vulnerabilities privately through security advisories; only the latest patch release is supported.
- Licenses: not uniform — the app, the dev CLI, the theme pipeline and the R2 listing are MIT, both theme repos are CC0-1.0, and the website plus theme store have no license declared yet.
- Docs: https://smtc2web.org/wiki/compile
各仓库的许可以其仓库内的 LICENSE 文件为准，并不统一：
| 范围 | 许可 |
|---|---|
| 主程序 smtc2web、smtc2web-dev、theme-upload、r2-dir-list | MIT |
| 两个主题仓库（spotify / default） | CC0 1.0 Universal，贡献到公有领域 |
| smtc2web-website、smtc2web-themes | 暂未声明，复用前请先开 Issue 确认 |
欢迎 fork、改造，把主题带进你的直播间。
