Every Material setting

Every option in Settings, page by page, read from the family’s code each time this site is built. In Settings, Ctrl+F finds any of them and takes you there.

Home

Wallpaper & Colors

• Wallpaper color strength: Controls how vivid wallpaper-derived accent colors are. 100% keeps the default balance; higher values produce richer accents.
• Transparency: Might look ass. Unsupported.
• Colors only: Use any thumbnail as the theme source while keeping the current wallpaper
• Per-monitor wallpapers
• Backdrop
• No wallpaper set
• Change
• Random: Set a random wallpaper from the current folder for this monitor
• Reset: Reset this monitor to use the global wallpaper
• Apply to all: Apply the global wallpaper to all monitors
• Change backdrop: Change the backdrop wallpaper (used for overview/blur)
• Derive theme colors from backdrop
• %1 monitors detected

Quick select

• Current folder: Switch to the folder containing the current wallpaper
• Selector: Open the full wallpaper selector overlay
• Selecting backdrop wallpaper: Quick wallpaper thumbnails are loaded on demand.
• Load quick grid
• No images found

Bar position

• Top
• Left
• Bottom
• Right

Bar style

• Hug
• Float
• Rect
• Card

Screen round corner

• Yes
• When not fullscreen

Wallpaper mode

• Normal
• Backdrop only

Game Mode

• Auto-detect fullscreen: Automatically enable Game Mode when apps go fullscreen
• Disable animations: Turn off UI animations when Game Mode is active
• Disable effects: Turn off blur and shadows when Game Mode is active
• Disable audio visualizers: Stop Cava and hide audio visualizers while Game Mode is active
• Disable Niri animations: Turn off compositor animations when Game Mode is active
• Disable Discover overlay: Stop discover-overlay while Game Mode is active
• Minimal mode: Make panels transparent and hide backgrounds for maximum performance
• Suppress notifications: Hide notification popups while Game Mode is active

Recordings

• Open folder
• Change folder

Screenshots

• Open folder
• Change folder

App filters

• Notifications: iNiR learns senders from notification history. Block an app here and it is rejected before history, sound, counters and popups.
• %1 found: App not listed?
• Exact app or service name
• Add
• Visualizer sources: Audio apps are detected live from PipeWire. Enable a filter to exclude that app from visualizers; with no filters enabled, iNiR follows the active player automatically.
• Live: Audio app not listed?
• Exact process, app ID or service name

Quick Actions

• Reload shell
• Open config
• Shortcuts
• Show reload toasts: Show toast notifications when Quickshell or Niri config reloads. Errors are always shown.
• Hide reload toasts in Game Mode: Automatically suppress reload toasts when Game Mode is active
• Confirm before closing windows: Show a confirmation dialog when closing windows with Super+Q

System

Audio

• Earbang protection: Prevents abrupt increments and restricts volume limit
• Max allowed increase
• Maximum volume increase per key press
• Volume limit: Maximum volume percentage (pavucontrol allows up to 153%)

Battery

• Low warning: Show warning notification when battery drops below this level
• Critical warning: Show critical warning when battery drops below this level
• Automatic suspend: Automatically suspends the system when battery is low
• Full warning: Notify when battery reaches this level while charging (101 = disabled)
• Charge limit
• Maximum charge percentage

Interface Language

• Auto (System)

Generate translation with Gemini

• Generate Typically takes 2 minutes

Sounds

• Battery
• Play sound for battery warnings
• Timer
• Play sound when countdown timer ends
• Pomodoro
• Play sound when pomodoro timer ends
• Notifications
• Play sound for incoming notifications
• Volume
• Sound volume
• Event sounds: Pick the sound each event plays: one from your sound theme, or any audio file

Time

• Format: 24h, 12h am/pm or 12h AM/PM.
• Second precision: Enable if you want clocks to show seconds accurately

Format

• 24h
• 12h am/pm
• 12h AM/PM

Date formats

• Long date format
• e.g. dddd, MMMM dd
• Short date format
• e.g. dd/MM

Keyboard

• Keyboard popups: Show a popup when Caps Lock, Num Lock, or the keyboard layout changes
• Layout popup: Show a popup when the keyboard layout changes
• Caps Lock popup
• Show a popup when Caps Lock changes
• Num Lock popup
• Show a popup when Num Lock changes
• Keyboard panel indicators: Show layout and lock state indicators in the bar or taskbar
• Layout indicator: Show the current keyboard layout in the bar or taskbar
• Caps Lock indicator
• Show Caps Lock in the bar or taskbar
• Num Lock indicator
• Show Num Lock in the bar or taskbar

Window Management

• Confirm before closing windows: Show a confirmation dialog when pressing Super+Q

Work safety

• Hide sussy/anime wallpapers: Replace anime wallpapers with a solid color when enabled

Boot greeting

• Show greeting on startup: Display a fullscreen welcome screen with clock and weather when the shell starts
• Auto-dismiss delay (ms): How long to show the greeting before it fades out automatically
• Show weather
• Show date

Style: general

• Max notifications shown: Maximum number of notifications to display on the lock screen

Extras

• Dim amount: How much to dim the wallpaper (percentage)
• Animate video/GIF wallpapers: Animated wallpapers on the lock screen. Costs GPU and battery.

Widgets

• Weather
• Media player
• Power buttons
• Unlock hint text

Style: Blurred

• Blur radius
• Intensity of the blur effect
• Extra wallpaper zoom (%): Zoom level for the background wallpaper when blur is enabled

Bar

Bar appearance

• Open Ricelin Pill settings

M3 Bar

• Workspaces: Dot indicator or App icon indicator.
• Resources: Filled rings or Outline rings.
• Divider: Line, Dot or Space.
• Surface: Hug, Float, Rectangle or Material islands.
• Layout and grouping: Compact, Showcase, Information or Custom layout. Joined pills, Separate pills or Transparent.
• Switch the bar to M3 appearance

Visible content and behavior

• Show background
• Open details on click: Open details on click needs a widget with a details popup in the layout: Weather, Clock, Resources, Network Speed or Battery.
• Unread count
• Verbose labels: Unread count needs System Icons or Unread Notifications in the layout.

Clock

• Time font
• Time size (px)
• 0 = inherit global size: Pixel size of the time digits in the M3 bar clock. 0 inherits the global typography scale.
• Date font
• Date size (px): Pixel size of the date string in the M3 bar clock. 0 inherits the global typography scale.
• Reset to default: Override the font and pixel size of the time and date in the M3 bar clock. Leave at 0 / pick the same family as your main font to keep the default look.

Surface

• Outer gap (px): Outer gap only applies to the Float and Material islands surfaces — the others sit flush against the screen edge.

Divider

• Space width (px)

Media

• Popup mode: Bottom overlay or From bar.
• Keep media visible
• Media title only
• Preferred player — blank for any
• Minimum width (px)
• Maximum width (px)

Resources

• Show values
• RAM
• CPU
• CPU temperature
• Disk usage
• Swap usage
• RAM warning (%)
• CPU warning (%)
• Swap warning (%)
• Show RAM indicator
• Show temp indicator
• Show CPU indicator
• Show GPU indicator
• Show swap indicator
• Always show CPU
• Always show GPU
• Always show temp
• GPU warning (%)
• Temp caution (°C)
• Temp warning (°C)

Workspaces

