This folder contains auxiliary tools and scripts that might be helpful to developers working with Android applications.

The Android Memory Monitor is a command-line and web dashboard tool for continuous monitoring of an Android app's memory footprint and process state (OOM Score Adjustment) over time. The dashboard exports a text file with the OOM score change history and max memory usage per process when exiting the dashboard.

• Live Terminal Dashboard: View OOM scores, Process States, and memory footprints directly in the console.
• Web Dashboard: Access an interactive web interface (e.g., http://localhost:8080) featuring live memory trend charts, historical OOM logs, and the ability to save standalone HTML snapshots for sharing.

• Python 3.x installed on your host machine.
• ADB (Android Debug Bridge) installed and added to your PATH.
• An Android device connected via USB or Wi-Fi with USB Debugging enabled.

Run the script from your terminal, passing the target application's package name as an argument:

python3 android_mem_monitor.py <package_name>

Example:

python3 android_mem_monitor.py com.example.mygame

Options:

• --dump200: If specified, the script will automatically take a dumpsys activity snapshot whenever the OOM score hits 200 (Perceptible Background). This is particularly useful for debugging why an app isn't fully suspending.

python3 android_mem_monitor.py com.example.mygame --dump200