readme standardization

Author: ItsLemmy

bongocat/README.md

@@ -8,8 +8,6 @@ you type or when audio beats are detected.
 | Field | Value |
 | --- | --- |
 | ID | `noctalia/bongocat` |
-| Version | `1.1.1` |
-| Minimum Noctalia | `5.0.0` |
 | Entry | Bar widget: `cat` |
 
 ## Usage

example/README.md

@@ -9,8 +9,6 @@ shortcut.
 | Field | Value |
 | --- | --- |
 | ID | `noctalia/example` |
-| Version | `1.0.2` |
-| Minimum Noctalia | `5.0.0` |
 | Entries | Bar widget: `hello`; service: `ticker`; shortcut: `toggle` |
 
 ## Usage

example/plugin.toml

@@ -65,7 +65,7 @@ include_in_global_search = false
 # (panel.render). Demonstrates the interactive controls (toggle/slider/input/
 # select inside a scroll) and their value callbacks. Panel size is host-owned
 # and declared here, so the surface is sized right on the first open.
-# Open it with: noctalia ipc panel-toggle noctalia/example:panel
+# Open it with: noctalia msg panel-toggle noctalia/example:panel
 [[panel]]
 id = "panel"
 entry = "panel.luau"

kaomoji/README.md

@@ -3,6 +3,14 @@
 Browse and search kaomoji emoticons `(◍•ᴗ•◍)♡` from the Noctalia launcher and
 copy them to the clipboard.
 
+## Plugin
+
+| Field | Value |
+| --- | --- |
+| ID | `noctalia/kaomoji` |
+| Entry | Launcher provider: `kaomoji` |
+| Launcher Prefix | `/kao` |
+
 ## Usage
 
 Open the launcher and type `/kao`:
@@ -17,12 +25,13 @@ The category bar follows the launcher's global *Show categories* setting.
 
 ## Settings
 
-| Setting | Description |
-|---|---|
-| **Notify on copy** | Show a notification when a kaomoji is copied. Default on. |
+| Setting | Type | Default | Description |
+| --- | --- | --- | --- |
+| `notify_on_copy` | `bool` | `true` | Shows a notification when a kaomoji is copied. |
 
 ## Notes
 
-`database.json` is a curated subset of the upstream kaomoji catalogue. Each entry
-records a primary `category` (the labels declared in `plugin.toml`) plus tags for
-search, indexed so it decodes quickly inside the launcher.
+- `database.json` is a curated subset of the upstream kaomoji catalogue.
+- Each entry records a primary `category` that matches the labels declared in
+  `plugin.toml`, plus tags used for search.
+- The database is indexed so it decodes quickly inside the launcher.

mpvpaper/README.md

@@ -8,23 +8,46 @@ Noctalia does not decode video itself. This plugin runs `mpvpaper`, which draws
 outputs you assign a video to — so the video shows through, with the bar and dock still
 drawn above it.
 
+## Plugin
+
+| Field | Value |
+| --- | --- |
+| ID | `noctalia/mpvpaper` |
+| Entries | Service: `service`; Panel: `picker`; bar widget: `mpvpaper` |
+
 ## Requirements
 
-- `mpvpaper` (which pulls in `mpv`). `mpv` is also used to render the picker thumbnails.
+Install `mpvpaper` and `mpv` on `PATH`. `mpvpaper` renders the wallpaper
+surface, and `mpv` renders picker thumbnails.
 
 The plugin works on `wlr-layer-shell` compositors (Niri, Hyprland, Sway, Mango).
 
 ## Usage
 
 1. Set **Video directory** in the plugin settings (defaults to `~/Videos`).
 2. Add the **Video Wallpaper** bar widget, or open the picker with
-   `noctalia msg panel-toggle noctalia/mpvpaper:picker`.
+
+   ```sh
+   noctalia msg panel-toggle noctalia/mpvpaper:picker
+   ```
+
 3. Choose a target output (or **All outputs**), then click a video to apply it.
    Use **Stop** to restore Noctalia's own wallpaper on that output.
 
 Assignments persist across restarts. Supported files: `mp4`, `webm`, `mkv`, `mov`, `gif`.
 
-## How it works
+## Settings
+
+| Setting | Type | Default | Description |
+| --- | --- | --- | --- |
+| `video_directory` | `folder` | *(empty)* | Folder scanned for wallpaper videos; defaults to `~/Videos` when empty. |
+| `mute` | `bool` | `true` | Starts video wallpapers muted. |
+| `hardware_decode` | `bool` | `true` | Uses `mpv` hardware decoding. |
+| `auto_pause` | `bool` | `true` | Pauses playback while a fullscreen window covers the wallpaper. |
+| `mpv_options` | `string` | *(empty)* | Additional space-separated `mpv` options. |
+| `glyph` | `glyph` | `movie` | Bar widget icon. |
+
+## Notes
 
 A headless service supervises one long-lived helper process (`supervisor.sh`) that owns
 every `mpvpaper` instance, one per output. The picker panel and bar widget are thin

notes/README.md

@@ -9,6 +9,7 @@ directory you control — yours to sync, edit externally, and grep.
 | --- | --- |
 | ID | `noctalia/notes` |
 | Entries | Panel: `panel`; bar widget: `notes`; launcher provider: `launcher` |
+| Launcher Prefix | `/nt` |
 
 ## Usage
 

screen_recorder/README.md

@@ -9,8 +9,6 @@ Control Center.
 | Field | Value |
 | --- | --- |
 | ID | `noctalia/screen_recorder` |
-| Version | `1.1.9` |
-| Minimum Noctalia | `5.0.0` |
 | Entries | Service: `service`; bar widget: `recorder`; shortcut: `toggle` |
 
 ## Requirements

timer/README.md

@@ -8,8 +8,6 @@ progress display.
 | Field | Value |
 | --- | --- |
 | ID | `noctalia/timer` |
-| Version | `1.0.1` |
-| Minimum Noctalia | `5.0.0` |
 | Entry | Desktop widget: `timer` |
 
 ## Usage

translator/README.md

@@ -8,10 +8,8 @@ Translate and copies the selected result to the clipboard.
 | Field | Value |
 | --- | --- |
 | ID | `noctalia/translator` |
-| Version | `1.0.5` |
-| Minimum Noctalia | `5.0.0` |
 | Entry | Launcher provider: `translate` |
-| Prefix | `/tr` |
+| Launcher Prefix | `/tr` |
 
 ## Usage
 

wallhaven/README.md

@@ -7,8 +7,6 @@ Browse [Wallhaven](https://wallhaven.cc), download a wallpaper into your Noctali
 | Field | Value |
 | --- | --- |
 | ID | `noctalia/wallhaven` |
-| Version | `1.0.2` |
-| Minimum Noctalia | `5.0.0` |
 | Entries | Panel: `browser`; bar widget: `wallhaven` |
 
 ## Usage