• Number style: Normal, Japanese or Roman.
• Scroll behavior: Switch workspaces or Cycle columns.
• Show app icons
• Always show numbers: Show numbers instead of only when Super is held
• Monochrome icons
• Use Nerd Font workspace labels
• Workspace labels, comma separated
• Tint app icons
• Dynamic count
• Only show existing workspaces (Niri)
• Wrap around: Cycle from last to first and vice versa
• Per-monitor: Each bar shows workspaces for its own monitor
• Invert scroll: Reverse mouse wheel direction for switching workspaces
• Shown
• Scroll steps
• Number reveal delay (ms): Number reveal delay is ignored when ‘Always show numbers’ is enabled

System tray

• Match M3 colors: Use the tray’s semantic M3 foreground color instead of each app’s original icon colors

Utility buttons

• Screen snip
• Color picker
• Screen recording
• Microphone
• Keyboard layout
• Wallpaper
• Dark mode
• Performance profile

Dock in bar

• Icon size (px)
• Button size (px)
• Button spacing (px)

Islands options

• Switch the bar to Islands appearance
• Inset (px): Vertical breathing room around each island. Smaller = taller capsules.
• Capsule padding (px): Horizontal air between an edge island’s border and its content.

Sizing & surface

• Bar rounding (px): Theme follows your global style; 0 is sharp, higher is rounder
• Bar height (px): Content height of the bar before font scaling. Default is 40.
• Bar opacity (%): Background fill opacity. Widgets stay fully opaque.

Audio spectrum

• Audio spectrum: Primary only or All monitors. Bars, Wave or Organic. Bottom, Top, Center rise or Mirrored. Fill, Line or Ribbon. Auto fit, Contained or Edge aura. Flat, Bass, Warm, Vocal, Treble or Smile. Bounded, Full screen or Behind pill.
• Show spectrum in the bar: Auto scales Organic to the active bar layout. Contained keeps deformation inside the surface; Edge aura allows it to breathe beyond the edge.
• Band density (px)
• Band gap (px)
• Smoothing
• Spectrum height (%)
• Spectrum opacity (%)
• Wave edge (px)
• Edge inset (px)
• Curve headroom (%): Compresses peaks only near rounded corners. Square surfaces remain edge-to-edge.
• Frequency accent strength (%)
• Organic response (%)
• Beat pulse (%)
• Motion speed (%)
• Idle motion (%)
• Glow (%)
• Contour roundness (%)
• Wing length (px)
• Wing gap (px)
• Screen padding (px)
• Pill gap (px)
• Underlap (px)
• Screen-edge fade (%)
• Reset spectrum defaults: The spectrum needs a visible bar surface, so it is hidden while the background is off.

Behavior & clock

• Right scroll action: Brightness, Volume, Workspaces or None.
• Left scroll action: Brightness, Volume, Workspaces or None.
• Auto-hide: Off or On.
• Group style: Pills or Seamless.
• Hover trigger height (px): How thick the screen-edge zone is that reveals the hidden bar.
• Super peek delay (ms)
• Peek on Super press
• Push windows when shown: Reserve screen space when revealed instead of overlaying windows.
• Show background
• Display a background behind the bar
• Show scroll hints: Show brightness/volume icons when hovering bar edges
• Verbose mode: Wider center groups, plus the date next to the clock, the media title and the utility buttons. Off = compact bar.
• Float style drop shadow: Render a soft shadow under the bar in Float / Card corner styles.
• Vignette effect
• Gradient shadow from screen edge
• Intensity (%)
• Radius (%): Vignette will hide along with the bar when auto-hide is active.

Modules

• Taskbar (apps in bar): Taskbar replaces the active window title. Pinned apps and running windows appear in the bar, like a traditional taskbar. Uses the same pinned apps as the dock.
• Show window title under app name
• Music width (px): How wide the song title gets. The window title gives way; a crowded bar still shrinks music first.
• Left sidebar icon: ‘distro’ auto-detects your distribution, ‘avatar’ shows your profile picture. Otherwise enter any icon name (looked up as -symbolic).

Bar module layout

• Bar module layout: Smart, Always elastic or Fixed width.
• Flexible spacer width: Minimum width for each Flexible spacer module. 0 keeps it fully elastic.

Color

• Automatic

System Tray

• Pin icons by default: New tray icons are visible by default instead of hidden
• Tint icons
• Apply accent color tint to tray icons
• Show item ID in tooltip
• Useful for debugging tray issues: System tray is disabled in Modules section above

Utility Buttons

• Quick action buttons in the bar
• Screen snip
• Screen record
• Screen cast: Toggle Niri dynamic screen casting (mirroring) to a target output
• Color picker
• Notepad: Toggle button to start/stop Niri dynamic casting (screen mirroring) to a target output.
• Virtual keyboard
• Keyboard layout switch
• Mic toggle
• Dark/Light mode
• Power profile

Notifications

• Show unread count
• Show number instead of just a dot

Wallpaper

Parallax

• Axis: Horizontal, Vertical or Auto.
• Motion profile: Subtle, Balanced or Immersive.
• Enable parallax: Move the wallpaper and background widgets with workspaces and panels
• Follow workspace: Use the current workspace range to shift the wallpaper
• Follow sidebars: Add lateral offset when left or right sidebar is open
• Wallpaper zoom (%): Extra wallpaper zoom after fit-to-cover. 100% keeps the default parallax headroom; lower values zoom out, higher values zoom in.
• Workspace travel (%)
• Sidebar travel (%)
• Widget depth (%)
• Pause during wallpaper transitions
• Transition settle (ms)

Fullscreen behavior

• Hide main wallpaper in fullscreen: Hide the main wallpaper on monitors covered by a fullscreen window. The overview backdrop stays available.

Multi-monitor

• Per-monitor wallpapers: Set a different wallpaper for each connected monitor
• Backdrop
• No monitor selected
• Change wallpaper
• Random: Set a random wallpaper from the current folder for this monitor
• Change backdrop
• Back to wallpaper
• Reset to global: Reset this monitor to use the global wallpaper
• Apply to all: Apply the global wallpaper to all monitors
• View backdrop: Change the backdrop wallpaper (used for overview/blur)
• Derive theme colors from backdrop
• %1 monitors detected

Wallpaper renderer

• Wallpaper renderer: Standard or Interactive web.
• Interactive mode: When enabled, the web wallpaper moves to the desktop input layer so games and interactive pages can receive pointer and keyboard input

Shuffle wallpapers

• Shuffle wallpapers automatically: Pick a random wallpaper from the folder every few minutes
• Change every: How often to pick a new random wallpaper
• Regenerate theme colors on shuffle: When enabled, theme colors are recomputed from the new wallpaper (slower). Disable to only swap the image.

Shuffle folder (optional)

• Use current wallpapers folder

Wallpaper transitions

• Wallpaper transitions: From left, From right, From top or From bottom.
• Transition style: From left, From right, From top or From bottom.
• Enable wallpaper transitions: Smoothly transition between wallpapers when changing them
• Transition duration (ms): How long the transition takes in milliseconds. Ignored for ‘Simple’ and ‘None’ modes; shader transitions use this duration directly.
• Frame rate
• Change per frame: How much the picture changes each frame: higher is quicker and harder, lower is softer.

Wallpaper scaling

• Fill crops, Fit shows bars, Span lays one picture across every screen: Fill, Fit, Stretch, Tile, Center or Span.
• Wallpaper position: Drag to reposition, scroll to zoom. When repositioned or zoomed, the shell renders the wallpaper internally.
• No wallpaper: Enable animated wallpapers (videos/GIFs)
• Pause animated wallpapers on battery: Freeze videos and GIFs while on battery power to save energy
• Blur animated wallpapers (videos/GIFs): Apply blur effect to video/GIF wallpapers. Has performance impact - disable if you experience lag

Wallpaper effects

