Linux (GNOME)
Requirements
- GNOME Shell 46, 47, 48, 49 or 50. Run
gnome-shell --versionto 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.
-
Run the installer
It checks your GNOME version, downloads the latest release, installs it and turns it on.
Want to read it first? install.sh is short.
curl -fsSL https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.sh | bash -
Log out and log back in
On X11 you can press Alt + F2, type
rand press Enter instead.
Install a specific version
curl -fsSL https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.sh | bash -s -- --version v2.0.0Other options: --zip FILE installs from a local zip, and --no-enable installs without turning it on.
-
Download the zip
Get
notchex@adityatakuli.shell-extension.zipfrom the latest release. -
Install it
gnome-extensions install --force notchex@adityatakuli.shell-extension.zip -
Log out and back in, then turn it on
gnome-extensions enable notchex@adityatakuli
-
Clone and install
You need
git,makeandglib-compile-schemas(part of GLib).git clone https://github.com/AdityaTakuli/Notchex.git cd Notchex make install -
Log out and back in, then turn it on
gnome-extensions enable notchex@adityatakuli
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
To open preferences, search "Notchex Settings" in Spotlight, use the Extensions app, or run:
gnome-extensions prefs notchex@adityatakuliAvoid 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 tabWant 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.
| Package | Used 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 plugins | Audio-reactive equalizer bars |
evolution-data-server | Calendar events |
| Nautilus / Tracker | File results in Spotlight |
Integrations
Google Calendar and Tasks
- Open Settings → Online Accounts and add your Google account.
- Make sure Calendar is switched on for that account.
- 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 | bashFrom source: git pull && make install.
Uninstall
gtk.css are restored.
curl -fsSL https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.sh | bash -s -- --uninstallFrom 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 notchexThe 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-shellWindows
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
- Open PowerShell Press Win + X and choose Terminal (or Windows PowerShell on Windows 10). It doesn't need to be the admin one.
-
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\Notchexand starts it.Want to read it first? install.ps1 is short.irm https://raw.githubusercontent.com/AdityaTakuli/Notchex/main/install.ps1 | iex
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.
-
Download the app
From the latest release, get
Notchex-…-win-x64.exe. On an Arm PC, getNotchex-…-win-arm64.exe. Not sure which you have? Open Settings → System → About and look at System type. -
Give it a permanent folder
Move the file somewhere it can stay, such as
Documents\Notchex. The Start menu shortcuts and the sign-in entry point to it. - Run it The app isn't signed yet, so Windows may say "Windows protected your PC". Click More info, then Run anyway.
Check the download
Each release has a SHA256SUMS file. In PowerShell, in the folder with the app, run this and compare the result with the matching line in SHA256SUMS:
Get-FileHash .\Notchex-3.1.0-win-x64.exeAfter 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 | iexInstalled 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))) -UninstallUninstall by hand
- In settings, turn off Start Notchex when you sign in.
- Quit Notchex from its tray icon.
- 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.