Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AhmedSaadi0/NibrasShell/llms.txt

Use this file to discover all available pages before exploring further.

The Smart Capsule is a floating interactive element positioned at the top-centre of each monitor. It behaves like a macOS Dynamic Island: it starts compact, expands when you interact with it, and can morph into an AI overlay with animated eyes. Under the hood, it is a PanelWindow defined in windows/smart_capsule/ and assembled per monitor through shell.qml’s Variants loop.

Three modes

In idle mode, the capsule renders the IdleBar — a compact pill that shows either the current weather condition (temperature, icon) or a brief system status summary. It stays out of the way while still surfacing the information most relevant to the moment.

Internal components

ComponentRole
IdleBarCompact idle display (weather or system state).
ExpandedCardTwo-tab expanded view with weather and media panels.
AIEyesAnimated eye expressions that reflect AI activity.

Keyboard shortcuts

Two built-in shortcuts let you jump directly to a specific tab of the expanded view:
Shortcut actionEffect
toggleMediaIslandOpens the capsule and switches to the Media tab.
toggleWeatherIslandOpens the capsule and switches to the Weather tab.
Configure these shortcuts in your Hyprland keybindings using the IPC interface NibrasShell exposes.

AI integration

The Smart Capsule pulls from the same AI backend used by the AI Bot panel:
  • Weather summaries — Instead of raw forecast data, the capsule shows a concise natural-language summary generated by the AI (e.g., “Cool morning, carry a light jacket”).
  • Music comments — When a new track starts, the AI can generate a short contextual comment about the song or artist, displayed as a brief caption in the Media tab.
  • Dynamic colour gradients — The expanded capsule samples the current album art and applies a matching colour gradient to its background, creating a visually responsive media experience.
Use toggleMediaIsland in your Hyprland config as a global keybind so you can see what’s playing at a glance without moving your hands to the mouse.
AI-generated content in the capsule requires a working AI backend configured in the Settings App. If no backend is available, the capsule falls back to showing raw weather data and skips music comments.

Build docs developers (and LLMs) love