• Enable wallpaper blur: Blur the wallpaper when windows are present
• Blur radius: Amount of blur applied to the wallpaper
• Thumbnail blur strength (%): Blur strength for video wallpapers (percentage of full blur radius)
• Dim overlay (%): Adds a dark overlay over the wallpaper. 0 = no dimming, 100 = completely black
• Extra dim when windows (%): Additional dim applied when there are windows on the current workspace.

Fluid Ripple (AOSP Port)

• Enable all ripples: Authentic Android sparkle-style ripples. Licensed under Apache 2.0 (AOSP).
• On charging
• On Niri overview open
• On hotcorner activation
• On shell reload
• On screen lock
• On session screen open
• Animation duration (ms): How long the ripple lasts. Higher = slower expansion.
• Visual tuning
• Sparkle intensity: Controls the shimmer/sparkle particles. 0 = none, 100 = default, 200 = intense.
• Glow intensity: Controls the soft glow behind the ring. 0 = none, 100 = default, 200 = strong.
• Ring width: Thickness of the expanding ring. 5 = thin laser, 15 = default, 50 = wide wash.

Backdrop (overview)

• Enable backdrop layer for overview: Show a separate backdrop layer when overview is open
• Derive theme colors from backdrop: Generate theme colors from the backdrop wallpaper instead of the main wallpaper. Requires a custom backdrop wallpaper (not ‘Use main wallpaper’).
• Blur animated wallpapers (videos/GIFs): Apply blur effect to animated wallpapers in backdrop. May significantly impact performance.
• Aurora glass effect: Use glass blur effect with adaptive colors from wallpaper (same as sidebars)
• Aurora overlay opacity (%): Transparency of the color overlay on the blurred wallpaper
• Use main wallpaper: Use the same wallpaper for backdrop as the main wallpaper
• Pick backdrop wallpaper
• Backdrop blur radius: Amount of blur applied to the backdrop layer
• Backdrop dim (%)
• Darken the backdrop layer
• Backdrop saturation: Increase or decrease color intensity of the backdrop
• Backdrop contrast: Increase or decrease light/dark difference in the backdrop
• Enable vignette: Add a dark gradient around the edges of the backdrop
• Vignette intensity
• How dark the vignette effect should be
• Vignette radius: How far the vignette extends from the edges

Notifications

• Hide wallpaper upscale notification: Suppress the notification that appears when a wallpaper has lower resolution than your monitor

Themes

Color Themes

• Quick Access
• Wallpaper Colors
• Click to copy
• Saved themes
• Created in Custom Theme Editor
• No themes found
• Soften colors
• Soften colors (less intense)
• Invert colors (complementary): Rotate every color 180° on the color wheel, producing the complementary palette. Shell-only: terminals, GTK and other external apps keep their original colors.

Scheme Variant

• Colour family: Keep the second and third colours beside the accent, so cards, chips and buttons read as one family. As generated keeps the scheme’s own hues.
• Auto light/dark from wallpaper: Pick the light or dark scheme from each wallpaper’s brightness so text stays readable. Applies on every wallpaper change, overriding the manual dark-mode toggle.

Motion

• Motion: Classic or Contextual.
• Reset to defaults

Theme Scheduling

• Enable automatic theme switching

Terminal Colors

• Enable terminal theming
• Generate color configs for:
• Not installed: Starship prompt palette - use ‘palette = “ii”’ in starship.toml
• btop++ system monitor theme
• lazygit terminal git UI theme
• yazi file manager flavor
• Color Saturation
• Color Brightness
• Theme Harmony: Shifts terminal color hues towards the theme’s primary color. 0% = original colors, 100% = fully harmonized.
• Background Brightness: Controls terminal background darkness. Lower = darker, higher = lighter. Matches shell surfaces at 50%.
• Reset to defaults
• Apply to open terminals: Apply current colors to all open terminal windows without restarting them

Typography

• Variable Font Axes
• Weight: Font weight (100=thin, 400=normal, 700=bold)
• Width: Font width (75=condensed, 100=normal, 125=expanded)
• Grade
• Font grade (optical weight adjustment)
• Reset typography to defaults

Font Families

• Main
• Title
• Mono
• Apps use this font

Icon Theme

• System (tray, apps)
• Dock: Quickshell will restart to apply changes.

Glass Transparency

• Wallpaper color: How much of the wallpaper’s color the glass lets through. Lower is calmer on vivid wallpapers.
• Panels
• Bar, sidebar, main panel backgrounds
• Cards: Settings cards, groups, internal containers
• Popups
• Context menus, dropdown overlays
• Tooltips: Hover tooltips — lower values improve readability
• Surface layers: General layer glass — affects all surface backgrounds (Layer 1/2/3)

Color & Tint

• Color strength: Multiplier for accent tint intensity across all angel surfaces (0.5 = subtle, 1 = default, 2 = vivid)

Blur & Glass

• Blur intensity: How strongly the background is blurred behind glass panels
• Blur saturation: Color saturation of the blurred glass layer
• Overlay tint: Color tint overlay on top of the blur (higher = more transparent tint)
• Noise grain: Subtle noise texture over glass surfaces for organic feel
• Vignette: Edge darkening on glass surfaces for depth

Escalonado System

• Offset X
• Offset Y
• Hover offset X
• Hover offset Y
• Fill opacity
• Border opacity
• Hover fill opacity

Escalonado Shadow

• Offset X
• Offset Y
• Hover offset X
• Hover offset Y
• Fill opacity
• Border opacity
• Hover fill opacity
• Glass blur on shadow
• Shadow glass blur
• Shadow glass overlay

Partial Border & Accent

• Border width
• Thickness of gradient border lines
• Border coverage: How much of each edge the border covers
• Border opacity
• Border hover opacity
• Border active opacity
• Top accent bar (px)
• Left accent bar (px)
• Inset glow height (px)
• Inset glow opacity

Surface Borders

• Panel border width (px)
• Bar, dock, sidebar outer border
• Panel border opacity
• Card border width (px)
• Inner card/container border
• Card border opacity

Glow Effects

• Glow opacity
• Strong glow opacity

Rounding

• Small radius
• Buttons, badges, small elements
• Normal radius
• Cards, popups, tooltips
• Large radius
• Panels, dialogs, large containers

Glass

• Wallpaper glass: Use the wallpaper as a blurred backdrop for large Regalia surfaces. Internal controls remain opaque.
• Blur strength: How softly the wallpaper is diffused behind the surface.
• Wallpaper visibility: Higher values reveal more of the blurred wallpaper through the Regalia tint.
• Material strength: Keeps the Regalia field and edge weight over glass without making it fully opaque.
• Backdrop color: Preserves or mutes wallpaper color inside the blur.

Geometry

• Rounding: Scales Regalia panel and control radii together.

Backdrop layers

• Diagonal burst
• Ghost wordmark
• Technical grid
• Scan ticks
• Diagonal size: Size of the diagonal burst slashes (100% = default).

Source image

• Use current wallpaper: Animated files are not supported. Choose a static image.

Preview

• Original
• Result
• Hit Preview to generate

Panels

Floating tools (Super+G)

• Enable
• Open

Background & dim

• Darken screen behind overlay: Add a dark scrim behind overlay panels for better visibility
• Overlay scrim dim (%): How dark the background scrim should be
• Overlay background opacity (%): Opacity of the overlay panel background

Animations

• Enable opening zoom animation: Animate overlay panels with a zoom effect when opening
• Overlay animation duration (ms): Duration of overlay open/close animations
• Background dim animation (ms): Duration of the background scrim fade animation

