Oxygen Customizer is an open-source Android application aimed at providing users with the ability to tweak and customize various aspects of Oxygen OS UI.
Furthermore, the open-source nature of Oxygen Customizer encourages community contributions and continuous improvement, ensuring a dynamic and evolving user experience.
- Compatibility
- Requirements
- Release Variants
- Installation
- Permissions
- Contribution
- FAQ
- Credits
- License
- Disclaimer
- Donations
Caution
This app requires Magisk, KernelSU & APatch for root access and XPosed/LSPosed framework. Any alternative methods won't work.
Oxygen Customizer is compatible with OxygenOS/ColorOS/RUI 15, 14 and 13.
Warning
If you are using OOS15 based rom, please use at least beta versions.
-
Oxygen OS 15, 14 or 13 (check compatibility above)
The official LSPosed can be found here. Anyway this version is now only suitable for OxygenOS 14.
You can now use different variants:
- LSPosed IT (Internal Test),
- LSPosed Irena
- LSPosed JingMatrix
- ReLSPosed
For all of them you need Zygisk (especially on KSU). There are a lot of Zygisk modules available. If you choose to use LSPosed Internal Test, any version of Zygisk will work. If you choose to use LSPosed Irena, it's recommended to use Zygisk next. If you choose to use ReLSPosed, it's recommended to use ReZygisk.
OxygenOS 14: any LSPosed OxygenOS 15: LSPosed IT or LSPosed Irena 7280+ (Zygisk Next 534+) or ReLSPosed 7200+ OxygenOS 16: LSposed IT or LSPosed Irena 7280+ (Zygisk Next 534+) or ReLSPosed 7200+
This mod is released in three different variants:
If you are running OOS14 or OOS13 based rom.
More updated with fixes and new features, if you are using OOS15 based rom - consider to use nightly variant.
This variant is released on every push on this repo.
It can include various fixes or new feature that will came in beta and stable.
Warning
If you are using OOS15 .850+ you NEED to use LSPosed IT (Internal Test) or any version of LSPosed Irena 7280+ (recommended with Zygisk Next 534+) or ReLSPosed 7200+. Any Issue report with a different LSPosed version or incompatible software will be closed
- Download and install the Oxygen Customizer app.
-
Enable the Xposed module in LSPosed app.
-
Open the app, grant root permission and follow the instructions.
-
Wait for it to finish generating rom specific module.
-
Reboot the device when prompted.
-
Grant SuperSU/root permission for Oxygen Customizer & SystemUI from KernelSU app
-
Disable
Unmount modulesoption if it's available in the app. If you don't care about system detection, just enable OverlayFS or configure meta module. -
Open the app, wait for it to finish generating rom specific module.
-
Reboot the device when prompted.
If you are on KernelSU (or Next) 3.0+ you need meta-modules to mount modules because ksu doesn't mount modules. For OxygenOS is suggested Mountify, alternatively you can try Magic Mount.
Warning
Always download those module from official sources and ensure you are using latest build from actions page.
After flashing mountify you need a little setup. Open mountify Web UI and fill the following values:
mountify_mount = 2
mount_device_name = KSU
If you are using susfs 2.0.0+
mountify_custom_umount = 2
If you are using a lower version of susfs
mountify_custom_umount = 1
After configuration, reboot and continue with Oxygen Customizer installation.
Magic Mount doesn't require any additional configuration from user side.
This app requires the following permissions:
android.permission.ACCESS_NETWORK_STATE android.permission.INTERNET android.permission.ACCESS_FINE_LOCATION android.permission.ACCESS_COARSE_LOCATION android.permission.ACCESS_BACKGROUND_LOCATION
Permissions to access the internet and location are required for fetching weather data and location-based services. These permissions are essential for the proper functioning of the Lockscreen Weather and are not used for any other purposes.
android.permission.USE_BIOMETRIC
Permission to use biometric authentication is required for showing the Authentiation Prompt when enabled for Advanced Reboot Menu.
android.permission.VIBRATE
Permission to vibrate the device is required for haptic feedback when using the app.
android.permission.WRITE_EXTERNAL_STORAGE android.permission.READ_EXTERNAL_STORAGE android.permission.MANAGE_EXTERNAL_STORAGE
Permissions to read and write external storage are required for saving and loading custom images/fonts. These permissions are essential for the proper functioning of the app and are not used for any other purposes.
We highly appreciate and welcome all forms of contributions, ranging from code, documentation, graphics, design suggestions, to bug reports. We encourage you to make the most of GitHub's collaborative platform by submitting Pull Requests, providing tutorials or other relevant content. Whatever you have to offer, we value and can utilize it effectively in our project.
Do I need a root access for Oxygen Customizer to work?
- Yes, root access is required for Oxygen Customizer to function properly.
Which devices does Oxygen Customizer support?
- Oxygen Customizer exclusively supports Oxygen OS 14 and later versions. Compatibility with other devices or custom ROMs is not guaranteed.
Is Android version "xx" supported?
- Oxygen Customizer officially supports Android 14 and later versions. Compatibility with earlier Android versions is not provided, and there are no plans to introduce support for those versions.
I got bootloop. How do I fix it?
- Boot into Safe Mode and uninstall module.
What is the difference between Release build and Debug build?
- Release build is an optimized version intended for distribution to end-users, while Debug build includes additional features and information for debugging and development purposes.
Can I use Oxygen Customizer in conjunction with other customization apps?
- Yes, Oxygen Customizer can be used alongside other customization apps. However, it's important to note that conflicts or overlapping modifications may occur, which could affect the overall user experience.
I found a bug. How do I report it?
- Ensure that you are running latest nightly before creating a new Issue!
- To report a bug, please navigate to the Issues section. Create a new issue and ensure you select the
Bug Reporttemplate. Provide as much detailed information as possible, including steps to reproduce the bug and any relevant error messages or screenshots.
How do I request a new feature?
- If you have a feature request, please go to the Issues section. Create a new issue and choose the
Feature Requesttemplate. Be sure to include comprehensive details about the desired feature, its potential benefits, and any other relevant information that can assist in understanding and evaluating the request.
Where can I make a donation?
- You can donate via "PayPal", or via "Buy me a coffee".
- Android Open Source Project (AOSP) for Android source code.
- OnePlus for Oxygen OS.
- Material Icons for in-app icons.
- PixelXpert, @siavash79 for help with Xposed mods, and his great work with Pixel Xpert.
- Iconify, @Mahmud0808 for bringing the idea of Iconify and his great work.
- crDroid for Pulse Controller and some tweaks.
- OmniROM for the Weather Providers.
- Project Matrixx for some illustrations.
- SuperiorExtended for some tweaks and layouts.
- And everyone who contributed and translated... :)
Oxygen Customizer is licensed under GPLv3. Please see LICENSE for the full license text.
Warning
- Please note that Oxygen Customizer may not be fully compatible with all custom OOS variants.
- I cannot be held responsible for any potential damage or issues that may occur to your device while using Oxygen Customizer.
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}
