ShizuStore

FPS Meter

rdevz-ph

3.6 · GitHub

Download APK
Development utilities Android 8.0+ 1 day ago MIT
1.4k ShizuStore
13.5k GitHub
55 Stars
1 MB Size

More about this app

High-performance lightweight FPS monitoring overlay inspired by Samsung Perf Z for gaming and performance testing

FPS Meter Icon

FPS Meter

Release Build CI API Kotlin License Version Downloads Telegram F-Droid Website Privacy Policy

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 Choreographer API 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 SurfaceView buffer queues.
  • 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 gpu and dumpsys gfxinfo), adapting the measurement method accordingly.
  • Hardware & Battery Telemetry:
    • Battery Temperature, Level & Power Output (BAT): Uses a dynamic BroadcastReceiver for Intent.ACTION_BATTERY_CHANGED to 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.
  • 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 OnTouchListener to support real-time dragging. The updated layout coordinates are saved in SharedPreferences on 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

Get it on GitHub    Get it on F-Droid    Get it on Telegram    Get it on ShizuStore

Note

Important Notes:

  1. 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.
  2. 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
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
Overlay Style Setting MSI Afterburner Style (RTSS) Telemetry Overlay

In-Game Performance Testing

OpenGL ES [GL] Vulkan [VK]
OpenGL ES Test Vulkan Test

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)

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.

Close

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 --timestats and dumpsys SurfaceFlinger --list through Shizuku.
  • Detect active game: identifies which game is in the foreground for FPS labeling and recording by checking focused and resumed activities with dumpsys window and dumpsys activity activities through Shizuku.
  • Detect graphics API: shows whether the active game uses Vulkan or OpenGL by inspecting GPU state with dumpsys gpu and dumpsys gfxinfo through Shizuku.
  • Monitor chip temperatures: shows live SoC, CPU and GPU temperatures in the overlay by querying system thermal sources with dumpsys thermalservice and thermal zone reads through Shizuku.
  • Grant overlay permission: enables the floating FPS overlay with one tap by allowing the overlay permission with appops set through 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 put through Shizuku.
  • Reset stuck detection: recovers a stuck detection service by clearing its enabled entry and force stopping the app with settings put plus am force-stop through Shizuku.
  • Show device diagnostics: shows chip model, platform, compositor graphics details and thermal readings on the diagnostics screen with getprop, dumpsys SurfaceFlinger and dumpsys thermalservice through Shizuku.

Android APIs or commands used

  • dumpsys SurfaceFlinger --latency
  • dumpsys SurfaceFlinger --timestats -clear -enable
  • dumpsys SurfaceFlinger --timestats -dump
  • dumpsys SurfaceFlinger --timestats -disable
  • dumpsys SurfaceFlinger --list
  • dumpsys SurfaceFlinger
  • dumpsys window
  • dumpsys activity activities
  • dumpsys gpu
  • dumpsys gfxinfo
  • dumpsys thermalservice
  • cat /sys/class/thermal/thermal_zone*/type
  • cat /sys/class/thermal/thermal_zone*/temp
  • appops set
  • getprop ro.soc.model
  • getprop ro.board.platform
  • settings put secure enabled_accessibility_services
  • settings put secure accessibility_enabled
  • settings get secure enabled_accessibility_services
  • am 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.

Close

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.

Close

Permissions

8 permissions requested

  • android.permission.SYSTEM_ALERT_WINDOW
  • android.permission.FOREGROUND_SERVICE
  • android.permission.FOREGROUND_SERVICE_SPECIAL_USE
  • moe.shizuku.api.permission.SHIZUKU
  • android.permission.POST_NOTIFICATIONS
  • android.permission.RECEIVE_BOOT_COMPLETED
  • com.rdevzph.fpsmeter.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
  • moe.shizuku.manager.permission.API_V23
Close

Sources

14 sources

3.6 Universal GitHub · com.rdevzph.fpsmeter
Selected Download
3.3 Universal F-Droid · com.rdevzph.fpsmeter · com.rdevzph.fpsmeter
Download
3.0 Universal GitHub · com.rdevzph.fpsmeter
Download
2.9-hotfix Universal GitHub · com.rdevzph.fpsmeter
Download
2.9 Universal GitHub · com.rdevzph.fpsmeter
Download
2.8 Universal GitHub · com.rdevzph.fpsmeter
Download
2.7 Universal GitHub · com.rdevzph.fpsmeter
Download
2.6 Universal GitHub · com.rdevzph.fpsmeter
Download
2.5 Universal GitHub · com.rdevzph.fpsmeter
Download
2.4 Universal GitHub · com.rdevzph.fpsmeter
Download
2.3 Universal GitHub · com.rdevzph.fpsmeter
Download
2.2 GitHub · com.rdevzph.fpsmeter
Download
2.1 GitHub · com.rdevzph.fpsmeter
Download
2.0 GitHub · com.rdevzph.fpsmeter
Download