Visual Effects

• Desaturation effect: Apply a grayscale/dimmed effect to shell components
• Saturation: Amount of color to remove (0 = normal, 100 = grayscale)
• Dim: Amount of brightness reduction (0 = normal)
• Apply to
• Bar
• Dock
• Sidebars
• Overlays
• Popups

Alt-Tab switcher (Material ii)

• Layout & alignment: Align to right edge or Center on screen.
• Alt-Tab switcher (Material ii): Default (sidebar), List (centered) or Skew previews.
• No visual UI (cycle windows only): Use Alt+Tab to switch windows without showing the switcher overlay
• Tint app icons: Apply accent color tint to app icons in the switcher
• Enable slide animation: Animate window selection with a slide effect
• Animation duration (ms): Duration of the slide animation between windows
• Most recently used first: Order windows by most recently focused instead of position
• Background opacity (%): Opacity of the switcher panel background
• Blur amount (%): Amount of blur applied to the switcher background
• Scrim dim (%): How dark the screen behind the switcher should be
• Auto-hide delay after selection (ms): How long a pick waits before switching, even with Alt still held
• Show Niri overview while switching: Open Niri’s native overview alongside the window switcher

Layout & alignment

• Compact horizontal style (icons only): Show only app icons in a horizontal row, similar to macOS Spotlight
• Use Material 3 card layout: Use Material Design 3 style for the switching panel

Notifications

• Anchor: Top Right, Top Left, Bottom Right or Bottom Left.
• Timeout (ms): Duration in milliseconds before a notification automatically closes
• Scale on hover: Slightly enlarge notifications when the mouse hovers over them
• Quiet hours: Hold back notification popups during a daily window. They still reach the notification history.
• From
• Margin (px): Spacing between notifications and the screen edge/anchor
• Auto-sync badge with popup list: Counts the popups still open, so ones cleared in their own app (like Discord) leave the badge. Off keeps the classic counter.

Control panel

• Compact cards: Use tighter spacing and shorter cards in the quick settings panel
• Show wallpaper card: Show the wallpaper preview card in the quick settings panel
• Show wallpaper scheme buttons: Show the scheme variant buttons under the wallpaper preview
• Keep control panel loaded: Keep the quick settings panel in memory to reduce opening delay

Visible sections

• Media
• Weather
• System status
• Sliders
• Quick actions

Visibility

• Media player
• Week strip
• Context card (Weather/Timer)
• Show weather in context card
• Quick note
• Quick launch
• Icon
• Name
• Command
• Add shortcut
• Controls
• System status
• Crypto prices
• Wallpaper picker
• World Clock

Layout

• Widget spacing
• Space between widgets in pixels
• Hold click on any widget to reorder

Crypto Widget

• Refresh interval (seconds): Type to search coins…

World Clock Widget

• Display
• 24-hour format: Toggle between 24-hour and 12-hour AM/PM time
• Show seconds: Updates every second while the sidebar is open (slightly higher CPU)
• Show date & GMT offset: Display the weekday, date and UTC offset under each city
• Highlight local timezone: Pin your local timezone to the top and accent it
• Timezones
• Search a city or region…: No timezones added. The widget automatically shows suggestions based on your region. Add them below to customize, reorder or remove them.
• Add suggested timezones

Wallpaper Picker

• Thumbnail size
• Show header: Scroll horizontally to browse wallpapers

Glance Header

• Volume button
• Game mode indicator
• Do not disturb indicator

Status Rings

• CPU usage
• RAM usage
• Disk usage
• Temperature
• Battery

Controls Card

• Dark mode
• Do not disturb
• Night light
• Game mode
• Network
• Bluetooth
• Settings
• Lock

Overview

• All-apps grid: Alphabetical (A-Z) or By category.
• Enable: Enable the app launcher and workspace overview (Super+Space)
• Dashboard panel
• Dashboard: Quick toggles
• Dashboard: Media player
• Dashboard: Volume slider
• Dashboard: Weather
• Dashboard: System stats
• Center icons
• Center app icons in the launcher grid
• Show window previews: Display thumbnail previews of windows in the overview
• Scale (%): Scale of workspace previews in the overview
• Rows: Number of rows in the app launcher grid
• Columns: Number of columns in the app launcher grid

All-apps grid

• Show all-apps grid: Replace workspace previews with a scrollable grid of all installed applications

Wallpaper background

• Enable wallpaper blur: Apply blur effect to the overview background
• Wallpaper blur radius
• Intensity of the wallpaper blur
• Wallpaper dim (%): Darkness of the wallpaper behind overview
• Overlay scrim dim (%): Additional darkness for better contrast

Positioning

• Respect bar area (never overlap): Prevent overview from covering the system bar area
• Extra top margin (px): Space reserved at the top of the screen
• Extra bottom margin (px): Space reserved at the bottom of the screen

Layout & gaps

• Max panel width: Maximum width of the overview panel as screen percentage
• Workspace gap (px): Horizontal gap between workspace previews
• Window tile gap (px): Gap between windows inside a workspace preview

Icons

• Min icon size (px)
• Minimum size for app icons
• Max icon size (px)
• Maximum size for app icons

Behaviour

• Workspace number (1-based)
• Index of the workspace to switch to
• Wheel steps per workspace (Overview): How many workspaces to scroll per mouse wheel detent
• Close Overview after moving window: Close overview automatically after dropping a window to a new workspace
• Show workspace numbers: Overlay large numbers on workspace previews

Animation

• Enable focus animation: Animate the focus rectangle when navigating with keyboard
• Focus animation duration (ms)
• Speed of the focus rectangle animation

Tools

Screen recording

• Show recording overlay
• Auto-hide recording OSD
• Recording notifications
• Recording folder
• Quality preset: Tradeoff between file size and quality.
• Acceleration
• Detecting available encoders…: Fallback to safe mode if preferred encoder fails

Audio capture

• Recording audio: Choose whether recordings include system audio, microphone, both, or no audio.
• System audio source: Auto follows the current default output device.
• Microphone source: Auto follows the current default microphone.

Discord compression

• Compress recordings for Discord: Creates a separate Discord-ready copy after recording
• Target size: 10 MB fits Discord Free. A safety margin is applied automatically.
• Max dimension: Lower values help long clips fit without turning into soup.
• Encoder speed: Slower is smaller and cleaner, because physics remains annoying.
• Audio bitrate: Automatically reduced if the clip needs more video budget.

Video

• Codec
• Frame rate
• Bitrate: Higher = better quality, bigger file.
• CRF: Lower = better quality. Software mode only.
• Encoder speed: Software mode only.
• Pixel format

Audio encoding

• Codec
• Bitrate
• Sample rate
• Backend

VAAPI hardware

• Render device
• VAAPI filter

Snipping & OCR

• Google Lens: Rectangular selection or Circle to Search.
• Show Anki actions in the study card
• Open Anki
• Get Anki Desktop
• Install / check AnkiConnect
• Check connection
• Advanced Anki settings
• Screenshots folder

Snip behavior

• Remember last snip choice

Text recognition (OCR)

• Text language: Pick the language you expect to capture. Auto follows the system language. Use the vertical Japanese/Chinese choices for vertical writing.
• Advanced OCR options: Advanced: use a Tesseract model code only when it is not listed above. Combine languages with + only for genuinely mixed-language captures; more models usually reduce recognition accuracy.

Japanese study assistant

