Andrea-lyz GitHub avatar

ColorOS-Audio-Policy-Patcher-Enhancer

Andrea-lyz

A systemless Magisk/KernelSU module that patches ColorOS audio policies to inject Salt Music or other apps into OEM multimedia and MetaAudio music scene configurations, automatically regenerating after OTAs or cloud policy changes.

Stars

6

7-day growth

No data

Forks

1

Open issues

0

License

Apache-2.0

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It solves a specific pain point for ColorOS users by enabling system-level audio enhancement for their preferred music apps without modifying the system partition, and it survives OTA updates gracefully.

Who it is for

  • ColorOS 15+ users who want system-level audio enhancement for music apps
  • Magisk/KernelSU users who need a non-destructive audio policy patcher
  • Developers or modders working with ColorOS OEM audio frameworks

Use cases

  • Adding Salt Music or any music app to ColorOS's OEM multimedia and MetaAudio policies for improved audio quality
  • Maintaining custom audio policy patches across OTA updates and cloud policy changes
  • Enabling spatial audio and head tracking for non-default music apps on compatible devices

Strengths

  • Supports both Multimedia_Daemon_List.xml and Meta_Audio_Policy.xml, including online cloud policy files
  • Automatically regenerates patches after OTA updates, cloud policy changes, or package list edits
  • Uses bind mounts to apply changes without modifying the system partition, preserving system integrity

Considerations

  • Only supports ColorOS 15 or newer; APatch is not fully verified
  • Requires KernelSU/APatch users to manually disable 'Unmount modules' for Android System to allow file visibility
  • Patch generation may fail if the source OEM policy is missing or has an incompatible structure

README quick start

ColorOS Audio Policy Patcher Enhancer

Salt Music 音频增强 · Magisk / KernelSU 模块

一个面向 ColorOS 的系统无修改音频策略补丁模块。它会为 Salt Music 或你指定的其他应用注入 OEM 多媒体与 MetaAudio 音乐场景策略，并在系统 OTA、云控文件或包名配置变化后自动重新生成补丁。

English

功能

  • 同步修补 Multimedia_Daemon_List.xml 与 Meta_Audio_Policy.xml
  • 支持 /data/oplus/multimedia/*_Online.xml 云控策略文件
  • 默认以 QQ 音乐策略为模板，为自定义包名复制对应音乐场景配置
  • 通过 packages.txt 配置多个应用，一行一个包名
  • 保留原始策略副本，并在 OTA 或云控策略变化后重新生成补丁
  • 使用 bind mount 生效，不直接修改系统分区
  • 提供启动日志、挂载状态与内容完整性检查

兼容性与风险提示

  • ColorOS 15 及以上
  • Magisk 20.4 及以上
  • KernelSU
  • APatch 尚未完整验证

不同机型和 ColorOS 版本的 OEM 策略结构可能不同。安装前请保留可用的恢复方式；如果源策略不存在或格式不兼容，相关补丁可能无法生成。

KernelSU / APatch 用户需要在 App Profile（超级用户配置）中找到“Android 系统”，关闭它的“卸载模块”开关，使系统框架能够读取模块挂载的文件。否则空间音频、头部追踪等功能可能不生效。

下载与安装

  1. 从 Releases 下载最新 ZIP。
  2. 在 Magisk、KernelSU 或 APatch 管理器中刷入 ZIP。
  3. 重启设备。

默认配置包含 Salt Music：

com.salt.music

自定义应用包名

安装后编辑：

/data/adb/modules/SaltMusicEnhance/packages.txt

每行填写一个包名；空行和以 # 开头的注释会被忽略。例如：

# 保存后重启生效
com.salt.music
com.netease.cloudmusic
com.kugou.android

保存后重启设备。升级模块时，已有的 packages.txt 会被保留。

工作原理

安装和开机早期阶段会按“云控文件 > /system_ext > /system/system_ext”的优先级寻找原始策略。模块保存原始副本，以 QQ 音乐 com.tencent.qqmusic（MetaAudio 必要时回退到 com.heytap.music）为模板，为 packages.txt 中的应用生成策略，再将结果 bind mount 到系统实际读取的位置。

模块动态处理以下文件：

  • /system_ext/etc/Multimedia_Daemon_List.xml
  • /system_ext/etc/Meta_Audio_Policy.xml
  • /data/oplus/multimedia/Multimedia_Daemon_Online_List.xml
  • /data/oplus/multimedia/Meta_Audio_Policy_Online.xml

日志与检查

日志路径：

/data/adb/modules/SaltMusicEnhance/saltmusic.log

简单检查：

grep 'com.salt.music' /system_ext/etc/Multimedia_Daemon_List.xml
grep 'com.salt.music' /system_ext/etc/Meta_Audio_Policy.xml
cat /data/adb/modules/SaltMusicEnhance/saltmusic.log

部分设备实际使用 /system/system_ext/etc/ 或 /data/oplus/multimedia/ 下的对应文件，请按日志中的目标路径检查。

从源码构建

在 Linux、WSL 或 Git Bash 中安装 zip 与 unzip，然后运行：

bash scripts/build.sh 3.1.1

产物位于 dist/ColorOS-Audio-Policy-Patcher-Enhancer-v3.1.1.zip。构建采用运行时文件白名单，不会把 README、GitHub 配置或“问题排查”目录打入模块。

手动发布工作流

仓库提供 Build and Release 手动工作流：

  1. 打开 GitHub 仓库的 Actions 页面。
  2. 选择 Build and Release。
  3. 点击 Run workflow。
  4. 输入版本号，例如 3.1.1，然后运行。

工作流会校验版本、更新发布包内的 module.prop、构建并测试 ZIP，最后创建 `

Description

为ColorOS提供最佳音乐体验 | 修补 Multimedia + MetaAudio 策略 | 编辑packages.txt自定义包名

Related repositories

Similar projects matched by category, topics, and programming language.

jamesob
Featured
jamesob GitHub avatar

local-llm

A comprehensive guide for building and configuring a high-end local machine to run state-of-the-art LLMs, with detailed hardware choices, BIOS tuning, and Docker-based model serving.

AI & Machine LearningLarge Language Models
1,660
bjan
Featured
bjan GitHub avatar

claudemux

Claudemux is a lightweight, dependency-minimal message bus that lets multiple Claude Code sessions communicate in real-time over tmux, enabling one session to ask another a question and receive the answer without manual intervention.

AI & Machine LearningAI Agents
9
AARomanov1985
AARomanov1985 GitHub avatar

Audio-Cassette-Simulation

A set of bash scripts using ffmpeg to simulate vintage cassette tape audio profiles with noise, wow/flutter, bandwidth limits, and EQ.

Shell
373