ShizuStore

akiHz

anlaki-py

0.0.55 · GitHub

Download APK
Display management Android 11+ 1 week ago MIT
1.5k ShizuStore
31.4k GitHub
34 Stars
3 MB Size

More about this app

Lightweight refresh rate switcher with Quick Settings tile, automatic rate detection, and floating FPS monitor

akiHz app icon

akiHz

Android refresh-rate controls and FPS monitoring (FOSS)

akiHz (pronounced "akiHertz") is an open-source Android app for switching display refresh rates and monitoring app FPS. It uses Shizuku, with no root required.

Choose your refresh rates, switch them from Quick Settings, and track FPS in a floating counter with an optional graph. Material 3 Expressive controls, app themes, and pill settings let you choose how it looks.

License: MIT Android 11+ Latest release Downloads Last commit Ko-fi Shizuku required


Download

Download the latest APK from the akiHz website or GitHub Releases. Most modern phones use the arm64-v8a APK; choose the universal APK if you are unsure which architecture your device uses.

Requirements

  • Shizuku installed, running, and authorized
  • A display that supports more than one refresh rate for rate switching
  • No root access required

Supported Android versions

akiHz supports Android 11 and newer (API 30+) and currently targets API 36.

Screenshots

Home Settings
Home screen Settings screen
FPS overlay Quick Settings tiles
FPS overlay Quick Settings tiles

Features

  • Refresh-rate controls on Home, with a choice of which rates the Quick Settings tile cycles through.
  • A draggable FPS counter with an optional graph, app or layer selection, and saved appearance settings.
  • Material 3 Expressive styling, wallpaper colors, preset and custom themes, and optional custom fonts.
  • Stable and beta update channels, scheduled checks, and in-app APK downloads.
  • Background controls, manufacturer overrides, custom refresh-rate keys, and exportable diagnostic logs.

FPS monitoring

The overlay shows app FPS reported by SurfaceFlinger. A 120 Hz screen can still show a 30 FPS game. akiHz reads TimeStats through Shizuku about twice per second; static screens can report 0 FPS.

Open Settings → FPS Monitor → Surface FPS Monitor, or use the FPS Monitor Quick Settings tile. Grant Shizuku, overlay, and notification permissions when asked. Drag the pill to move it; tap anywhere on it to open its menu.

The app's FPS page and the pill menu share these controls. Changes are saved and stay in sync:

Controls Options
Counter Size, FPS label, decimals, and compact spacing
Font Follow the app font or use the system font for the pill only
Graph Show or hide history, choose 10, 30, or 60 seconds, and adjust width and height
Surface App theme or a fixed color, background opacity, shadow, outline, and corner radius

The graph resets when the measured app or layer changes. Gaps in sampling are left visible. You can select a target app from the FPS page or choose a measured layer from the pill menu.

The method has been tested on Xiaomi 12T with Android 15 and HyperOS 2. Results can vary by device. Full notes are in the Gist Real-Time FPS Monitoring with SurfaceFlinger TimeStats on Android 15 / HyperOS 2.

Appearance

Choose System, Light, or Dark mode under Settings → Appearance. Open Theme for the rest:

  • Match your wallpaper with dynamic color, or choose and edit color schemes.
  • Use pitch-black backgrounds in dark mode with the AMOLED option.
  • Use the Material app icon or switch back to the original icon.
  • Use Cute Dino titles and Soft Core descriptions, or restore the default fonts.

Quick Settings tile text follows the app font setting. The FPS overlay and its menu follow the app theme; the pill also has its own font and color choices.

Updates and release notes

Under Settings → Updates, choose Stable or Beta and check for updates manually or on a daily, three-day, or weekly schedule. The app can download an APK and verify its SHA-256 checksum before offering installation.

Hold the version row in Settings to read release notes or browse the bundled changelog offline.

Supported devices

I have only tested akiHz on my Xiaomi phone. The app includes support for several other manufacturers and many other devices should work, but none are tested or guaranteed.

If auto-detection fails, try Settings → Refresh rate → OEM override and select your manufacturer manually.

Install

Each release provides standalone APKs for arm64-v8a, armeabi-v7a, x86, and x86_64, plus a universal APK. Most modern phones use arm64-v8a; use universal if you are unsure.

Releases from main are stable. Releases from beta are marked as GitHub prereleases. Both channels use the same application ID and signing key, and monotonically increasing version codes, so a newer beta can update an installed stable release without uninstalling it.

GitHub release assets use predictable names and include SHA-256 checksums and a machine-readable release-metadata.json file for release indexers and Android update clients. The metadata includes canonical project and release links, release date, Shizuku requirement, APK download URLs, and the signing certificate fingerprint shared by every APK variant.

See CHANGELOG.md for the complete release history.

Usage

  1. Open Shizuku and start it with wireless debugging or ADB.
  2. Open akiHz and grant Shizuku permission. Grant notification and overlay permission when asked.
  3. Select a refresh rate on Home. Use the tile buttons beside rates to choose which ones the akiHz Quick Settings tile cycles through.
  4. Open Settings → FPS Monitor → Surface FPS Monitor to start monitoring and customize the counter, graph, and surface. The FPS Monitor tile also starts and stops monitoring.
  5. Under Settings → Background, enable Keep alive notification if you want the refresh-rate controls kept ready. Use Allow background running to request a battery-optimization exemption.

FAQ

Why does Shizuku need to be running?
Android blocks normal apps from changing refresh-rate settings directly. Shizuku grants akiHz the privileged access needed to update the correct OEM-specific keys.