• Open study card after Japanese OCR: After Japanese OCR, iNiR finds a useful word in the captured text and opens a local dictionary card. Expand the card to inspect the full OCR text and translation.
• More dictionary options
• Japanese dictionary ready
• Translate to: Translation is optional and uses the existing translate-shell service, so it needs an internet connection. Dictionary definitions remain local after Jitendex is installed.
• Import another Yomitan dictionary
• Refresh index
• Anki (optional)

Ready-made Japanese study decks

• Browse more shared decks

Element appearance

• Border size (px): Thickness of the selection region border
• Numbers size (px)
• Font size of the region index numbers

Rectangular selection

• Show aim lines: Show crosshair lines when selecting a region

Circle selection

• Stroke width: Thickness of the circle selection stroke
• Padding: Padding around the selected circle region

Crosshair overlay

• Crosshair code (in Valorant’s format)
• Floating tools (Super+G)
• Open editor

On-screen display

• Media OSD: Show feedback for explicit media controls and Pill track changes. During games, explicit skips stay visible while automatic track progression stays hidden.
• Timeout (ms): How long the volume, brightness and media indicators stay visible
• Connection notices: A short notice when something is plugged in, connected, unplugged or lost
• Network
• Internet
• Bluetooth devices
• USB devices
• Charger
• Sound output
• Displays
• Drives and memory cards

Services

Idle & Sleep

• Screen off after (min): Turn the display off when nothing happens for this long
• Lock after (min): Lock the screen when nothing happens for this long
• Suspend after (min): Suspend the computer when nothing happens for this long
• Lock before sleep: Lock the screen before the system goes to sleep
• Separate timeouts on battery: Use shorter idle timeouts while the laptop runs unplugged
• Battery: screen off
• Battery: lock
• Battery: suspend
• Keep awake (caffeine): Temporarily prevent screen from turning off and system from sleeping

Music Recognition

• Total duration timeout (s): Maximum time to wait for music recognition result
• Polling interval (s): How often to check for recognition result

Hotspot

• Network name (SSID)
• The name your hotspot will broadcast
• Password
• WPA2 passphrase for the hotspot
• Use 5 GHz band: Use 5 GHz (802.11a) instead of 2.4 GHz. Requires adapter support.

Resources

• Polling interval (ms): How often to update CPU, RAM, and disk usage stats

Prefixes

• Action
• Clipboard
• Emojis
• Math
• Shell command
• Web search

Web search

• Base URL

Updates

• Check interval: How often to check for system updates (in minutes)
• Show icon threshold: Show update icon in bar when available updates exceed this number
• Warning threshold: Show warning color when available updates exceed this number
• Update command

iNiR Shell Updates

• Enable shell update checker
• Check interval: How often to check for iNiR updates (in minutes). Default: 360 (6 hours)
• Open terminal during update: Run setup in your configured terminal so the full TUI output is visible. Off = silent background update with only the bar pill indicator.
• Non-release branch — updates track %1
• Current
• Available
• Checking…
• Open Details
• Dismiss update (hide bar indicator)
• Show bar indicator again

Weather

• Enable weather service
• Show in top bar
• Hide weather location
• City (leave empty to auto-detect)
• e.g. Buenos Aires, London, Tokyo: Manual coordinates (optional, overrides city)
• Latitude (e.g. -34.6037)
• Longitude (e.g. -58.3816)
• Use GPS location (requires geoclue): Uses GPS when no manual location is set
• Current location:
• Use Fahrenheit (°F)
• Update interval (minutes)

Calendar Sync

• Enable external calendar sync
• Refresh interval (minutes)
• Show upcoming events below calendar
• Upcoming days to show
• Calendar Sources
• Add
• Unnamed
• Remove
• No calendar sources added yet: Paste an ICS/iCal URL from Google Calendar, Outlook, or any CalDAV provider. No account login needed — just the calendar URL.
• Add Calendar Source
• Name
• Work Calendar
• ICS URL
• Color
• Cancel

Advanced

Color generation

• Cava & spectrum options: Theme palette, Vibrant (saturated) or Album cover.
• Spotify theme: iNiR or Text (TUI).
• Shell & utilities: Generate colors for GTK apps, fuzzel, and other utilities from wallpaper
• Qt apps: Generate colors for Qt/KDE apps (requires Shell & utilities)
• Terminal: Generate terminal color scheme from wallpaper (requires Shell & utilities)
• Vesktop/Discord: Generate Discord theme from wallpaper colors (requires Vesktop with system24 theme)
• Spotify (Spicetify): Generate and apply a Spicetify theme from wallpaper colors
• Steam (Millennium): Apply Material You colors to Steam via Millennium Material-Theme
• Pear Desktop (YouTube Music): Apply Material You colors to YouTube Music Desktop App
• LiMusic: LiMusic follows your wallpaper colours, from the next time it opens
• Claude Code: Adds iNiR themes to Claude Code’s theme list: two follow your wallpaper, two keep a fixed Monokai palette
• Zed editor: Generate Zed editor theme from wallpaper colors
• VSCode editors: Generate theme for VSCode and its forks from wallpaper colors
• Chrome / Chromium: Apply wallpaper-derived colors to Chrome and Chromium browser
• Firefox: Follows the wallpaper from its next launch; LibreWolf, Floorp, Waterfox and Zen too.
• OpenCode: Apply wallpaper-derived theme to OpenCode AI editor
• Neovim / LazyVim: Generate inir.nvim theme plugin for Neovim/LazyVim from wallpaper colors (writes to ~/.config/nvim/lua/plugins/neovim.lua)
• Theme standalone Cava: Manage the external ~/.config/cava/config block. Internal iNiR visualizers use the options below whether this switch is on or off.
• Force dark mode in terminal: Always use dark background for terminal regardless of wallpaper
• Terminal: Harmony (%): How much to blend terminal colors with the wallpaper palette
• Terminal: Harmonize threshold: Minimum color difference before harmonization is applied
• Terminal: Foreground boost (%): Increase terminal ANSI foreground lightness/contrast (use moderate values to avoid washed colors)

Cava & spectrum options

• Gradient colors: Use one color for a solid spectrum, or up to eight gradient stops
• Sensitivity: Audio sensitivity (higher = more reactive)
• Bars: Number of frequency data points (0 = auto)
• Framerate
• Target refresh rate for the visualizer
• Stereo: Split visualizer into left/right channels
• Wave opacity: Default fill opacity for shared wave visualizers. The bar spectrum has its own opacity control.

Resource Monitor

• GPU monitoring: Poll GPU usage and temperature. Disable on hybrid laptops to keep the dGPU asleep — also pins Qt to the iGPU on next restart.

Shortcuts

Add keybind

• Key combination
• Already bound to:
• Action
• Options
• e.g. repeat=false

Modules

Shell Modules

• Reset to defaults

Panel Style

• Animated switch: The switch shortcut goes through, in this order:

Core

• Bar
• Background
• Niri Overview Backdrop
• Overview
• Workspace Strip
• Floating tools (Super+G)
• Left Sidebar
• Right Sidebar

Feedback

• Notification Popups
• OSD
• Media Controls

Utilities

• Lock Screen
• Session Screen
• Polkit Agent
• Region Selector
• Wallpaper Selector
• Cheatsheet
• On-Screen Keyboard
• Alt-Tab Switcher
• Clipboard History

Optional

• Dock
• Screen Corners
• Crosshair
• EasyEffects Equalizer

Waffle Core

• Taskbar
• Background
• Start Menu
• Action Center
• Notification Center
• Notification Popups
• OSD
• Widgets Panel

Shared Modules

• Niri Overview Backdrop
• Overview
• Floating tools (Super+G)
• Lock Screen
• Session Screen
• Polkit Agent
• Region Selector
• Wallpaper Selector
• Cheatsheet
• On-Screen Keyboard
• Alt-Tab Switcher
• Clipboard History
• Crosshair

