godot-mobile-perf-doctor 0.1.0

Static mobile performance diagnostics for Godot 4 projects.

Godot Mobile Perf Doctor

Static mobile performance diagnostics for Godot 4 projects, with optional parsing of captured adb summary text.

The first release deliberately starts with static checks so it works in CI without an Android device.

Install

python -m pip install -e .

When published:

python -m pip install godot-mobile-perf-doctor

Quick Start

godot-mobile-perf-doctor C:\Projects\MyGame --static
godot-mobile-perf-doctor . --profile portrait-2d --format json --output perf-report.json
godot-mobile-perf-doctor . --adb-summary adb-summary.txt --format markdown --output mobile-perf-report.md

What It Checks

• Renderer setting and mobile risk.
• Base viewport size.
• Stretch mode presence.
• PNG texture dimensions and estimated RGBA memory.
• Optional adb summary text for device model and janky frame counts.

Documentation

• Static checks
• Renderer guidance
• Texture guidance
• ADB summaries
• Rule reference
• CI usage

Development

python -m pip install -e .
python -m unittest discover -s tests -v
godot-mobile-perf-doctor examples\tiny-godot-project --static --fail-on none

Examples are generic and safe to publish.