k keyfreq checking local service

Local service not detected

Install keyfreq, then this page becomes your dashboard.

This public page reads the desktop service running on your own Ubuntu machine at 127.0.0.1:8788. If the service is installed and running on the selected port, your data appears here automatically. If it is not installed yet, follow the steps below.

Source package View source

Fast path on Ubuntu

The installer handles Python packages, the virtual environment, the user service, and autostart.

bash keyfreq-install-8788.sh

The configured installer downloads the package and installs the service on your selected port. You can also extract the source package and run ./install.sh 8788.

What the installer does

  • Installs common Ubuntu dependencies with apt when available.
  • Creates a Python virtual environment and installs Python requirements.
  • Enables keyfreq.service as a systemd user service.
  • Keeps the API bound to localhost so data is not exposed publicly.

If it still does not connect

systemctl --user status keyfreq.service
journalctl --user -u keyfreq -n 40 --no-pager

The most common first-install issue is needing one sign-out/sign-in after the installer adds keyboard-input permission.