Display scaling

• UI scale (%): Scale fonts and spacing throughout the shell. Takes effect immediately.
• Reset to 100%

Selector style

• Skew view (parallelogram cards): Use tilted parallelogram cards instead of the hero + filmstrip layout. You can also switch between views from the toolbar inside the coverflow.

Behavior

• Use system file picker: Use your system’s native file picker instead of the built-in one

Settings UI

• Design: Expressive or Classic.
• Easy mode (essentials only): Show a curated set of essential settings and hide the more advanced pages and sections. Turn this off to see every page again.
• Overlay mode (live preview): Settings opens over the desktop, so each change shows on the bar, panels and wallpaper as you make it. Off opens it as a window.

Overlay appearance

• Backdrop blur (%): Blur the wallpaper behind the Settings overlay while it is open, using the same glass the rest of the shell paints. 0 turns it off and costs nothing.
• Background dim (%): How dark the backdrop behind the Settings panel should be (0 = transparent, 80 = very dark)
• Panel background opacity (%): Opacity of the Settings panel background. Lower values let the shell show through; with a glass style it thins the frosted tint instead.

Waffle Style

Waffle isn’t your panel style

• Switch to Waffle

Wallpaper

• Use main wallpaper
• Pick main wallpaper
• Pick Waffle wallpaper
• Hide main wallpaper in fullscreen: Hide the Waffle main wallpaper during fullscreen. The Task View backdrop remains available.

Wallpaper Effects

• Enable blur
• Blur radius
• Dim (%)
• Dynamic dim (%)

Backdrop (Niri Overview)

• Enable backdrop layer for overview: Enable animated wallpapers (videos/GIFs)
• Use main wallpaper
• Pick backdrop wallpaper
• Blur radius
• Dim (%)
• Saturation
• Contrast
• Vignette
• Vignette intensity

Taskbar

• Bottom position
• Left-align apps
• Tint app icons
• Tint tray icons

Theming

• Theming: Segoe UI, Inter, Roboto, Noto Sans or Ubuntu.
• Use Material colors
• Custom font
• Font scale (%)
• Reset to defaults

Behavior

• Allow multiple panels open

Start Menu

• Start Menu: Mini, Compact, Normal, Large or Wide.
• Text scale (%)

Tweaks

• Smoother menu animations
• Switch handle position fix

Calendar

• Force 2-character day of week

Alt+Tab Switcher

• Alt+Tab Switcher: Niri’s Recent Windows or iNiR switcher. Thumbnails, Cards, Compact, List, Skew previews or None (no UI).
• No visual UI (cycle windows only)
• Quick switch (Alt+Tab once to switch)
• Auto-hide after delay
• Auto-hide delay (ms)
• Close on window focus
• Most recent first
• Thumbnail width
• Thumbnail height
• Scrim opacity
• Show Niri overview while switching

Widgets Panel

• Date & Time
• Weather
• System Resources
• Media Player
• Quick Actions

Compositor

Layout

• Focus behavior: Never, On overflow or Always.
• Always center a single column
• Auto-expand a single tiling window: Automatically maximizes a single tiling window to fill the screen. When a second window appears, the first is restored to its normal width.
• Empty workspace above first
• Enable border
• Enable focus ring
• Window shadow
• Left
• Right
• Top
• Bottom

Window gaps

• Gap size (px)

Border width

• Width (px)

Focus ring width

• Width (px)

Shadow softness

• Softness

Shadow spread

• Spread

Overview zoom

• Zoom (%)

Window Rules

• Clip windows to rounded geometry

Keyboard

• Numlock on startup

Keyboard layout

• XKB layout code (e.g. pl, ar, th, vi)

Variant

• Optional - e.g. colemak_dh

Key repeat delay

• Delay (ms)

Key repeat rate

• Rate (chars/s)

Touchpad

• Touchpad acceleration: Adaptive or Flat.
• Tap to click
• Natural scroll
• Disable while typing
• Disable while trackpointing
• Disable with external mouse
• Left-handed
• Middle-click emulation
• Drag lock
• Scroll button lock

Mouse

• Mouse acceleration: Adaptive or Flat.
• Natural scroll
• Left-handed
• Middle-click emulation
• Scroll button lock

Trackpoint

• Trackpoint acceleration: Adaptive or Flat.
• Natural scroll
• Left-handed
• Middle-click emulation
• Scroll button lock

Cursor

• Hide cursor while typing

General Input

• Disable power key handling
• Workspace auto back-and-forth
• Warp pointer to focused window
• Focus follows mouse: Niri exposes many more compositor options in raw KDL. This page covers the most common ones safely and validates every change before keeping it.

Focus follows mouse threshold

• Max scroll (%)

Animations

• Enable animations: Tune the spring physics for each animation type. Higher stiffness = snappier, higher damping = less bounce.
• Enable this animation
• Damping ratio
• Stiffness

Applications

• Current command: %1

Niri config status

• Modified by you: %1
• Extra files: %1
• Generated/user-owned: %1
• Open config folder
• Open config file
• Config directory: %1

About

System

• Documentation
• Help & Support
• Report a Bug

Based on

• Support end-4

Widgets

Every widget

• Background
• Outline
• Ink
• Position

Edit Mode

• Desktop editing
• Grid
• Grid cell size in pixels
• Shrink the desktop while editing
• Fade with windows

Widget Colors

• Global widget design: One look on every widget. Individual keeps each widget’s own style.

Power Saving

• Editorial palette: Wallpaper adaptive or Manual roles.
• Source: Single file or Folder gallery. All media, (, ), Images only, (, ), GIF (, ), Videos only, ( or ).
• Enable power saving
• Pause on GameMode
• Pause on fullscreen
• Pause when windows present
• Show paused effect
• Current status

Time zones

• City %1
• Add city

Source

• Show
• Source type
• Media file
• Image, GIF, or video
• Media folder
• Folder containing images or videos
• Media type: Videos play silently. Images, animated GIFs, and videos can share the same folder.

Editorial palette

• Color source

Image

• Pose on the desktop
• Custom image: Path to any image or GIF (empty = pose above)

Custom Widgets

• widget-name (lowercase, dashes): Creates a template with all imports, services, and an example layout. Edit the .qml file to customize.
• No custom widgets installed: Click ‘New’ to create one, or ‘Example’ to install a demo widget
• On the desktop

Position

• Coordinates
• Desktop editing

Battery

• Batteries

Upcoming Events

• Up next

Custom image

• Image

Date badge

• Date

Day progress

• Day

Media Controls

• Now Playing

Month Calendar

• Calendar

Screen time

• Screen Time

Decorative shape

• Shape

System Monitor

• Vitals

Todo

• Tasks

System uptime

• Uptime

User card

• Profile

Monitors

Overview placement

• Active screen only: Open the overview on the monitor where it was invoked

Dashboard

General

• Enable dashboard: Centered hub with clock, notifications, media, weather and more
• Show header: Uptime chip and quick action buttons at the top
• Show power buttons
• Lock and session buttons in the header
• Keep loaded in memory
• Faster opening at the cost of RAM
• Panel width (% of screen)
• Toggle with a keybinding running: %1

GitHub username

• e.g. octocat: Powers the “GitHub activity” widget above. Leave empty to disable the contribution graph.

Appearance

• Density: Comfortable or Compact.
• Card opacity (%)
• Show card titles: Icon and name header on each widget card

Autostart

Applications

• No matching apps: Try a different search term.
• External

