Core Task Optimizer

A native C++ Android root module for Magisk, KernelSU, and APatch that improves system responsiveness by applying precise CPU affinity, scheduler, and I/O priority policies to critical system tasks via direct Linux syscalls — with zero persistent overhead after the initial boot run.

---

Table of Contents

• Why This Module
• How It Works
• Optimization Targets
• Requirements
• Installation
• Verifying Operation
• Build from Source
• Project Structure
• Safety Notice
• Contributing
• License
• Acknowledgements

---

Why This Module

Most Android performance tweaks rely on shell scripts calling renice or writing to /proc sysfs entries. This introduces process spawn overhead, depends on userspace tooling availability, and applies policies at the process level rather than the thread level.

Core Task Optimizer takes a different approach:

• Native C++ binary — compiled per ABI, no shell interpreter overhead
• Direct syscalls — sched_setaffinity, sched_setscheduler, setpriority, ioprio_set called directly
• Thread-level precision — policies applied to every thread in /proc/<pid>/task, not just the parent process
• One-shot at boot — runs once after boot completion, then exits. No daemons, no polling loops, no persistent memory footprint
• Dynamic CPU topology detection — reads /sys/devices/system/cpu/cpu*/cpufreq/cpuinfo_max_freq at runtime to correctly identify performance and efficiency cores on any SoC

---

How It Works

Boot completed + 30s grace period
        │
        ▼
task_optimizer binary starts
        │
        ├─► Detect CPU topology (perf vs efficiency cores)
        │
        ├─► Scan /proc for matching process names
        │
        ├─► For each match: enumerate /proc/<pid>/task threads
        │
        ├─► Apply per-group policy to each thread ID
        │   ├── HIGH_PRIO  → nice -10, affinity → perf cores
        │   ├── RT_TASKS   → SCHED_FIFO prio 50, affinity → perf cores
        │   └── LOW_PRIO   → nice +5, affinity → eff cores, ioprio class 3
        │
        └─► Log results to /data/adb/modules/task_optimizer/logs/

The binary matches process names against entries in /proc/<pid>/comm using std::regex. All operations include retry logic (up to 3 attempts) to handle transient failures during the early boot window.

---

Optimization Targets

Group	Processes	Policy Applied
High Priority	servicemanager, zygote, system_server, surfaceflinger, kblockd, writeback, composer	nice -10, perf core affinity
Real-Time	kgsl_worker_thread, crtc_commit, crtc_event, pp_event, fts_wq, nvt_ts_work	SCHED_FIFO priority 50, perf core affinity
Background	f2fs_gc, wlan_logging_th	nice +5, efficiency core affinity, I/O priority class 3

---

Requirements

• Root manager: Magisk v20.4+, KernelSU v0.6.6+, or APatch
• Android: 8.0 (API 26) or higher recommended
• Architecture: ARM64 (arm64-v8a) preferred; armeabi-v7a, x86, x86_64 also supported

---

Installation

1. Download the latest CoreTaskOptimizer.zip from the Releases page
2. Open your root manager (Magisk / KernelSU / APatch)
3. Navigate to Modules → Install from storage
4. Select the downloaded zip and flash it
5. Reboot your device

The module runs automatically approximately 30 seconds after boot completes.

---

Verifying Operation

After the first reboot, check the main log to confirm the module ran successfully:

cat /data/adb/modules/task_optimizer/logs/main.log

A successful run ends with a summary line similar to:

[2025-01-01 12:00:30] Operations: 84 | Success: 81 | Failed: 3
[2025-01-01 12:00:30] === System Optimization Completed ===

If the binary encountered errors, check:

cat /data/adb/modules/task_optimizer/logs/error.log

Log files are automatically rotated at 1 MB to prevent unbounded growth.

---

Build from Source

Prerequisites

• Android NDK r26c or later
• CMake 3.18.1+
• Ninja

Building All ABIs

export ANDROID_NDK=/path/to/your/ndk
chmod +x build.sh
./build.sh all

Binaries are output to bin/<abi>/task_optimizer.

Building a Specific ABI

./build.sh arm64-v8a
./build.sh armeabi-v7a
./build.sh x86
./build.sh x86_64

Build Options

Variable	Default	Description
BUILD_TYPE	Release	Release or Debug
ANDROID_PLATFORM	android-21	Minimum Android API level
ANDROID_NDK	(required)	Path to NDK root directory

Release builds apply -O3 -flto -ffunction-sections -fdata-sections and strip the final binary.

---

Project Structure

CoreTaskOptimizer/
├── src/
│   └── main.cpp              # Core optimizer: topology, syscalls, process enumeration
├── common/
│   ├── functions.sh          # MMT Extended utility functions (modified)
│   └── install.sh            # Module install-time output
├── META-INF/
│   └── com/google/android/
│       ├── update-binary     # Magisk module entry point
│       └── updater-script    # Magisk marker
├── CMakeLists.txt            # Cross-compilation build definition
├── build.sh                  # Multi-ABI build script
├── customize.sh              # Magisk module customization hook
├── module.prop               # Module metadata
├── service.sh                # Boot service: waits for boot, runs binary
├── uninstall.sh              # Clean uninstall handler
└── update.json               # OTA update manifest

---

Safety Notice

This module modifies kernel scheduling parameters for running processes. While the changes are non-persistent and reset on reboot, please be aware of the following:

• Test on non-production devices first. Applying SCHED_FIFO to incorrect processes can cause system hangs.
• Some devices may behave unexpectedly. SoCs with custom scheduler patches (e.g., vendor-modified EAS) may not respond as expected to affinity changes.
• Root access required. This module will not install or function without a supported root manager.
• The module does not modify any system partitions. Uninstalling via your root manager fully removes all effects.

---

Contributing

Contributions are welcome. Please open an issue before submitting a pull request for non-trivial changes so the approach can be discussed first.

• Follow the existing code style (C++17, no exceptions in hot paths)
• Test on at least one physical device before submitting
• Update common/install.sh version strings when bumping the version

---

License

This project is licensed under the GNU General Public License v3.0. See LICENSE for the full text.

---

Acknowledgements

MMT Extended by Zackptg5 — the Magisk module framework used as the foundation for the installer scripts.

The Magisk, KernelSU, and APatch projects and their communities — for building and maintaining the root management ecosystem that makes modules like this possible.

---

❤️ Thank You

This project exists because of the incredible Android root community. Every bug report, star, share, and kind word genuinely means a lot and keeps this project alive and improving.

A special thank you to the Magisk, KernelSU, and APatch communities for building the foundation that makes modules like this possible, and to every user who trusted this module on their device.

If this module made your device feel even a little snappier, that is everything I could ask for. Your support, big or small, is what turns a side project into something worth maintaining.

With love and gratitude 🙏❤️

• c0d3h01