# HeadsOff **Repository Path**: android_ios_test/HeadsOff ## Basic Information - **Project Name**: HeadsOff - **Description**: Xposed module to disable heads-up notifications. - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2020-12-01 - **Last Updated**: 2021-01-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README #HeadsOff - English description please refer to [here](https://github.com/j2rong/HeadsOff#english). - Translations to other languages are welcomed, click [here](https://github.com/j2rong/HeadsOff#contributing) for details.
##主要功能 (Features) 这是一个**Xposed模块**，用于**禁用**选定应用的[悬挂式（Heads-up）通知](http://developer.android.com/guide/topics/ui/notifiers/notifications.html#Heads-up)，支持白名单，可选择放行部分通知。 ![Heads-up notification](http://developer.android.com/images/ui/notifications/heads-up.png) 部分应用（如：**微信WeChat**）滥用悬挂式通知且没有提供关闭选项，造成非常不良的用户体验，启用该模块后即可禁用同时不影响通知在状态栏、下拉列表中的显示。 - 支持Android 5、6 - 禁用选定应用的悬挂式通知 - 全局禁用 - 白名单，放行符合条件的悬挂式通知
##屏幕截图 (Screenshots)


##使用方法 - 安装并于[Xposed Installer](https://github.com/rovo89/XposedInstaller)中启用模块，重启 - 在 *HeadsOff* 中打开要禁用悬挂式通知的应用右侧的开关 - 模块默认**不启用**，请在*HeadsOff*中选择“**设置**”-“**当前状态**”启用
##更新日志 (Changelogs) - **0.5.78** ``` 对非中文地区默认使用英文显示 根据用户语言排序应用列表 白名单： 添加示例通知 添加正则表达式测试 ``` - **0.4.62** ``` 修复日志开关无效的Bug ``` - **0.4.56** ``` 界面调整，无功能修改 ``` - **0.4.51** ``` 添加日志开关 增加白名单，符合条件的通知将不会被屏蔽 执行效率优化 ``` - **0.3.34** ``` 修正当更改是否显示系统应用选项后，列表不进行对应更新的Bug 修正部分情况下设置窗口返回时不更新列表的Bug 修正一个可能导致出现未知行为的Bug 减小APK的大小 ``` - **0.2.28** ``` 打开实验性功能（全局禁用） ``` - **0.1.23** ``` 修正选项读取错误 ```
##问题 - 如使用过程中出现问题或功能建议，请至[此处](https://github.com/j2rong/HeadsOff/issues/new)提交。 - 如通知拦截出现问题，请在模块中打开日志，并将Xposed Installer中的日志提交至[此处](https://github.com/j2rong/HeadsOff/issues/new)。
##致谢 (Acknowledgements) - [**Xposed Framework**](https://github.com/rovo89/Xposed) Original work Copyright (c) 2005-2008, The Android Open Source Project Modified work Copyright (c) 2013, rovo89 and Tungstwenty Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
##English - An **Xposed** module for disabling [heads-up notifications](http://developer.android.com/guide/topics/ui/notifiers/notifications.html#Heads-up) per app on Android 5.0 and above, support white list.
- **Features** - Disable heads-up notifications posted by the selected apps; - Disable all heads-up - White list, notifications match the rules will not be filtered
- **Usage** - Install and enable the module in [Xposed Installer](https://github.com/rovo89/XposedInstaller), then reboot the phone - In **HeadsOff**, switch on the app you want to disable it's heads-up notifications - **HeadsOff** is **not enabled** by default, you need to go to "**Settings**"-"**Module Status**" to enable it
- **Changelog** - **0.5.78** ``` Make English as default language for non-Chinese speaking locale App list sorts by user's locale Improvements on white list: Add a notification example to demonstrate matching entries Add regular expression testing ``` - **0.4.62** ``` Bug fixes ``` - **0.4.56** ``` UI adjustment, no new features added ``` - **0.4.51** ``` Add a log switch White list, notifications match the rules will not be filtered Optimize efficiency ``` - **0.3.34** ``` Fix a bug that list does not update accordingly whether or not show system app is enabled Fix a bug that list does not refresh when return from settings Fix a bug that may cause unexpected behavior Reduce APK size ``` - **0.2.28** ``` Add experimental feature (disable all heads-up notifications) ```
- **Problems** Feel free to [open an issue](https://github.com/j2rong/HeadsOff/issues/new) if there is any problem or suggestion. If you are having problems of notifications filtering, you can turn on the logs and submit (you can find it in Xposed Installer) to help identify the issue.
## Contributing - Translations - Translations to other languages are welcomed - Check if the language is [supported by Android](http://stackoverflow.com/a/30028371/1680664) and find its locale - Translate the strings in string.xml ([Chinese](https://github.com/j2rong/HeadsOff/blob/master/app/src/main/res/values/strings.xml) or [English](https://github.com/j2rong/HeadsOff/blob/master/app/src/main/res/values-en/strings.xml)) and ignore all the strings with ***translatable="false"*** - If you don't know how to create a pull request, you can comment with your translation here [issue#2](https://github.com/j2rong/HeadsOff/issues/2) - If you know how to create a [pull request](https://help.github.com/articles/using-pull-requests/), create a locale folder (***value-xx...***) under [res](https://github.com/j2rong/HeadsOff/tree/master/app/src/main/res) and save your translation as ***string.xml*** in the folder
## License
Copyright (c) 2016-2017, j2Rong ​ Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at ​ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.