Custom Commands

• No custom commands: Add a shell command above to run it at login.

Workspace Strip

Edge behavior

• Look: Follow bar, Island or Stock.
• Edge: Left or Right.
• Enable workspace strip: Keeps a compact workspace strip visible on the configured edge

Size

• Panel width: Total width of the strip, including the side flyout
• Preview size: Width of the workspace thumbnails in pixels
• Trigger width: Invisible edge area that opens the strip

Hover timing

• Open delay
• Close delay

Navigation

• Scroll to navigate: Use the mouse wheel over the strip to move between workspaces instead of scrolling the thumbnail list
• Switch workspace on scroll: Also focus the workspace in the compositor when scrolling through the strip
• Scroll debounce: Minimum milliseconds between scroll-navigation steps — prevents rapid workspace cycling

Workspace cards

• Window previews: Live preview for the active workspace and refreshed snapshots for hidden workspaces
• Window metadata: Show workspace name, focused window title and window count
• App icons: Show icons for open applications on the selected workspace card
• Now-playing player: Add a media card at the top of the strip with playback controls when music is playing
• Per-monitor workspaces

Mascot

Mascot

• Character art: JRPG, Codex sprites or Classic art.
• Voice: Adaptive, Casual, Dry, Composed or Chaotic.
• Show mascot illustration: Show the iNiR mascot in About, empty states and other shell surfaces
• Playful companion: She occasionally peeks from a screen edge and reacts to music, battery and updates. Never over fullscreen apps or games
• Minimum quiet time
• Maximum visits per hour
• Respect Do Not Disturb and quiet hours
• React to opened shell panels
• Speech bubbles
• Companion visit interval
• Companion size
• Visit length
• Slide animation
• Panel-sitter mode: She sits on the bar/dock instead of floating off-screen edges
• Contextual placement: Event reactions appear near the triggering widget instead of a random edge
• Follow focused monitor: She appears on the monitor with the focused workspace instead of the primary one
• Personal commentary: Observations about YOUR habits — 3AM sessions, uptime, app marathons. Off = she only makes generic small talk
• Mood personality: Her lines change with session mood (sleepy/hyper/snarky/contemplative)
• Mood change interval
• Chaos mode: Occasional visits to your widgets and panels, with small pranks that return home. Mouse chase only starts when you ask.
• Minimum time between chaos visits
• Enable chaos mode
• Impact sounds: Little thuds and bells from the system sound theme when she hits things
• Let her rearrange widgets: Displaced widgets keep their new position; otherwise everything bounces back home
• React to system events: Occasional reactions to real shell activity, sharing the same quiet time and visit limit
• Calling-card notifications: After a destructive prank, Kira may leave a playful desktop notification
• Unleash chaos
• Tidy up
• Play chase
• Hide and seek
• Peek now
• Say hi
• Send her away: Tip: click her when she appears — more than once at your own risk. Staring also has consequences.
• Edges she may peek from
• Left
• Right
• Top
• Bottom
• Event reactions: Choose what she reacts to, and which pose each event uses
• Only react to real music: Skips browser videos and players without artist metadata
• Pose for this event
• Surface poses
• Surfaces
• Empty states
• About pages
• Session screen
• AI chat
• Dashboard
• Cheatsheet
• Boot greeting
• Update overlay
• Dialogs
• Custom phrases (one per line)
• Things she can say on her visits…

Arrange

Navigation layout

• Make Settings yours: Drag groups and pages into the order you want. Hide anything you don’t need in the sidebar — Search can still open hidden pages.
• %1 visible
• Add group
• Reset arrangement
• Hidden from navigation: Nothing hidden. Use the eye button on any page or drag it here.

Ricelin

Pill bar

• Use Pill bar: Replaces the standard top bar with Ricelin’s morphing Pill surface.

Dock

Dock

• Reveal behavior: Hover or Empty workspace.
• Dock position: Top, Left, Bottom or Right.
• Dock style: Panel, Pill, macOS, Island or M3.
• Enable
• Show on desktop: Show dock when no window is focused (Empty workspace mode only)
• Pinned on startup: Keep dock visible at all times (Empty workspace mode only)
• Tint app icons: Apply accent color tint to dock app icons
• Show dock background
• Show a background behind the dock
• Separate pinned from running: Show pinned-only apps on the left, running apps on the right with a separator
• Notification badges: Show the number of pending notifications on each app icon
• Drag to reorder: Long-press and drag dock icons to reorder pinned apps

Appearance

• Use Card style: Use the new Card style (lighter background, specific rounding) generic to settings
• Dock height (px)
• Height of the dock container
• Icon size (px)
• Size of application icons in the dock
• Hover reveal region size (px): Size of the invisible area at screen edge that triggers dock reveal

Window indicators

• Show dots for inactive apps: Show a dot per window even for apps that aren’t currently focused
• Maximum indicator dots: Limit the number of open window dots shown below an app icon

Window preview

• Show preview on hover: Display a live preview of windows when hovering over dock icons
• Hover delay (ms): Time to wait before showing window preview
• Keep preview on click: Keeps the preview open while you click through windows.

Sidebars

Style

• Use Card style
• Collapse notifications when empty: Shrink the right sidebar when there are no notifications
• Fit left sidebar to widgets: Shrink the left sidebar to its content on the Widgets tab instead of full height
• Instant sidebar opening: Skips the slide animation to reduce stutter under load.
• Open folder after wallpaper download: Open file manager when downloading wallpapers from Wallhaven or Booru

Left Sidebar

• Widgets: Dashboard with clock, weather, media controls and quick actions
• AI Chat: Chat with AI assistants (OpenAI, Gemini, local models)
• Translator
• Translate text between languages
• Anime
• Browse anime artwork from booru sites
• Wallhaven: Browse and download wallpapers from Wallhaven
• News: Local and topic headlines from Google News
• Anime Schedule: View anime airing schedule, seasonal and top anime
• Tools
• Niri debug options and quick actions
• Software: Browse and install curated companion apps
• YT Music: Search and play music from YouTube using yt-dlp
• Web Apps: Embed web apps like Discord, YouTube Music and more in the sidebar

Right sidebar header

• Profile picture
• Manage my account
• Choose
• Banner
• Choose header media

Right Sidebar

• Calendar
• Events
• To Do
• Notepad
• Calculator
• System Monitor
• Weather
• Timer
• Screen Time

Quick toggles

• Columns: Number of columns for the Android-style quick settings grid

Sliders

• Enable: Show volume/brightness/mic sliders in the sidebar
• Brightness
• Show brightness slider
• Volume
• Show volume slider
• Microphone
• Show microphone input level slider

YT Music

• Up Next notifications: Show a desktop notification with the upcoming track when playback auto-advances
• Mute while fullscreen or GameMode: Suppress Up Next notifications when a fullscreen app is active or GameMode is enabled
• Normalize loudness: Even out volume across tracks (EBU R128, like YouTube Music). Disable for the unprocessed stream.

Anime Schedule

• Show NSFW
• Include adult-rated anime in results
• Watch site: Custom streaming site URL. Use %s for search query.

Gelbooru

• User ID
• API key

Wallhaven

• Results per page: Number of wallpapers to fetch per request
• API key
• Optional - for NSFW content

Side edge open

• Hover screen edges
• Trigger width (px)

Corner open

