diff --git a/UltraBoostEngine/.github/workflows/android_build.yml b/.github/workflows/android_build.yml similarity index 100% rename from UltraBoostEngine/.github/workflows/android_build.yml rename to .github/workflows/android_build.yml diff --git a/.gitignore b/.gitignore index 0a3cb1c..67fd0e0 100644 --- a/.gitignore +++ b/.gitignore @@ -4,37 +4,107 @@ *.aar *.dex *.so -*.jar # Gradle .gradle/ build/ -intermediates/ -outputs/ +app/build/ # Local configuration file (sdk path, etc) local.properties -# Android Studio -.idea/ -*.iml -*.iws -out/ +# Log Files +*.log -# Generated files -gen/ -bin/ -obj/ +# Android Studio Navigation editor temp files +.navigation/ -# Log files -*.log +# External native build folder generated in Android Studio 2.2 and later +.externalNativeBuild -# Environment -.env -.env.local -.env.* +# Compressed data +*.zip +*.gz +*.tar +*.tgz +*.bz2 +*.xz +*.7z +*.rar +*.zst +*.lz4 +*.lzh +*.cab +*.arj +*.rpm +*.deb +*.Z +*.lz +*.lzo +*.tar.gz +*.tar.bz2 +*.tar.xz +*.tar.zst -# OS generated files +# IDE files +.vscode/ +.idea/ +*.swp +*.swo +*.tmp + +# System files .DS_Store Thumbs.db + +# Environment files +.env +.env.local +*.env.* + +# Coverage reports +coverage/ +htmlcov/ +.coverage + +# Python cache +__pycache__/ +*.pyc +*.pyo +*.pyd +.Python +.pytest_cache/ + +# Node.js +node_modules/ +npm-debug.log* +yarn-debug.log* +yarn-error.log* + +# Virtual environments +venv/ +.venv/ +env/ +ENV/ + +# MyPy cache +.mypy_cache/ + +# Gradle cache +.gradle/ + +# Compiled binary files +*.class +*.o +*.a +*.obj +*.out +*.exe +*.dll +*.so +*.dylib +*.jar +*.war +*.ear + ``` \ No newline at end of file diff --git a/README.md b/README.md index 5779bb3..d49c5f9 100644 --- a/README.md +++ b/README.md @@ -1 +1,178 @@ -# Fpsmonster \ No newline at end of file +# UltraBoost Engine 🚀 + +**Professional Android Gaming Performance Optimizer** + +UltraBoost Engine is a smart adaptive performance engine designed to improve gaming smoothness, frame stability, multitasking performance, and responsiveness during heavy Android gaming scenarios. + +## ⚠️ Important Philosophy + +This application: +- ✅ Prioritizes **stable frametimes** over fake FPS claims +- ✅ Uses **safe optimization** within Android's security limitations +- ✅ **Never disables thermal safety systems** +- ✅ **Never forces dangerous overclocking** +- ✅ **Never kills important Android system processes** +- ✅ Respects Android security restrictions +- ✅ Uses **adaptive optimization** instead of aggressive unsafe methods + +## 🎯 Core Objectives + +- Reduce stutters and micro-stutters +- Improve frametime stability +- Improve touch responsiveness +- Reduce recording lag +- Improve multitasking performance +- Improve frame consistency during PvP +- Reduce heavy frame spikes +- Improve smoothness under Discord + screen recording + Minecraft Java scenarios + +## 🎮 Features + +### Adaptive Optimization Modes +- **Balanced Mode** - Safe optimization with stable thermals +- **Gaming Mode** - Aggressive frame stabilization, lower latency +- **Recording Mode** - Optimized for screen recording + Discord voice chat +- **PvP Mode** - Ultra-low latency for competitive play +- **Extreme Mode** - Maximum safe optimization + +### Key Modules +1. **App Detection Engine** - Detects selected app launch and monitors foreground processes +2. **Native Performance Engine (C++/JNI)** - Frame pacing stabilizer, CPU thread balancing +3. **Thermal Monitoring System** - Monitors temperature and reduces intensity when overheating +4. **Recorder & Voice Chat Optimization** - Balances workload during multitasking +5. **Smart Overlay UI** - Real-time FPS, temperature, and stats display +6. **Performance Profiles** - Custom profiles for different scenarios + +### Minecraft Java Companion +- Detects PojavLauncher and MojoLauncher +- Suggests adaptive render distance +- Recommends optimized settings for recording + +## 🏗️ Architecture + +``` +app/src/main/ +├── java/com/ultraboost/engine/ +│ ├── ui/ # Activities and UI components +│ ├── service/ # Foreground services (Optimization, Overlay) +│ ├── optimization/ # Optimization modes and state +│ ├── jni/ # JNI bridge to native engine +│ ├── monitoring/ # Thermal, Memory, Performance monitors +│ ├── detection/ # App detection engine +│ ├── settings/ # Settings management +│ └── utils/ # Utility classes +├── cpp/ # Native C++ performance engine +│ ├── native_engine.cpp # Main native optimization code +│ └── CMakeLists.txt # Native build configuration +└── res/ # Resources (layouts, colors, strings) +``` + +## 🛠️ Technical Stack + +### Android Layer +- Kotlin +- Android Studio +- Foreground Services +- Usage Stats API +- Notifications API +- View Binding + +### Native Layer +- C++ +- Android NDK +- JNI +- CMake + +## 📱 Requirements + +- **Minimum SDK:** Android 11 (API 30) +- **Target SDK:** Android 14 (API 34) +- **NDK:** Required for native optimization engine + +## 🔧 Build Instructions + +### Prerequisites +1. Android Studio Arctic Fox or newer +2. Android NDK installed +3. CMake installed + +### Building + +```bash +# Clone the repository +git clone https://github.com/yourusername/UltraBoostEngine.git +cd UltraBoostEngine + +# Build Debug APK +./gradlew assembleDebug + +# Build Release APK +./gradlew assembleRelease +``` + +### Using GitHub Actions +The project includes a workflow file that automatically builds APKs on push: +- Debug APK uploaded as artifact +- Release APK created on version tags + +## 📄 Permissions + +UltraBoost Engine uses only necessary permissions: +- `FOREGROUND_SERVICE` - For persistent optimization +- `PACKAGE_USAGE_STATS` - For app detection +- `POST_NOTIFICATIONS` - For status updates +- `SYSTEM_ALERT_WINDOW` - For in-game overlay +- `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` - For reliable background operation + +## ⚡ Safety Features + +1. **Thermal Protection** - Automatically reduces optimization when device gets hot +2. **Adaptive Intensity** - Adjusts based on temperature and memory pressure +3. **Safe Limits** - Never exceeds safe operating parameters +4. **No Root Required** - Works within Android's standard security model + +## 🎨 UI Design + +- Dark futuristic theme with neon gaming style +- Smooth transitions and animations +- Circular performance meters +- Live statistics dashboard +- Glassmorphism effects + +## 📝 Disclaimer + +This application does NOT: +- Claim impossible FPS multiplication +- Force dangerous overclocking +- Disable thermal protection +- Kill critical Android processes +- Damage hardware +- Cause bootloops +- Use fake RAM cleaner logic + +## 🔮 Future Expandability + +Architecture supports future additions: +- Launcher plugins +- Fabric companion mods +- Vulkan/OpenGL monitoring +- Shizuku integration +- Optional root enhancements +- AI adaptive optimization +- Advanced statistics system + +## 📄 License + +See LICENSE file for details. + +## 🤝 Contributing + +Contributions are welcome! Please ensure any changes: +- Follow the safety-first philosophy +- Don't introduce dangerous optimizations +- Maintain code quality standards +- Include appropriate documentation + +--- + +**Made with ❤️ for the Android gaming community** diff --git a/UltraBoostEngine/README.md b/UltraBoostEngine/README.md deleted file mode 100644 index d49c5f9..0000000 --- a/UltraBoostEngine/README.md +++ /dev/null @@ -1,178 +0,0 @@ -# UltraBoost Engine 🚀 - -**Professional Android Gaming Performance Optimizer** - -UltraBoost Engine is a smart adaptive performance engine designed to improve gaming smoothness, frame stability, multitasking performance, and responsiveness during heavy Android gaming scenarios. - -## ⚠️ Important Philosophy - -This application: -- ✅ Prioritizes **stable frametimes** over fake FPS claims -- ✅ Uses **safe optimization** within Android's security limitations -- ✅ **Never disables thermal safety systems** -- ✅ **Never forces dangerous overclocking** -- ✅ **Never kills important Android system processes** -- ✅ Respects Android security restrictions -- ✅ Uses **adaptive optimization** instead of aggressive unsafe methods - -## 🎯 Core Objectives - -- Reduce stutters and micro-stutters -- Improve frametime stability -- Improve touch responsiveness -- Reduce recording lag -- Improve multitasking performance -- Improve frame consistency during PvP -- Reduce heavy frame spikes -- Improve smoothness under Discord + screen recording + Minecraft Java scenarios - -## 🎮 Features - -### Adaptive Optimization Modes -- **Balanced Mode** - Safe optimization with stable thermals -- **Gaming Mode** - Aggressive frame stabilization, lower latency -- **Recording Mode** - Optimized for screen recording + Discord voice chat -- **PvP Mode** - Ultra-low latency for competitive play -- **Extreme Mode** - Maximum safe optimization - -### Key Modules -1. **App Detection Engine** - Detects selected app launch and monitors foreground processes -2. **Native Performance Engine (C++/JNI)** - Frame pacing stabilizer, CPU thread balancing -3. **Thermal Monitoring System** - Monitors temperature and reduces intensity when overheating -4. **Recorder & Voice Chat Optimization** - Balances workload during multitasking -5. **Smart Overlay UI** - Real-time FPS, temperature, and stats display -6. **Performance Profiles** - Custom profiles for different scenarios - -### Minecraft Java Companion -- Detects PojavLauncher and MojoLauncher -- Suggests adaptive render distance -- Recommends optimized settings for recording - -## 🏗️ Architecture - -``` -app/src/main/ -├── java/com/ultraboost/engine/ -│ ├── ui/ # Activities and UI components -│ ├── service/ # Foreground services (Optimization, Overlay) -│ ├── optimization/ # Optimization modes and state -│ ├── jni/ # JNI bridge to native engine -│ ├── monitoring/ # Thermal, Memory, Performance monitors -│ ├── detection/ # App detection engine -│ ├── settings/ # Settings management -│ └── utils/ # Utility classes -├── cpp/ # Native C++ performance engine -│ ├── native_engine.cpp # Main native optimization code -│ └── CMakeLists.txt # Native build configuration -└── res/ # Resources (layouts, colors, strings) -``` - -## 🛠️ Technical Stack - -### Android Layer -- Kotlin -- Android Studio -- Foreground Services -- Usage Stats API -- Notifications API -- View Binding - -### Native Layer -- C++ -- Android NDK -- JNI -- CMake - -## 📱 Requirements - -- **Minimum SDK:** Android 11 (API 30) -- **Target SDK:** Android 14 (API 34) -- **NDK:** Required for native optimization engine - -## 🔧 Build Instructions - -### Prerequisites -1. Android Studio Arctic Fox or newer -2. Android NDK installed -3. CMake installed - -### Building - -```bash -# Clone the repository -git clone https://github.com/yourusername/UltraBoostEngine.git -cd UltraBoostEngine - -# Build Debug APK -./gradlew assembleDebug - -# Build Release APK -./gradlew assembleRelease -``` - -### Using GitHub Actions -The project includes a workflow file that automatically builds APKs on push: -- Debug APK uploaded as artifact -- Release APK created on version tags - -## 📄 Permissions - -UltraBoost Engine uses only necessary permissions: -- `FOREGROUND_SERVICE` - For persistent optimization -- `PACKAGE_USAGE_STATS` - For app detection -- `POST_NOTIFICATIONS` - For status updates -- `SYSTEM_ALERT_WINDOW` - For in-game overlay -- `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` - For reliable background operation - -## ⚡ Safety Features - -1. **Thermal Protection** - Automatically reduces optimization when device gets hot -2. **Adaptive Intensity** - Adjusts based on temperature and memory pressure -3. **Safe Limits** - Never exceeds safe operating parameters -4. **No Root Required** - Works within Android's standard security model - -## 🎨 UI Design - -- Dark futuristic theme with neon gaming style -- Smooth transitions and animations -- Circular performance meters -- Live statistics dashboard -- Glassmorphism effects - -## 📝 Disclaimer - -This application does NOT: -- Claim impossible FPS multiplication -- Force dangerous overclocking -- Disable thermal protection -- Kill critical Android processes -- Damage hardware -- Cause bootloops -- Use fake RAM cleaner logic - -## 🔮 Future Expandability - -Architecture supports future additions: -- Launcher plugins -- Fabric companion mods -- Vulkan/OpenGL monitoring -- Shizuku integration -- Optional root enhancements -- AI adaptive optimization -- Advanced statistics system - -## 📄 License - -See LICENSE file for details. - -## 🤝 Contributing - -Contributions are welcome! Please ensure any changes: -- Follow the safety-first philosophy -- Don't introduce dangerous optimizations -- Maintain code quality standards -- Include appropriate documentation - ---- - -**Made with ❤️ for the Android gaming community** diff --git a/UltraBoostEngine/app/build.gradle.kts b/app/build.gradle.kts similarity index 100% rename from UltraBoostEngine/app/build.gradle.kts rename to app/build.gradle.kts diff --git a/UltraBoostEngine/app/proguard-rules.pro b/app/proguard-rules.pro similarity index 100% rename from UltraBoostEngine/app/proguard-rules.pro rename to app/proguard-rules.pro diff --git a/UltraBoostEngine/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml similarity index 100% rename from UltraBoostEngine/app/src/main/AndroidManifest.xml rename to app/src/main/AndroidManifest.xml diff --git a/UltraBoostEngine/app/src/main/cpp/CMakeLists.txt b/app/src/main/cpp/CMakeLists.txt similarity index 100% rename from UltraBoostEngine/app/src/main/cpp/CMakeLists.txt rename to app/src/main/cpp/CMakeLists.txt diff --git a/UltraBoostEngine/app/src/main/cpp/native_engine.cpp b/app/src/main/cpp/native_engine.cpp similarity index 100% rename from UltraBoostEngine/app/src/main/cpp/native_engine.cpp rename to app/src/main/cpp/native_engine.cpp diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/UltraBoostApplication.kt b/app/src/main/java/com/ultraboost/engine/UltraBoostApplication.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/UltraBoostApplication.kt rename to app/src/main/java/com/ultraboost/engine/UltraBoostApplication.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/detection/AppDetectionEngine.kt b/app/src/main/java/com/ultraboost/engine/detection/AppDetectionEngine.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/detection/AppDetectionEngine.kt rename to app/src/main/java/com/ultraboost/engine/detection/AppDetectionEngine.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/jni/NativeEngineBridge.kt b/app/src/main/java/com/ultraboost/engine/jni/NativeEngineBridge.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/jni/NativeEngineBridge.kt rename to app/src/main/java/com/ultraboost/engine/jni/NativeEngineBridge.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/monitoring/ThermalMonitor.kt b/app/src/main/java/com/ultraboost/engine/monitoring/ThermalMonitor.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/monitoring/ThermalMonitor.kt rename to app/src/main/java/com/ultraboost/engine/monitoring/ThermalMonitor.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/optimization/OptimizationMode.kt b/app/src/main/java/com/ultraboost/engine/optimization/OptimizationMode.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/optimization/OptimizationMode.kt rename to app/src/main/java/com/ultraboost/engine/optimization/OptimizationMode.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/optimization/OptimizationState.kt b/app/src/main/java/com/ultraboost/engine/optimization/OptimizationState.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/optimization/OptimizationState.kt rename to app/src/main/java/com/ultraboost/engine/optimization/OptimizationState.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/service/OptimizationService.kt b/app/src/main/java/com/ultraboost/engine/service/OptimizationService.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/service/OptimizationService.kt rename to app/src/main/java/com/ultraboost/engine/service/OptimizationService.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/service/OverlayService.kt b/app/src/main/java/com/ultraboost/engine/service/OverlayService.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/service/OverlayService.kt rename to app/src/main/java/com/ultraboost/engine/service/OverlayService.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/AppListAdapter.kt b/app/src/main/java/com/ultraboost/engine/ui/AppListAdapter.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/AppListAdapter.kt rename to app/src/main/java/com/ultraboost/engine/ui/AppListAdapter.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/AppSelectionActivity.kt b/app/src/main/java/com/ultraboost/engine/ui/AppSelectionActivity.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/AppSelectionActivity.kt rename to app/src/main/java/com/ultraboost/engine/ui/AppSelectionActivity.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/MainActivity.kt b/app/src/main/java/com/ultraboost/engine/ui/MainActivity.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/MainActivity.kt rename to app/src/main/java/com/ultraboost/engine/ui/MainActivity.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/ProfileActivity.kt b/app/src/main/java/com/ultraboost/engine/ui/ProfileActivity.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/ProfileActivity.kt rename to app/src/main/java/com/ultraboost/engine/ui/ProfileActivity.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/SettingsActivity.kt b/app/src/main/java/com/ultraboost/engine/ui/SettingsActivity.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/ui/SettingsActivity.kt rename to app/src/main/java/com/ultraboost/engine/ui/SettingsActivity.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/utils/BootReceiver.kt b/app/src/main/java/com/ultraboost/engine/utils/BootReceiver.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/utils/BootReceiver.kt rename to app/src/main/java/com/ultraboost/engine/utils/BootReceiver.kt diff --git a/UltraBoostEngine/app/src/main/java/com/ultraboost/engine/utils/PreferenceManager.kt b/app/src/main/java/com/ultraboost/engine/utils/PreferenceManager.kt similarity index 100% rename from UltraBoostEngine/app/src/main/java/com/ultraboost/engine/utils/PreferenceManager.kt rename to app/src/main/java/com/ultraboost/engine/utils/PreferenceManager.kt diff --git a/UltraBoostEngine/app/src/main/res/drawable/boost_button_bg.xml b/app/src/main/res/drawable/boost_button_bg.xml similarity index 100% rename from UltraBoostEngine/app/src/main/res/drawable/boost_button_bg.xml rename to app/src/main/res/drawable/boost_button_bg.xml diff --git a/UltraBoostEngine/app/src/main/res/drawable/overlay_background.xml b/app/src/main/res/drawable/overlay_background.xml similarity index 100% rename from UltraBoostEngine/app/src/main/res/drawable/overlay_background.xml rename to app/src/main/res/drawable/overlay_background.xml diff --git a/UltraBoostEngine/app/src/main/res/layout/activity_app_selection.xml b/app/src/main/res/layout/activity_app_selection.xml similarity index 100% rename from UltraBoostEngine/app/src/main/res/layout/activity_app_selection.xml rename to app/src/main/res/layout/activity_app_selection.xml diff --git a/UltraBoostEngine/app/src/main/res/layout/activity_main.xml b/app/src/main/res/layout/activity_main.xml similarity index 100% rename from UltraBoostEngine/app/src/main/res/layout/activity_main.xml rename to app/src/main/res/layout/activity_main.xml diff --git a/UltraBoostEngine/app/src/main/res/layout/item_app.xml b/app/src/main/res/layout/item_app.xml similarity index 100% rename from UltraBoostEngine/app/src/main/res/layout/item_app.xml rename to app/src/main/res/layout/item_app.xml diff --git a/UltraBoostEngine/app/src/main/res/layout/overlay_performance.xml b/app/src/main/res/layout/overlay_performance.xml similarity index 100% rename from UltraBoostEngine/app/src/main/res/layout/overlay_performance.xml rename to app/src/main/res/layout/overlay_performance.xml diff --git a/UltraBoostEngine/app/src/main/res/values/colors.xml b/app/src/main/res/values/colors.xml similarity index 100% rename from UltraBoostEngine/app/src/main/res/values/colors.xml rename to app/src/main/res/values/colors.xml diff --git a/UltraBoostEngine/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml similarity index 100% rename from UltraBoostEngine/app/src/main/res/values/strings.xml rename to app/src/main/res/values/strings.xml diff --git a/UltraBoostEngine/app/src/main/res/values/themes.xml b/app/src/main/res/values/themes.xml similarity index 100% rename from UltraBoostEngine/app/src/main/res/values/themes.xml rename to app/src/main/res/values/themes.xml diff --git a/UltraBoostEngine/build.gradle.kts b/build.gradle.kts similarity index 100% rename from UltraBoostEngine/build.gradle.kts rename to build.gradle.kts diff --git a/UltraBoostEngine/gradle.properties b/gradle.properties similarity index 100% rename from UltraBoostEngine/gradle.properties rename to gradle.properties diff --git a/UltraBoostEngine/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties similarity index 100% rename from UltraBoostEngine/gradle/wrapper/gradle-wrapper.properties rename to gradle/wrapper/gradle-wrapper.properties diff --git a/UltraBoostEngine/settings.gradle.kts b/settings.gradle.kts similarity index 100% rename from UltraBoostEngine/settings.gradle.kts rename to settings.gradle.kts