GNOME Whoop Info is a lightweight GNOME Shell extension that connects to your WHOOP account and displays your most important daily health metrics directly in the top bar of your GNOME desktop.
Whether you're monitoring your recovery, sleep and strain, this extension gives you a quick and unobtrusive glance at your status—without having to check your phone.
Before the extension can display your WHOOP data, you must authenticate your account and generate the required access tokens.
Please make sure to carefully follow the Installation Guide below to connect your WHOOP account successfully.
Once set up, the extension runs in the background and updates your data automatically throughout the day.
To use this extension, you'll first need to create a WHOOP developer application and obtain the necessary credentials.
-
Visit the WHOOP Developer Portal.
-
Log in with your WHOOP account.
-
Click “Create an App” and fill out the form as follows:
Field Value App Name GNOME Contact Email your@email.com Privacy Policy https://whoop.com Redirect URI http://localhost:8000/callbackScopes Select all available scopes Webhook URL (Leave empty) -
After creating the app, you’ll receive your Client ID and Client Secret.
To authenticate the extension:
-
Open a terminal and navigate to the extension folder:
cd ~/.local/share/gnome-shell/extensions/whoop-info@juanmag.dev
-
Run the authentication script:
./whoopAuth.sh -
When prompted:
- Enter your Client ID and Client Secret.
- A URL will be shown. Open it in your browser and log in with your WHOOP account.
- After authorization, copy the full redirected URL and paste it into the terminal when asked.
If successful, a tokens.json file will be generated containing your access and refresh tokens.
To activate the extension, restart GNOME Shell. You should now see your WHOOP metrics displayed in the top bar of your GNOME desktop.