• Enable: Allow opening sidebars by interacting with screen corners
• Hover to trigger
• When this is off you’ll have to click
• Force hover open at absolute corner: When the previous option is off and this is on, you can still hover the corner’s end to open sidebar, and the remaining area can be used for volume/brightness scroll
• with vertical offset: Why this is cool: For non-0 values, it won’t trigger when you reach the screen corner along the horizontal edge, but it will when you do along the vertical edge
• Place at bottom: Place the corners to trigger at the bottom
• Value scroll
• Brightness and volume
• Visualize region: Show a colored overlay indicating the corner trigger areas (debug)
• Region width: Horizontal size of the active corner area
• Region height: Vertical size of the active corner area

AI

Providers & models

• API format: OpenAI, Gemini, Anthropic or Responses API.
• AI Providers
• Custom endpoint: Choose a provider. iNiR discovers its current models and the correct API protocol automatically.
• No custom providers: Curated providers are managed above. Add a custom endpoint only when it is not already supported.
• Provider name
• e.g. My Claude Proxy
• API endpoint URL
• Model code
• Cancel

Voice input

• Language: Auto detect, Spanish, English, Portuguese, French, German or Japanese.
• Transcription backend: Auto, Local Whisper, Groq, Gemini or OpenAI.
• Max recording length (seconds): The same backend is used for chat dictation and voice web search. Keys are passed through the process environment and are never written to commands or config files.

Effects

Blur and glass

• Default blur backend
• Allow compositor blur

Motion and power

• Reduce animations
• Low power effects: Notify when a restart would free memory

Shell Layout

Orbit

Activation

• Orbit Studio: Current style or Ricelin. Compact or Comfortable.
• Corner: Top left, Top right, Bottom left or Bottom right.
• Enable Orbit: Allow Orbit to open from its hot corner and IPC entry point
• Hot corner: Open Orbit by pushing the pointer into the selected screen corner
• Corner capture area: Invisible square that receives pointer movement near the corner
• Activation distance: How close the pointer must get to both screen edges before Orbit opens
• Corner dwell: Milliseconds to hold the pointer in the exact corner; 0 opens immediately
• Orbit: Try a change, or put every Orbit setting back.
• Open
• Confirm

Orbit Studio

• Docked Studio width: Percentage of the output reserved by Focus Studio
• Section descriptions: Show the short explanation under each Studio section title

Workspace layout

• Workspace surface: Current style or Ricelin. Off, Core only or All cards.
• Window labels: On hover, Always or Off.
• Orbital space: Orbit, Horizon, Gallery, Deck or Atlas. Select as core or Enter directly. Number, Name, Workspace, Full or Hidden.
• Stage: Stage or Orbital.
• Orbit profile: Balanced, Classic, Spatial, Minimal or Cinematic.
• Window gap

Orbit profile

• Save current as user preset
• Apply user preset

Orbital space

• Visible workspaces
• Core size
• Satellite size
• Horizontal spread
• Vertical spread
• Depth: Perspective separation between front and rear workspace satellites
• Satellite window previews: Disable to keep full previews only in the core workspace and reduce capture work
• Workspace wallpaper: Show the wallpaper currently in use on this output behind each virtual workspace
• Workspace wallpaper strength

Advanced geometry

• Orbit edge padding
• Horizon card gap
• Horizon rail inset
• Horizon base separation
• Horizon spread range
• Gallery side gap
• Gallery row gap
• Deck base gap
• Deck stack step
• Deck fan step
• Atlas card gap
• Atlas columns
• Atlas Core emphasis
• Core content inset
• Satellite content inset

Classic stage

• Visible workspaces
• Workspace scale: Percentage of the monitor size used by each workspace preview
• Maximum panel width
• Workspace spacing
• App icons in window labels
• Balanced window grid: Prefer readable 2D cards instead of reproducing Niri’s scrolling columns literally

Workspace surface

• Workspace outline
• Outline width: Stroke thickness around workspace previews
• Outline intensity: Opacity of active/core workspace outlines
• Workspace rounding
• Material frame inset: Leaves a visible band of the selected workspace material around wallpaper and previews
• Shadow intensity

Navigation

• Close after selecting a window
• Keyboard navigation: Navigate previews and Shelf controls without leaving Orbit
• Scroll between workspaces
• Switch Niri workspace: When enabled, wheel navigation changes the real Niri workspace. Disable it to preview the Orbit Core only.
• Wrap around: Continue from the last workspace to the first, and from the first back to the last
• Wheel ticks per workspace: 1 changes on each wheel notch; higher values require more wheel movement
• Right-drag canvas scrub: Drag empty Orbit space horizontally to step through workspaces
• Scrub step distance

Orbit Shelf

• Pocket layout: Cards or List.
• Restore stashed windows: Original workspace or Current workspace.
• Trail scope: This monitor or Current workspace.
• Workspace locator: Automatic, Index or Name.
• Shelf surface: Current style or Ricelin.
• Shelf labels: Automatic, Always or Icons only.
• Shelf density: Comfortable, Compact or HUGE AS YOUR MOM.
• Shelf layout: Bar, Islands or Minimal.
• Show Shelf: Keep fast window history, Niri controls and shell actions below the workspace band
• Studio button: Keep the live Orbit Studio editor one click away in the workspace locator
• Module spacing
• Gap between Shelf modules
• Island padding: Horizontal breathing room inside each Shelf island; the workspace locator keeps an additional safe inset
• Recent window Trail: Allow the Trail module to surface recently focused windows
• Enable Stash: Reveal the Stash drop target while dragging; its Shelf module can be hidden independently
• New workspace drop target: Offer Niri’s trailing empty workspace as a fast destination while dragging a window
• Trail windows: Maximum recent windows shown before the Shelf switches to icon-only layout
• Pocket snapshots: Show cached window previews in Pocket; disable for a denser icon-first view
• Close Orbit after an action: Dismiss Orbit before launching a pinned shell action
• Pinned actions: Choose any built-in or custom Global Action. The Shelf also keeps an All actions button.
• Slot %1
• Orbit pinned action %1

Material motion

• Backdrop blur: Off or iNiR glass.
• Workspace navigation: Snappy, Fluid, Cinematic, Instant or Custom. Direct, Smooth or Linear.
• Orbit presentation: By view, Soft, Float, Sweep or Instant. Fade, Drift, Cascade or Instant. Center, Top, Bottom, Left or Right.
• Backdrop dim
• Workspace numbers: Colors, typography, rounding, shadows and reduced-motion policy always follow the active Material appearance.

Orbit presentation

• Advanced presentation: Tune entry assembly and exit travel behind the preset
• Travel distance
• Enter duration
• Exit duration
• Entry pre-roll
• Entry start opacity
• Card stagger
• Shelf entry delay

Workspace navigation

• Advanced navigation: Tune scroll and workspace-switch motion
• Navigation duration

Backdrop blur

• Blur strength
• Blur saturation
• Glass tint

iRiS

iRiS family

• iRiS is active: Island chrome stays lightweight; Dock and desktop widgets can be enabled independently.
• Activate

Visual system

• Density (%)
• Motion

Island geometry

• Position
• Height
• Screen gap
• Automatically hide
• Reserve workspace space

On-demand surfaces

• Desktop widgets
• Dock
• Automatically hide dock
• Dock blur
• Magnify icons on hover
• Dock icon size
• Palette
• Control center
• Notification popups
• OSD
• Session screen
• Lock screen
• Polkit authentication

Surface sizing

• Palette width
• Palette results
• Palette shortcut hints
• Control width
• Notification width
• OSD width

Focus · left

• Enable panel
• Width
• Height (%)
• Attach to the screen edge
• Reveal on hover
• Keep open: Use Customize in each panel to choose and reorder its sections.
• Open and customize

Hub

Sources

• Didn’t answer
• Address of an index.json, or a folder
• Add