Install Notchex

About a minute. Notchex installs for your user only and never asks for sudo or admin rights.

On Windows? Go to the Windows guide.

Linux (GNOME)

Requirements

  • GNOME Shell 46, 47, 48, 49 or 50. Run gnome-shell --version to check.
  • Wayland or X11
  • Any distro with a supported GNOME version: Ubuntu, Fedora, Arch, Debian, openSUSE and others

Install

Choose one method. The one-line installer is the easiest.

  1. Run the installer It checks your GNOME version, downloads the latest release, installs it and turns it on.
    curl -fsSL https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.sh | bash
    Want to read it first? install.sh is short.
  2. Log out and log back in On X11 you can press Alt + F2, type r and press Enter instead.
Install a specific version
curl -fsSL https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.sh | bash -s -- --version v2.0.0

Other options: --zip FILE installs from a local zip, and --no-enable installs without turning it on.

After installing

The notch now sits at the top center of your main monitor in place of the clock. Try:

  • Hover over the notch, or press Super + N, to open the hub
  • Press Super + Space for Spotlight search
  • Play some music to see Now Playing in the notch
Only want some of it? Preferences opens on the Features page. Pick a preset (Everything, Notch only, Dock only or Look only), or switch the Notch, Dock, Spotlight and macOS look on or off one by one.

To open preferences, search "Notchex Settings" in Spotlight, use the Extensions app, or run:

gnome-extensions prefs notchex@adityatakuli

Avoid conflicts

Notchex already does what these extensions do. Running them together can cause visual glitches, like two docks:

gnome-extensions disable ubuntu-dock@ubuntu.com          # the Notchex Dock replaces it
gnome-extensions disable dash-to-dock@micxgx.gmail.com
gnome-extensions disable Vitals@CoreCoding.com           # covered by the System tab

Want to keep your current dock? Turn off the Notchex Dock on the Dock page in preferences instead.

Optional packages

Most systems already have these. If one is missing, only the feature that needs it turns off.

PackageUsed for
libsoup3 (gir1.2-soup-3.0)Weather, Tasks, Claude usage, macOS-style icons
libsecret (gir1.2-secret-1)Storing the macOSicons API key in the keyring
GStreamer + PulseAudio/PipeWire-Pulse pluginsAudio-reactive equalizer bars
evolution-data-serverCalendar events
Nautilus / TrackerFile results in Spotlight

Integrations

Google Calendar and Tasks

  1. Open Settings → Online Accounts and add your Google account.
  2. Make sure Calendar is switched on for that account.
  3. That's it. The Calendar and Tasks tabs find the account automatically, with no extra login.

Weather

On the Weather page in preferences, enter a city (Berlin), a district, coordinates (52.52,13.40) or an airport code (SFO). Leave it empty to detect your location automatically.

Claude Code usage

Install the Claude Code CLI and run claude once to sign in. The Limits tab then shows your session and weekly usage.

macOS-style icons

Get a free API key at macosicons.com, paste it on the Icons page and set Icon source to macOS-style. The key is stored in your GNOME keyring.

Update

Run the same one-line command again, then log out and back in:

curl -fsSL https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.sh | bash

From source: git pull && make install.

Uninstall

Using traffic-light window buttons? Turn them off in preferences before uninstalling, so your original button layout and gtk.css are restored.
curl -fsSL https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.sh | bash -s -- --uninstall

From a source checkout: gnome-extensions disable notchex@adityatakuli && make uninstall.

Troubleshooting

Notchex doesn't show up after installing

On Wayland you have to log out and back in. Then check that GNOME sees it:

gnome-extensions list | grep notchex
The installer says my GNOME version isn't supported

Notchex supports GNOME Shell 46 to 50. Check yours with gnome-shell --version. Older releases such as Ubuntu 22.04 (GNOME 42) aren't supported.

There are two docks

Disable Ubuntu Dock or Dash to Dock (see Avoid conflicts), or turn off the Notchex Dock on the Dock page.

