ColorOS Gallery Nomedia Guard

让 ColorOS 相册(com.coloros.gallery3d)遵循 Android .nomedia 标准,隐藏你不想在相册出现的媒体。

功能清单

  • 保护 .nomedia:ColorOS 相册内置机制会偷偷删除/改名「DCIM、Download、微信、QQ 等保护名单目录」里的 .nomedia,导致你屏蔽失效。本模块阻断该机制,.nomedia 不再被相册破坏。
  • 自动隐藏已入库媒体:对加 .nomedia 之前已被扫描进相册的旧图,模块在相册读取媒体库时自动过滤,打开相册即不再显示(不删文件、不删记录,移走 .nomedia 即恢复显示)。
  • 实时隐藏/恢复(v1.3.0)开着相册时新建/删除 .nomedia,图片列表实时消失/恢复,无需重开相册或切换页面。

使用说明

  • 作用域:仅 com.coloros.gallery3d(ColorOS 相册),不影响系统媒体库、不影响其它 App。
  • 无 UI / 无开关:装好即生效,无需配置。
  • .nomedia 即实时生效,无需重启手机
    • 相册开着时新建 .nomedia → 该目录及子目录的照片/视频立即隐藏
    • 相册开着时删除 .nomedia立即恢复;隐藏期间新复制进目录的文件也会被重新扫描并显示。
  • 监控范围:实时监控 /Pictures/DCIM 目录树(覆盖相册绝大多数图片来源,含全部子目录)。位于其它目录的 .nomedia 由查询过滤兜底——相册读取媒体库时同样自动隐藏。
  • 日志提示:若 LSPosed 日志里看到一条 FAIL,属正常——相册未提供该入口,模块自动跳过,不影响隐藏效果。

版本

  • 当前版本:v1.3.0(versionCode 13)
  • Xposed API:api102(libxposed)
  • minSdk 26(Android 8.0)/ targetSdk 37

安装

  1. 安装 LSPosed
  2. 安装本模块 APK(见 Releases)
  3. LSPosed 中启用模块,勾选作用域 com.coloros.gallery3d
  4. 重启 ColorOS 相册(或重启手机)

构建

./gradlew :app:assembleDebug   # 开发调试(默认)
./build.sh                     # patch/minor/major 升版 + 正式版(发布时才用)

免责声明

模块纯本地 Hook,不含任何联网/上传逻辑,卸载即完全恢复。

许可证

本项目基于 GPL-3.0 协议开源。

Releases

9/3/2026, 10:09:50 AM

v1.3.13

新增功能

  • 实时隐藏:相册开着时,给文件夹加上 .nomedia 文件,里面的照片/视频立即从相册消失,无需重开相册或切换页面

修复

  • 恢复完整:删除 .nomedia 后,之前隐藏的照片/视频自动恢复显示
  • 新文件也能恢复:在 .nomedia 存在期间新复制进该文件夹的照片/视频,删除 .nomedia 后也会被重新扫描并显示(此前只恢复旧文件)

体验优化

  • 文件夹监控更稳定:加/删 .nomedia 时相册界面实时刷新,不再闪一帧旧内容