{"id":27144380,"url":"https://github.com/cataerogong/smartbgm","last_synced_at":"2026-01-21T18:01:55.179Z","repository":{"id":281978688,"uuid":"947068410","full_name":"cataerogong/SmartBGM","owner":"cataerogong","description":"mute bgm when other apps play sound","archived":false,"fork":false,"pushed_at":"2025-03-24T06:59:02.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-08T08:58:58.044Z","etag":null,"topics":["autohotkey","bgm","volume","volume-control"],"latest_commit_sha":null,"homepage":"","language":"AutoHotkey","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cataerogong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-12T05:20:53.000Z","updated_at":"2025-03-25T09:18:08.000Z","dependencies_parsed_at":"2025-03-12T06:38:37.508Z","dependency_job_id":null,"html_url":"https://github.com/cataerogong/SmartBGM","commit_stats":null,"previous_names":["cataerogong/smartbgm"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/cataerogong/SmartBGM","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cataerogong%2FSmartBGM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cataerogong%2FSmartBGM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cataerogong%2FSmartBGM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cataerogong%2FSmartBGM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cataerogong","download_url":"https://codeload.github.com/cataerogong/SmartBGM/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cataerogong%2FSmartBGM/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28638491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T17:36:33.271Z","status":"ssl_error","status_checked_at":"2026-01-21T17:36:30.617Z","response_time":86,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autohotkey","bgm","volume","volume-control"],"created_at":"2025-04-08T08:58:59.636Z","updated_at":"2026-01-21T18:01:55.128Z","avatar_url":"https://github.com/cataerogong.png","language":"AutoHotkey","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SmartBGM\n\n## 功能\n\n有其他程序播放声音时，自动将 BGM 程序的声音关闭，播放结束后自动恢复 BGM 音量。\n\n* 只是调整 BGM 音量至 0% 或 100%，不会停止 BGM 播放。\n\n* 调节的是 Windows 系统“音量合成器”中 BGM 程序对应的音量设置，而不是 BGM 程序自身提供的音量设置。\n\n## 使用说明\n\n* 【注意】由于 SmartBGM 通过系统的音频会话来调节音量，BGM 程序必须在音频会话中存在才能调节，因此最好 **先关闭 SmartBGM 再关闭 BGM 程序**，或者 **保持 SmartBGM 始终运行**。\n\n* 参数设置说明\n\n  - `BMG 程序`\n\n    有两种方式设置：\n\n    1. 直接在“BGM 程序”输入框中输入 BGM 程序 exe 文件名\n\n    2. 先启动 BGM 程序并播放，然后点击“BGM 程序”输入框右侧的“…”，会列出当前所有音频会话进程，双击选择 BGM 程序\n\n  - `音量调节方式`\n\n    调节 BGM 程序音量的方式。\n\n    `瞬` - 直接调节音量至 0% 或者 100%\n\n    `渐` - 以 20% 的幅度逐渐调节音量至 0% 或者 100%\n\n  - `自动开始监控`\n\n    勾选后，SmartBGM 启动后会自动按照设置参数开始监控。\n\n* `应用设置`\n\n  使设置参数生效，并保存到配置文件。\n\n* `开始监控`\n\n  开始监控系统播放声音的程序，自动调节 BGM 程序音量。\n\n* `停止监控`\n\n  停止监控，并恢复 BGM 程序音量。\n\n* `恢复音量`\n\n  恢复 BGM 程序音量。一般用不到，SmartBGM 会控制 BGM 程序音量，当 BGM 音量异常时才会用到。\n\n* 最小化窗口或按 `Esc` 键会将 SmartBGM 缩小到系统托盘，双击系统托盘图标恢复。\n\n## FAQ\n\n### 只有 BGM 程序在播放，却没有声音\n\n可能有多种原因：\n\n1. 有其他程序在播放声音，但是它的音量比较低甚至为 0，或者就是在播放一段无声的音频，SmartBGM 还是会认为它在播放，因此会关闭 BGM 音量\n\n    【解决方法】停止其他程序播放。\n\n2. 其他程序已停止播放声音，但是未正常设置自己的音频会话状态，SmartBGM 还是会认为它在播放，因此会关闭 BGM 音量\n\n    【解决方法】点击“BGM 程序”输入框右侧的“…”，会列出当前所有音频会话进程，看是否有其他程序的状态是“A”且音量大于 0%，如果有，关闭该程序。\n\n3. BGM 程序被静音，或者音量设为 0%\n\n   可能导致这种情况的操作：BGM 程序声音被 SmartBGM 关闭时（有其他程序在播放），先直接关闭 BGM 程序，然后“停止监控”或者关闭 SmartBGM，再次运行 BGM 程序时音量不会恢复。\n\n    【解决方法】BGM 程序保持播放，运行 SmartBGM，点击“恢复音量”。\n\n【终极解决方法】\n\n0. BGM 程序保持播放；\n1. 关闭 SmartBGM；\n2. 右键点击 Windows 右下托盘里的“音量”小喇叭，选择弹出菜单中的“打开音量合成器”；\n3. 在音量合成器中调整 BGM 程序对应的静音状态和音量。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcataerogong%2Fsmartbgm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcataerogong%2Fsmartbgm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcataerogong%2Fsmartbgm/lists"}