Super + Space doesn't open Spotlight

If you have more than one keyboard layout, GNOME uses that shortcut to switch layouts. Pick a different Spotlight shortcut on the Search page.

The Calendar tab is empty

Make sure the Google account in Online Accounts has Calendar switched on. If it's still empty, log out and back in.

There's no GPU usage

GPU usage appears only on drivers that report it (AMD and some Intel). NVIDIA isn't shown, because reading it would mean running nvidia-smi every second.

Something else is wrong

Watch the logs while you reproduce the problem, then open an issue and paste the output:

journalctl -f -o cat /usr/bin/gnome-shell

Windows

Install on Windows

Notchex for Windows puts the same notch or pill at the top of your screen, with music, alerts and the hub. It installs for your user only, needs no admin rights, and the app never goes online.

  • Windows 10 version 2004 or later, or Windows 11
  • An x64 PC, or an Arm PC such as a Snapdragon laptop
  1. Open PowerShell Press Win + X and choose Terminal (or Windows PowerShell on Windows 10). It doesn't need to be the admin one.
  2. Run the installer It picks the right build for your PC (x64 or Arm64), checks it against the release's checksums, installs it to %LOCALAPPDATA%\Programs\Notchex and starts it.
    irm https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.ps1 | iex
    Want to read it first? install.ps1 is short.
Install a specific version, or install without starting
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.ps1))) -Version v3.0.0

-NoStart installs without starting Notchex.

After installing

Notchex adds Notchex and Notchex Settings to the Start menu and an icon to the tray. Try:

  • Hover over the notch, or press Ctrl + Alt + N, to open the hub
  • Scroll on the notch to change the volume
  • Right-click it to switch between notch and pill, choose how the top of the screen behaves, open settings, hide it or quit
  • Press Ctrl + Alt + , to open settings

Under Top of the screen in settings, choose Keep a bar (the default: a black bar the notch sits on, so maximized windows start below it), Auto-hide (the notch slides away until you push the pointer to the top edge) or Float (over windows).

To start Notchex every time you sign in, turn on Start Notchex when you sign in in settings. Settings are saved in %APPDATA%\Notchex\settings.json.

Update

Run the same one-line command again. It closes Notchex, puts the new version in place and starts it:

irm https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.ps1 | iex

Installed by downloading the app? Quit Notchex from its tray icon, download the new version into the same folder, run it and delete the old file.

Uninstall

This closes Notchex and removes the app, its Start menu shortcuts, the sign-in entry, your settings and the log:

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.ps1))) -Uninstall
Uninstall by hand
  1. In settings, turn off Start Notchex when you sign in.
  2. Quit Notchex from its tray icon.
  3. Delete the app file and these folders. You can paste each path into File Explorer's address bar:
    %LOCALAPPDATA%\Programs\Notchex
    %APPDATA%\Microsoft\Windows\Start Menu\Programs\Notchex
    %APPDATA%\Notchex
    %LOCALAPPDATA%\Notchex

Already deleted the app? Remove the Notchex value under HKCU\Software\Microsoft\Windows\CurrentVersion\Run in Registry Editor.

Troubleshooting

"Windows protected your PC" won't let me run it

Click More info, then Run anyway. If there's no Run anyway button, your organization may block unsigned apps.

The installer says it can't reach the release

Check your internet connection. On a work PC, a proxy or firewall may block GitHub; in that case use Download the app above instead.

The notch disappears

It hides itself while a game, video or presentation is full screen, and comes back afterwards. If you hid it from the menu, choose Show Notch on the tray icon.

My music doesn't show up

Notchex shows whatever appears in Windows' own media controls (the box that pops up when you press a media key). Spotify, browsers, Media Player and VLC all work. If your player isn't there, Notchex can't see it either.

Something else is wrong

Open an issue and attach %LOCALAPPDATA%\Notchex\notchex.log. It holds error details only, never song titles.