Does the Quick Settings tile work when the app is closed?
Yes. With Keep alive notification enabled, akiHz uses a foreground service to keep its Quick Settings controls ready. Android displays a persistent notification while it runs. If your device still restricts it, use Settings → Background → Allow background running to request a battery-optimization exemption.

My phone is not switching rates correctly? What should I try?

  1. Confirm Shizuku is running and akiHz has permission.
  2. Try Settings → Refresh rate → OEM override and pick your manufacturer.
  3. If it still does not work, fork the project and investigate support for your device.

Is akiHz safe?
The app is MIT-licensed and open source. Refresh-rate controls write system settings through Shizuku. FPS monitoring reads SurfaceFlinger data and uses overlay permission to display the counter. Review the source to assess its behavior on your device.

Contributions and support

This project does not provide support and is not accepting bug reports or feature requests. You are welcome to fork it and make your own changes.

More projects by the developer are available at anlaki.dev.

Error reports

Tap the version row six times to unlock Debug options, then open Error logs. Use Copy debug report to copy recent errors and theme events, or Share all logs to send every saved report in one text file.

Release builds save app warnings, errors, caught exceptions, and crashes. Android process exit records are collected on the next launch, including available ANR traces. An activity closing without a process crash may only leave lifecycle events. Storage keeps the latest 100 errors, 30 crashes, 30 exits, and two small event logs.

Build

Build the universal debug APK:

./gradlew :app:packageDebugUniversalApk

The APK is written to app/build/outputs/apk_from_bundle/debug/app-debug-universal.apk.

License

MIT

Project status and disclaimer

This is a personal app I vibe-coded to solve a problem I had. It is provided as is, with no promise of quality, reliability, compatibility, maintenance, support, or future updates. Development may slow down or stop permanently at any time and without notice. Donations through Ko-fi help keep maintenance going and make it less likely the project gets abandoned. They do not buy support or guaranteed updates.

Please treat this repository as something to download and use at your own risk, or fork and maintain yourself. Do not open issues asking for support, bug fixes, device compatibility, features, or updates. If the app does not work for you, you will need to diagnose and fix it yourself.

To the fullest extent permitted by law, I accept no responsibility or liability for any damage, data loss, device problems, security issues, or other consequences resulting from installing, using, modifying, or relying on this app.

Root access

Rooted devices can use akiHz without Shizuku. Open Settings > Access method and choose Root or Shizuku, even when both are available. Approve the permission prompt to switch. If access is denied, the current method stays selected. The app saves your choice and reconnects the screen after switching. Root access must stay granted in your root manager.

Close

How Shizuku is used

Can switch refresh rates, use custom profiles, show floating FPS and inspect processes via `settings`, `dumpsys`, `ps`, `cat` and `kill` through Shizuku

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

akiHz uses Shizuku to change protected display settings and to read frame and process state for its monitors.

  • Switch refresh rate: the rate chosen in the app or Quick Settings tile is applied with the settings put command through Shizuku, the current rate is read with settings get, and reset restores automatic mode with settings delete and settings put.
  • Use custom rate profiles: user selected keys are discovered by listing settings with the settings list command through Shizuku, tested and applied with settings put, read with settings get, and restored with settings put or settings delete.
  • Show floating FPS monitor: the overlay finds the foreground app with dumpsys window and dumpsys activity activities through Shizuku and measures frames with dumpsys SurfaceFlinger --timestats commands through Shizuku.
  • Record performance diagnostics: the performance log lists app processes with ps and reads memory and CPU state from proc files with cat through Shizuku, and cleans up stale helper processes with kill.

Android APIs or commands used

  • settings get
  • settings put
  • settings delete
  • settings list
  • dumpsys window
  • dumpsys activity activities
  • dumpsys SurfaceFlinger --timestats -clear -enable
  • dumpsys SurfaceFlinger --timestats -dump -clear -maxlayers 64
  • dumpsys SurfaceFlinger --timestats -disable
  • ps -A -o PID,ARGS
  • cat /proc//status
  • cat /proc//cmdline
  • cat /proc//stat
  • kill -9

Notable details

App updates download with the system download service and open in the normal package installer, which works without Shizuku. Performance sampling prefers Shizuku shell reads but falls back to direct app reads when unbound.

Close

Changelog

What's new for version 0.0.55

Added

  • Added root access as an alternative to Shizuku.
  • Added an access method selector in Settings.

Changed

  • Moved the access method selector to the bottom of Settings, below About.
  • Added a key icon to the access method option.
  • Skip background cleanup when disconnected to avoid repeated error logs.

Full changelog

Close

Permissions

12 permissions requested

  • android.permission.SYSTEM_ALERT_WINDOW
  • android.permission.FOREGROUND_SERVICE
  • android.permission.FOREGROUND_SERVICE_SPECIAL_USE
  • android.permission.POST_NOTIFICATIONS
  • android.permission.INTERNET
  • android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS
  • android.permission.REQUEST_INSTALL_PACKAGES
  • android.permission.WAKE_LOCK
  • android.permission.ACCESS_NETWORK_STATE
  • android.permission.RECEIVE_BOOT_COMPLETED
  • akihz.anlaki.dev.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
  • moe.shizuku.manager.permission.API_V23
Close

Sources

5 sources

0.0.55 Universal GitHub · akihz.anlaki.dev
Selected Download
0.0.55 arm64-v8a GitHub · akihz.anlaki.dev
Download
0.0.55 armeabi-v7a GitHub · akihz.anlaki.dev
Download
0.0.55 x86 GitHub · akihz.anlaki.dev
Download
0.0.55 x86_64 GitHub · akihz.anlaki.dev
Download