FPS Meter
3.6 · GitHub
More about this app
High-performance lightweight FPS monitoring overlay inspired by Samsung Perf Z for gaming and performance testing
FPS Meter
A high-performance, lightweight FPS monitoring tool for Android. This application provides real-time frame rate overlays inspired by Samsung Perf Z and MSI Afterburner Style (RTSS) telemetry, offering a clean monitoring experience for mobile gaming and performance testing.
Tip
Advertisement: Enjoying using my app? I have a new interesting app for you to try and it is also open source: RedirectGuard.
How It Works and Its Features
Note
Here is a high-level overview of how the application operates:
- FPS Measurement Providers:
- Choreographer (Default): Uses Android's
ChoreographerAPI to receive frame callbacks, measuring elapsed time to calculate real-time frames per second (FPS). Frame time (MS) is derived directly from this rate. - SurfaceFlinger (Game FPS via Shizuku): Connects to Android's compositor via privileged Shizuku shell commands to measure real game frame presentation buffers from active
SurfaceViewbuffer queues.
- Choreographer (Default): Uses Android's
- Automatic Graphics API Detection: Automatically detects whether the foreground game is rendering with Vulkan or OpenGL ES (tested on games such as Genshin Impact and Wuthering Waves) using system GPU telemetry (
dumpsys gpuanddumpsys gfxinfo), adapting the measurement method accordingly. - Hardware & Battery Telemetry:
- Battery Temperature, Level & Power Output (
BAT): Uses a dynamicBroadcastReceiverforIntent.ACTION_BATTERY_CHANGEDto monitor real-time battery temperature, charge percentage (BAT xx%), and live power in watts alongside current in milliamperes (e.g.BAT 38°C (85%) -2.4W (-600mA)). - SoC, CPU & GPU Temps (
SOC,CPU,GPU): Queries Android's Thermal HAL (dumpsys thermalservice) and Linux sysfs thermal zones (cpu-*-usr,gpuss-*-usr) via Shizuku privileged shell access to monitor accurate live silicon hotspot, individual CPU core, and GPU temperatures during gaming across Qualcomm Snapdragon and MediaTek platforms.
- Battery Temperature, Level & Power Output (
- Customizable Overlay Styles: Switch between the default compact pill and the multi-row MSI Afterburner Style (RTSS) telemetry layout featuring real-time processor model, clock frequencies, and color-coded hardware sensors.
- Adaptive Dynamic Layout: Automatically presents a clean single-line pill when 1 to 3 metrics are enabled, and organizes into a structured two-line layout (Line 1: Performance metrics, Line 2: Temperatures) when 4 or more metrics are active.
- Material 3 Navigation & Dedicated Screens: Modern navigation featuring Overlay settings, Games manager with 1-tap game launching, and dedicated FPS session History with per-app launcher icons.
- Universal Auto-Record & Per-Game Recording: Choose between universal automated session recording for all active games or per-app configuration, aggregating average, min, and max FPS and duration with zero sample-by-sample disk overhead.
- Floating Assistive Bubble & Quick Menu: Provides an optional draggable floating on-screen bubble (
FloatingToggleButton) that expands into a quick HUD menu to start/stop game FPS recording, toggle overlay visibility, and return to the app from inside any active game. - Start on Boot: Automatically launch the overlay when your device finishes powering on, configurable under Settings.
- Quick Settings Panel Tile: Exposes an Android
TileService(FpsTileService) that allows 1-tap toggling of the FPS overlay directly from the notification pull-down shade without opening the main app. - Auto On/Off Game Detection: An optional
AccessibilityService(FpsAccessibilityService) monitors foreground window state changes to automatically activate the overlay when designated target games/apps launch and stop when exited. Turning off auto-start automatically stops the service when Shizuku is granted. - Interaction & Dragging: Tracks touch gestures using an
OnTouchListenerto support real-time dragging. The updated layout coordinates are saved inSharedPreferenceson gesture completion to persist the custom location. - Shizuku Integration: Provides privileged shell operations to grant overlay permissions without manual settings navigation, and to sample SurfaceFlinger compositor buffers for actual game FPS.
Download
Note
Important Notes:
- The F-Droid build is signed with F-Droid's official keys instead of mine. If you want to switch to the F-Droid build, you must first uninstall your existing version from GitHub.
- Updates on F-Droid usually take longer to publish because of their build queue. You do not need to switch if you prefer faster updates directly from GitHub releases.
Visit the Official Website & Showcase to explore interactive features, test screenshots, and view full release changelogs. You can also navigate directly to the Releases page to download the latest APK, install via F-Droid, join the Telegram Channel (@fpsmeterandroid) for instant release APK updates, or install and receive automated updates via ShizuStore. For troubleshooting installation issues (Google Play Protect) or Android 13+ permission restrictions, check out the Troubleshooting and Setup Guide.
Screenshots
Application Interface
| Meter & Telemetry | Games & Auto-Recording | Performance History Logs | Application Settings |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
Tip
You can customize the interface appearance under App Theme in Settings. Choose between Follow System, Dark, and Light modes, toggle pure black for AMOLED displays, or enable Dynamic Color to adapt UI accents to your device wallpaper.
Overlay Styles
| Overlay Style Setting | MSI Afterburner Style (RTSS) Telemetry Overlay |
|---|---|
![]() |
![]() |
In-Game Performance Testing
OpenGL ES [GL] |
Vulkan [VK] |
|---|---|
![]() |
![]() |
Requirements
- Android 8.0+ (API 26)
- Overlay Permission (SYSTEM_ALERT_WINDOW)
- Shizuku (optional, required for SurfaceFlinger real game FPS mode)
For details on known Android system behaviors and non-root hardware limitations, see Known Issues and Limitations.
Developer
Built by Romel (@rdevz-ph)
- Portfolio: https://romel-portfolio.vercel.app/
Privacy Policy
FPS Meter Android operates completely offline. It does not collect, monitor, or transmit any personal data. You can read the full policy at Privacy Policy.
Contributing
Contributions are always welcome. Check out our Contributing Guide to get started.
If you are interested in translating FPS Meter to your language, take a look at our Translation Guide and Template.
License
This project is licensed under the MIT License.
How Shizuku is used
Can measure true game FPS, detect games and graphics API, show chip temperatures, grant overlay and detection access and show diagnostics via `dumpsys`, `appops`, `settings` and `getprop`
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Shizuku runs privileged shell commands that power true game measurement, game and graphics detection, temperature telemetry, one tap system permission grants and diagnostics.
- Measure true game FPS: shows the actual rendering frame rate of the foreground game in the overlay by sampling compositor frame data with
dumpsys SurfaceFlinger --latency,dumpsys SurfaceFlinger --timestatsanddumpsys SurfaceFlinger --listthrough Shizuku. - Detect active game: identifies which game is in the foreground for FPS labeling and recording by checking focused and resumed activities with
dumpsys windowanddumpsys activity activitiesthrough Shizuku. - Detect graphics API: shows whether the active game uses Vulkan or OpenGL by inspecting GPU state with
dumpsys gpuanddumpsys gfxinfothrough Shizuku. - Monitor chip temperatures: shows live SoC, CPU and GPU temperatures in the overlay by querying system thermal sources with
dumpsys thermalserviceand thermal zone reads through Shizuku. - Grant overlay permission: enables the floating FPS overlay with one tap by allowing the overlay permission with
appops setthrough Shizuku. - Enable detection access: turns the app detection service on, off and restarts it with one tap by writing the enabled services list with
settings putthrough Shizuku. - Reset stuck detection: recovers a stuck detection service by clearing its enabled entry and force stopping the app with
settings putplusam force-stopthrough Shizuku. - Show device diagnostics: shows chip model, platform, compositor graphics details and thermal readings on the diagnostics screen with
getprop,dumpsys SurfaceFlingeranddumpsys thermalservicethrough Shizuku.
Android APIs or commands used
dumpsys SurfaceFlinger --latencydumpsys SurfaceFlinger --timestats -clear -enabledumpsys SurfaceFlinger --timestats -dumpdumpsys SurfaceFlinger --timestats -disabledumpsys SurfaceFlinger --listdumpsys SurfaceFlingerdumpsys windowdumpsys activity activitiesdumpsys gpudumpsys gfxinfodumpsys thermalservicecat /sys/class/thermal/thermal_zone*/typecat /sys/class/thermal/thermal_zone*/tempappops setgetprop ro.soc.modelgetprop ro.board.platformsettings put secure enabled_accessibility_servicessettings put secure accessibility_enabledsettings get secure enabled_accessibility_servicesam force-stop
Notable details
Without Shizuku the app falls back to a basic display based FPS meter and uses accessibility detection for the foreground app, while true game FPS and temperature readings require Shizuku. When Shizuku is not ready, the reset action opens the system App Info screen for manual force stop instead.
Changelog
What's new for version 3.6
FPS Meter Android v3.6
What's Changed
- Added Swap (Virtual RAM) overlay toggle under the RAM Overlays section with usage percentage and GB or MB unit formatting (#53)
- Fixed root mode detection and switch lockout on KernelSU and APatch by inspecting mounts and requesting root execution directly
- Extended Device Diagnostics to show the active operating mode (Root vs Shizuku), detected root manager, su binary location, and version for easier debugging
For the complete release history, see CHANGELOG.md. For known Android system behaviors and limitations, see KNOWN_ISSUES_AND_LIMITATIONS.md.
Features
- Choice between Choreographer and SurfaceFlinger FPS measurement providers
- Automatic Graphics API detection (Vulkan and OpenGL ES)
- Two overlay styles: default compact pill and multi-row MSI Afterburner Style (RTSS) telemetry layout
- Samsung-style pill-shaped overlay with cyan labels and white values
- Real-time FPS, frame time (MS), RAM usage, battery power (watts and current), and multi-metric temperature monitoring (CPU, GPU, SoC, and Battery)
- Adaptive layout dynamically scaling across lines, with a single-line mode option for tablets and landscape gaming
- Dynamic FPS color coding (green, yellow, orange, red) based on performance thresholds
- In-memory per-game FPS session recording with dedicated History screen
- Interactive floating assistive bubble with in-game quick control menu
- Six preset positions (top/bottom left/center/right) with manual drag support
- Light and dark mode themes
- Multi-language support (English and Simplified Chinese) with in-app language switcher
- Adjustable text size and overlay opacity
- Optional Root Mode and Shizuku integration for one-tap permission grant, SurfaceFlinger game FPS, and hardware thermal monitoring
- Quick Settings status bar tile and automated game detection via Accessibility Service
Requirements
- Android 8.0+ (API 26)
- Overlay Permission (SYSTEM_ALERT_WINDOW)
- Shizuku or Root (optional, required for SurfaceFlinger real game FPS and SoC temperature monitoring)
Installation & Setup Guides
Download the APK from the assets below and enable the "Display over other apps" permission when prompted.
Note
Which APK should I download?
- Release APK (
FPS-Meter-*-release.apk) [Recommended]: Signed with the developer's official release key. Use this build if you want seamless in-place updates from GitHub in the future without needing to reinstall. - Debug APK (
FPS-Meter-*-debug.apk): Signed with the default Android/Google SDK debug key generated by automated CI builds. Useful for quick testing, but switching to a release build in the future will require uninstalling first due to Android's signature verification.
If you encounter Play Protect installation blocks or Android 13+ restricted settings warnings when enabling features like Accessibility Service or Shizuku, follow the Troubleshooting and Setup Guide.
Permissions
8 permissions requested
Sources
14 sources
Sources
14 sources











