gitwtfhub

wtf is notched?

taqsblaze/notched — explained in plain English

Analysis updated 2026-05-18

0QMLAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

A floating, animated Dynamic Island style notch widget for the KDE Plasma 6 desktop, showing battery, network, media, and notifications.

Mindmap

mindmap
  root((notched))
    What it does
      Floating top screen notch UI
      Hover expand and drag reposition
      Live status and notifications
    Tech stack
      QML
      KDE Plasma Frameworks
    Use cases
      Show battery and network status at a glance
      Control media playback via MPRIS
      Display live KDE notifications
    Audience
      KDE Plasma users
      Linux desktop customizers
    Concepts
      Dynamic Island inspired design
      Plasma applet packaging
      Configurable opacity and toggles

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Add a floating, animated status hub to the top of a KDE Plasma 6 desktop.

REASON 2

Control and view media playback from any MPRIS compatible player without switching apps.

REASON 3

See battery and network status and incoming notifications in one floating panel.

What's in the stack?

QMLKDE Plasma Frameworks

How it stacks up

taqsblaze/notcheddylanrothhuck/quickshellpatrickelectric/dock
Stars011
LanguageQMLQMLQML
Last pushed2017-12-26
MaintenanceDormant
Setup difficultyeasyhardhard
Complexity2/54/51/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires KDE Plasma 6 and the kpackagetool6 installer, not usable outside the KDE Plasma desktop.

GPL version 3 or later: free to use and modify, but shared or distributed changes must stay under the same license.

Wtf does this do

Notched is a small widget for the KDE Plasma 6 desktop environment on Linux that adds a floating, pill shaped panel at the top center of the screen, inspired by the Dynamic Island feature seen on some phones. Instead of a plain notification bar, this widget turns that area into an animated hub that shows live information and reacts as you interact with it. Hovering over the notch expands it, and you can drag it to a different spot on the screen if you do not want it centered. It shows your battery status and network connection, and connects to whatever music or video player you are using through a standard Linux media control protocol called MPRIS, so you can see and control playback right from the notch. It also taps into KDE's own notification system, so incoming notifications appear inside the notch and switch it into a dedicated notification view while they are active. A basic settings page lets you turn each of these features on or off individually, battery, media, network, and notifications, and also lets you adjust how see through the notch's background is. Visually, the widget deliberately skips Plasma's usual gray applet background so it can stand out as its own floating shape. The project is still under active development. The core shell of the widget and several of its live data sources already work, and the author is continuing to build it out toward a fuller system hub. To install it, you clone the repository and use KDE's own plasmoid installer tool to add it as a Plasma applet, and the same tool can upgrade or remove it later. It is built entirely with QML and the KDE Plasma frameworks, with no other external dependencies mentioned, and it is released under the GPL version 3 or later license.

Yoink these prompts

Prompt 1
Show me how to install this Plasma applet using kpackagetool6.
Prompt 2
Explain what each QML file in contents/ui does, like Notch.qml and Media.qml.
Prompt 3
Help me toggle off the network and battery features in the config page.
Prompt 4
How does the notch switch into notification mode when a new alert arrives?

Frequently asked questions

wtf is notched?

A floating, animated Dynamic Island style notch widget for the KDE Plasma 6 desktop, showing battery, network, media, and notifications.

What language is notched written in?

Mainly QML. The stack also includes QML, KDE Plasma Frameworks.

What license does notched use?

GPL version 3 or later: free to use and modify, but shared or distributed changes must stay under the same license.

How hard is notched to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is notched for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.