Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/DHD2280/Oxygen-Customizer

Customize Oxygen OS
https://github.com/DHD2280/Oxygen-Customizer

Last synced: 6 days ago
JSON representation

Customize Oxygen OS

Lists

README 

        
# Oxygen Customizer





  banner





  Release

  Beta

  Repo Size

  Nightly Build

  Support Group

  Update Channel






### Free and Open-Source Oxygen OS Customizer Application







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.




## Table of Contents



- [Requirements](#-requirements)

- [Installation](#-installation)

- [Permissions](#-permissions)

- [Contribution](#-contribution)

- [FAQ](#-faq)

- [Credits](#-credits)



> [!CAUTION]

> 

> This app requires Magisk or KernelSU for root access and Xposed framework. Any alternative methods won't work.



# 🛠 Requirements



- Oxygen OS 14



- [Magisk](https://github.com/topjohnwu/Magisk) (Recommended) or [KernelSU](https://github.com/tiann/KernelSU) or [APatch](https://github.com/bmax121/APatch)



- [LSPosed](https://github.com/LSPosed/LSPosed)



# 👨‍💻 Installation



  1. Download and install Oxygen Customizer app.



  2. Enable app in LSPosed.

  

  3. Restart your device.



# 🔒 Permissions



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.



# 🤝 Contribution



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.



# 🤓 FAQ



  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](https://www.androidauthority.com/how-to-enter-safe-mode-android-801476/) and uninstall module.



  What is the difference between Release build and Debug build?



- [Release build](https://github.com/DHD2280/Oxygen-Customizer/releases/latest) is an optimized version intended for distribution to end-users, while [Debug build](https://github.com/DHD2280/Oxygen-Customizer/actions) 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?



- To report a bug, please navigate to the [Issues](https://github.com/DHD2280/Oxygen-Customizer/issues/new/choose) section. Create a new issue and ensure you select the `Bug Report` template. 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](https://github.com/DHD2280/Oxygen-Customizer/issues/new/choose) section. Create a new issue and choose the `Feature Request` template. 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?



- The preferred and designated means for donating to the project's developer is via "[PayPal](https://www.paypal.me/luigifale)".



# ❤ Credits



### Thanks to:



- [Android Open Source Project (AOSP)](https://source.android.com) for Android source code.

- [OnePlus](https://www.oneplus.com) for Oxygen OS.

- [Material Icons](https://fonts.google.com/icons) for in-app icons.

- [PixelXpert](https://github.com/siavash79/PixelXpert), [@siavash79](https://github.com/siavash79) for help with Xposed mods, and his great work with Pixel Xpert.

- [Iconify](https://github.com/Mahmud0808/Iconify), [@Mahmud0808](https://github.com/Mahmud0808) for bringing the idea of Iconify and his great work. 

- [crDroid](https://github.com/crdroidandroid) for Pulse Controller and some tweaks.

- [OmniROM](https://github.com/omnirom) for the Weather Providers.

- [Project Matrixx](https://github.com/ProjectMatrixx) for some illustrations.

- [SuperiorExtended](https://github.com/SuperiorExtended) for some tweaks and layouts.

- And everyone who [contributed](https://github.com/DHD2280/Oxygen-Customizer/graphs/contributors) and [translated](https://crowdin.com/project/oxygen-customizer/members)... :)



# © License



Oxygen Customizer is licensed under GPLv3. Please see [`LICENSE`](./LICENSE.md) for the full license text.



# 📝 Disclaimer



> [!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.