A keys-per-second meter & counter. Written for osu! but should work for other rythm games too.
Clone or download
Latest commit 4124001 Dec 27, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
KeysPerSecond Version 8.1 Dec 27, 2018
.gitlab-ci.yml Update .gitlab-ci.yml Dec 24, 2018
CHANGELOG.md Version 8.1 Dec 27, 2018
LICENSE Update LICENSE Jul 13, 2017
README.md Version 8.1 Dec 27, 2018


Keys Per Second

KeysPerSecond is a program that counts how many times certain keys are pressed. And shows what the average, maximum and current number of keys pressed per second is. The program can also shows a nice graph of the key presses over time.
The program is also fully customizable.


Originally I wanted to know how many keys / second I pressed in osu! And I had already seen programs like this on live streams. I could however not find a program that worked well on my computer so I decided to write one myself.

The program when active looks like this:
Interface Interface
There is also a right click menu to configure all the settings:

For each configured key the program will show how many times it was pressed. By default it will also shows the maximum, average and current number of keys pressed per second. When enabled it can also show a graph of the number of keys pressed per second over time and total number of keys pressed.

Everything shown in the pictures above can be toggled on or off and all the panels can be arranged in a lot of different ways.
Config Key config

There are also some commands that can be sent to the program:
Ctrl + P: Causes the program to reset the average and maximum value.
Ctrl + U: Terminates the program.
Ctrl + I: Causes the program to reset the key press statistics.
Ctrl + Y: Shows / hides the GUI.
Ctrl + T: Pauses / resumes the counter.
Ctrl + R: Reloads the configuration file.

You can also move the program using the arrow keys or snap it to the edges of your screen.

Well I hope some of you find this program useful and/or will use it for your streams (I would love to see that happen :) ). And if you find any bugs feel free to report them.


  • The horizontal line in the graph represents the average number of keys pressed per second.
  • You can add any key, and any number of keys to the program.
  • You can also track mouse buttons with this program.
  • The overlay options is far form perfect it just ask the OS to place the program on top. It'll not overlay most full screen games.
  • To change a GUI colour in the colours menu, click on the current colour
  • An opacity of 100% means completely opaque and an opacity of 0% means completely transparent.
  • The snap to screen edge function works on multi-monitor setups.
  • You can move the window with the arrow keys at 3 different speeds 1, 2 & 3 pixels at a time (2=Ctrl, 3=Shift).
  • You can pass the path to the config file to load via the commandline or a shortcut so you can skip the configuration step. Setting the program as the default program to open the configuration file with may work as well as long as you don't move the executable afterwards.
  • When resetting something it will also be printed to the console if this program is run using cmd/shell.

Todo list / working on

It's kinda empty here right now :c, so please suggest things c:

Downloads (Java 8 required)

Supported operating systems: Mac (tested 10.11.6), Linux (tested Ubuntu 16.04 LTS) & Windows (tested 7, 8 & 10)
Windows executable
Runnable Java Archive

All releases: releases
GitHub repository: here
Original osu! forum post: post


The following two examples show the layout while it is being edited. All the panels have to line up with the grid, but the size of the grid cells can be changed.

Next are two other examples of possible layouts.

Last are some very simple layouts to highlight the title-value display options.




If you really like KeysPerSecond, you can consider making donation.


Project development started: 23 January 2017