Every Waffle setting

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

Home

• Themes: ·
• Background
• Taskbar: Layout, tray, clock, and peek options
• Waffle Style
• Recordings folder
• Screenshots folder

General

Volume protection

• Maximum volume
• Max increase per step: Maximum volume increase per key press

Battery

• Low battery warning
• Critical battery: Auto-suspend threshold
• Full battery notification
• Charge limit
• Charge limit threshold

Time & Language

• Show seconds: Display seconds in clock
• Long date format: Used by clocks and full date labels. Example: dddd, MMMM dd
• Short date format: Used by compact date surfaces. Example: dd/MM
• Language

Keyboard popups

• Layout popup
• Caps Lock popup
• Num Lock popup

Keyboard panel indicators

• Layout indicator
• Caps Lock indicator
• Num Lock indicator

Window animations

• Animation style: How windows open, close and slide between columns

Windows & Sounds

• Show reload notifications: Toast when Quickshell or Niri config reloads
• Confirm before closing: Show dialog when closing windows with Super+Q
• 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.
• Battery sounds
• Notification sounds
• Sound volume

Idle & Sleep

• Screen off timeout: Turn off screen after inactivity (0 = never)
• Lock timeout: Lock screen after inactivity (0 = never)
• Suspend timeout: Suspend after inactivity (0 = never)
• Lock before sleep: Lock screen before suspending

Separate timeouts on battery

• Battery: screen off
• Battery: lock
• Battery: suspend

Game Mode

• Auto-detect fullscreen: Enable game mode when apps go fullscreen
• Disable animations: Turn off UI animations in game mode
• Disable effects: Turn off blur and shadows in game mode
• Disable audio visualizers: Stop Cava and hide audio visualizers while game mode is active
• Disable Niri animations: Turn off compositor animations in game mode
• Disable Discover overlay: Stop discover-overlay while game mode is active
• Minimal mode: Make shell surfaces lighter while game mode is active
• Suppress notifications: Hide notification popups while game mode is active
• Hide reload toasts: Suppress reload notifications when Game Mode is active

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.

Calendar

• External calendar sync: Sync events from external ICS/iCal URLs (Google Calendar, Outlook, etc.)
• Refresh interval: Minutes between calendar fetches
• Show upcoming events: Display upcoming events below the calendar
• Upcoming days: How many days ahead to show

Taskbar

Position & Layout

• Bottom position: Place taskbar at bottom of screen
• Left-align apps: Align taskbar apps to the left instead of center

Icons

• Tint app icons: Apply accent color to taskbar app icons
• Tint tray icons: Apply accent color to system tray icons
• Taskbar icon size
• Search app icon size

Desktop Peek

• Enable hover peek: Show desktop when hovering the corner button
• Hover delay

Clock & Notifications

• Show seconds: Display seconds in taskbar clock
• Show unread count: Display notification count badge on clock
• Activation watermark: Show a fake activation message on the taskbar

Updates

• Check interval
• Show icon threshold: Show update icon when packages exceed this
• Warning threshold: Show warning color when packages exceed this

Background

Wallpaper

• Use Material wallpaper: Adopt the same wallpaper used by Material ii
• Per-monitor wallpapers: Set different wallpapers for each monitor
• Colors only mode: Use a wallpaper as a palette source without replacing the background
• Hide main wallpaper in fullscreen: Hide the main wallpaper while a fullscreen window is active. The Task View backdrop stays available.
• Scaling: Fill crops, Fit shows bars, Span lays one picture across every screen.
• Wallpaper selector: Choose how the wallpaper library opens
• Wallpaper previews

Monitor Wallpapers

• Derive theme colors from backdrop

Wallpaper transitions

• Enable wallpaper transitions: Animate wallpaper changes and previews. This is shared with Material ii so both panel families use the same transition pipeline.
• Transition style
• Transition direction: Choose where wipe and wave transitions travel from
• Transition duration: How long the wallpaper transition takes

Wallpaper Effects

• Enable animated wallpapers (videos/GIFs): Play videos and GIFs as wallpaper. When disabled, shows a frozen frame
• Pause animated wallpapers on battery: Freeze videos and GIFs while on battery power to save energy
• Enable blur: Blur wallpaper when windows are open. Temporarily hides during wallpaper transitions.
• Blur animated wallpapers (videos/GIFs): Apply blur to animated wallpapers. Independent from window blur. May significantly impact performance.
• Blur radius: Amount of blur applied to wallpaper
• Animated blur strength: Blur intensity for animated wallpapers (0-100%)
• Dim overlay: Darken the wallpaper
• Extra dim with windows: Additional dim when windows are present

Backdrop (Overview)

• Enable backdrop: Show backdrop layer for overview
• Enable animated wallpapers (videos/GIFs): Play videos and GIFs in backdrop (may impact performance)
• Blur animated wallpapers (videos/GIFs): Apply blur to animated wallpapers in backdrop. May significantly impact performance.
• Use separate wallpaper: Use a different wallpaper for backdrop
• Backdrop wallpaper
• Derive theme colors from backdrop: Generate theme colors from the backdrop wallpaper instead of the main wallpaper
• Hide main wallpaper: Show only backdrop, hide main wallpaper
• Backdrop blur: Amount of blur for backdrop layer
• Backdrop dim: Darken the backdrop layer
• Backdrop saturation: Increase color intensity
• Backdrop contrast: Increase light/dark difference
• 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

Desktop Clock

• Enable clock: Show a desktop clock on the Waffle wallpaper layer
• Placement: Use Draggable to place it manually, or let Waffle choose the least busy region
• Reset free position: Move the draggable clock back to its default position
• Clock style: Choose how prominent the wallpaper clock feels
• Time format: Follow the global clock format or override it for the wallpaper clock
• Show seconds: Update the wallpaper clock every second
• Show date: Display a second line with the current date
• Date style: Control how much date information is shown
• Color tone: Blend with wallpaper colors or keep the text neutral
• Animate time change: Smoothly animate the clock text when time changes
• Clock dim: Darken the clock text without affecting the wallpaper
• Time scale: Scale the main time line independently
• Date scale: Scale the date line independently
• Show shadow: Use a shadow behind the text for better contrast
• Show lock status: Show the locked status row when the screen is locked

Themes

Global Style

• Take style from Material: Waffle wears Material’s global style and transparency. Off: its own Fluent look.
• Style: editorial

Appearance

• Mode: Light or dark color scheme
• Palette type: How colors are generated from wallpaper
• Invert colors (complementary): Rotate every color 180° on the color wheel. Shell-only: external apps keep their original colors.

Theming

• Use Material colors: Apply Material color scheme instead of Windows 11 grey
• Color strength: Controls how vivid wallpaper-derived accent colors are
• Soften colors: Subtly soften theme colors for a more natural look
• Auto light/dark from wallpaper: Pick the light or dark scheme from each wallpaper’s brightness so text stays readable
• Vesktop/Discord theming: Generate Discord theme from wallpaper colors
• Spotify theming: Generate and apply Spicetify theme from wallpaper colors
• Spotify theme: Choose the Spicetify layout while keeping iNiR wallpaper colors
• Steam theming: 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 ~/.config/cava/config; internal visualizers always use the options below
• Transparency: Enable transparent UI elements

Cava Options

• Color source: Live palette for internal visualizers and standalone cava
• Gradient colors: One solid color or up to eight gradient stops
• Sensitivity: Audio sensitivity (higher = more reactive)
• Bars: Number of frequency data points (0 = auto)
• Framerate: Target refresh rate
• Stereo: Split visualizer into left/right channels
• Wave opacity: Fill opacity for shared wave visualizers
• Blocked visualizer apps: Comma-separated playback apps to exclude from visualizers. Empty keeps automatic active-player selection.
• Reset to defaults: Restore all cava settings to defaults

Terminal Colors

• Color saturation: How vivid semantic terminal colors are
• Color brightness: Lightness of terminal foreground colors
• Theme harmony: Shifts terminal hues towards the theme’s primary color
• Background brightness: Terminal background darkness — lower is darker, 50% matches shell surfaces
• Reset to defaults: Restore all terminal color settings to defaults

Waffle Typography

• Font family: Font used in Waffle panels
• Apps use this font: Your apps’ text follows the font the shell shows.
• Font scale: Scale all text in Waffle panels

Gowall

Upscale Settings

• Model: AI upscaling model (requires Vulkan GPU)
• Scale: realesrgan-x4plus

Effect

• Brightness

Pixelation

• Pixel scale: Lower values = more pixelated. Large images may need lower values (3-8).

Output

• Format

Interface

Display scaling

• UI scale: Takes effect immediately
• Reset to 100%

Display

• Fake rounded corners: Add rounded corners to flat screens

Notifications

• Normal timeout: How long normal notifications stay visible
• Low priority timeout
• Critical timeout: 0 = never auto-dismiss
• Quiet hours: Hold back popups during a daily window. Notifications still reach the history.
• 22:00
• 08:00
• Ignore app timeout: Always use your timeout settings instead of app-defined ones
• Popup position
• Do Not Disturb: Silence all notifications
• Blocked apps: Comma-separated app or service names. Blocked notifications never enter history, sounds or popups.

Floating tools (Super+G)

• Enable
• Floating tools (Super+G): Super+G
• Darken screen behind overlay: Add a dark scrim behind overlay panels for better visibility
• Overlay scrim dim (%)
• Overlay background opacity (%)
• Game Performance background opacity (%)
• Transparent Game Performance background: Set panel opacity to 0%; metrics remain visible
• Enable opening zoom animation
• Overlay animation duration (ms)
• Background dim animation (ms)

On-Screen Display

• Media OSD: Show feedback for explicit media controls. Pill also announces automatic track changes outside games.
• OSD timeout: How long volume, brightness and media OSD stays visible

Connection notices

• Network: Wi-Fi or cable connected and dropped
• Internet: Lost and back online
• Bluetooth devices: Headphones, keyboards, controllers
• USB devices: Mice, keyboards, controllers, cameras, phones, by name
• Charger: Plugged in and on battery
• Sound output: Headphones or speakers take over
• Displays: A monitor plugged in or removed
• Drives and memory cards: Pendrives, external disks and SD cards, with their name and size

Lock Screen

• Enable blur: Blur background on lock screen
• Blur radius
• Center clock
• Show ‘Locked’ text

Show notifications

• Show notification body: Display message content. Disable for privacy.
• Max notifications shown
• Notification position: Where notifications appear on the lock screen
• Clock style: Visual style for the lock screen clock
• Clock position: Where the clock appears on the lock screen
• Show status indicators: Show WiFi, Bluetooth, volume and battery on the lock screen
• Dim wallpaper: Apply a dark overlay to the wallpaper for better contrast
• Dim amount: How much to dim the wallpaper
• Login screen: Where you sign in after starting the computer. Automatic shows iRiS while you use iRiS.
• Login style: Cover shows your picture sharp, Frame hangs it in a mat, Lens cuts the time out of it.

Screen Recording

• Preferred codec: Auto currently resolves to %1
• Quality preset: Trade off file size and output quality
• Acceleration: Auto picks the best path for your hardware
• Recording audio: Choose whether recordings include system audio, microphone, both, or no audio
• System + microphone
• System audio source: Auto follows the current default output device
• Microphone source: Auto follows the current default microphone
• Recordings folder: Leave empty to use the Videos folder
• Screenshots folder: Leave empty to use Pictures/Screenshots
• Filename format: date(1) tokens for recording filenames (without extension)
• Fallback if preferred encoder fails: Retry with a safer recording path if the preferred encoder fails

Compress recordings for Discord

• Discord target size: 10 MB fits Discord Free
• Discord max dimension: Lower values help long clips fit without becoming a pixel smoothie
• Discord encoder speed: Slower is smaller and cleaner
• Discord audio bitrate: Automatically reduced when video needs the budget
• Skip compression when already under target
• Video codec
• Frame rate
• Video bitrate
• Audio codec
• Audio bitrate
• Audio backend
• Render device
• VAAPI filter

Modules

Panel Style

• Panel family: Changing this will reload the shell

Default Terminal

• Terminal emulator: Used by shell actions, keybinds, and package commands

Panels

• Waffle family currently inactive: Changes here will apply when you switch the panel family back to Windows 11 (Waffle).
• Taskbar
• Background
• Start Menu
• Action Center
• Notification Center
• Notification Popups
• OSD
• Widgets Panel
• Task View: Overview of all workspaces and windows. Supports carousel and centered focus modes.
• Screen Time: Track time spent in each application. Shows in the Action Center.

Waffle Style

Alt+Tab Switcher

• Alt+Tab opens: custom
• Style: Visual layout of the window switcher
• Quick switch: Single Alt+Tab switches instantly without UI
• No visual UI: Switch windows without showing overlay
• Most recent first: Order windows by most recently used
• Auto-hide: Switches to the pick after the delay, even with Alt still held
• Auto-hide delay
• Close on window focus
• Thumbnail width
• Thumbnail height
• Background dim: Scrim opacity behind the switcher
• Show Niri overview while switching: Open compositor overview alongside the switcher

Task View

• Module currently disabled: Task View
• View mode: Carousel shows desktops equally. Centered highlights the active one.
• Close on window select: Exit Task View when clicking a window

Behavior

• Allow multiple panels open: Keep start menu open when opening action center
• Smoother menu animations: Use smoother closing animations for popups
• Switch handle position fix: Fix toggle switch handle alignment

Start Menu

• Module currently disabled: Start Menu
• Size preset: Choose the start menu size
• Text scale: Scale text in the start menu

Family Transition

• Animated transition: Smooth animated overlay when switching between panel families

Widgets Panel

• Module currently disabled: Widgets Panel
• Show date & time: Display date and time widget
• Show weather: Display weather conditions widget
• Hide weather location: Hide the city/location name in the weather widget and taskbar button
• Show system info: Display CPU, RAM, and disk usage
• Show media controls: Display now playing and media controls
• Show your widgets: Cards from widgets you installed, from the Hub or your own

Show quick actions

• Files shortcut
• Terminal shortcut
• Settings shortcut
• Wallpaper shortcut
• Screenshot shortcut
• Screen Record shortcut
• Session shortcut
• Color Scheme selector

Weather

• City: Leave empty to auto-detect from IP
• Latitude: Manual latitude (overrides city). e.g. -34.6037
• Longitude: Manual longitude (overrides city). e.g. -58.3816
• Use GPS location: Uses GPS when no manual location is set (requires geoclue)
• Detected location: ,
• Use Fahrenheit: Display temperature in °F instead of °C
• Update interval: How often to refresh weather data

Calendar

• Module currently disabled: Calendar / Notification Center
• Force 2-char day names: Use Mo, Tu, We instead of Mon, Tue, Wed

Shortcuts

Nothing to set here: you use this page directly.

About

Links

• GitHub Repository: github.com/snowarch/inir
• Documentation: inir.space/docs
• Original Project (end-4): github.com/end-4/dots-hyprland
• Quickshell Documentation: quickshell.outfoxxed.me

System Info

• Config path
• Shell path
• Panel family: waffle

Monitors

Shell visibility

• Primary monitor: Fallback output for popups when the focused monitor is unknown

Overview placement

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

Autostart

Nothing to set here: you use this page directly.

Workspace Strip

Edge behavior

• Enable workspace strip: Keeps a compact workspace strip visible on the configured edge
• Edge
• Look
• Panel width
• Preview size
• Trigger width
• Open delay
• Close delay

Scroll to navigate

• Switch workspace on scroll: Also focus the workspace in the compositor when scrolling through the strip
• Scroll debounce

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

• 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: Roughly how often she peeks on her own
• Companion size
• Visit length: How long she stays before sliding away
• Slide animation: How fast she slides in and out
• 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, marathons); off = generic small talk only
• Voice: Adaptive follows her mood; fixed modes keep one conversational register
• Mood personality: Her lines change with session mood (sleepy/hyper/snarky/contemplative)
• Mood change interval
• Character art
• Minimum time between chaos visits

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
• 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

Actions

• Tidy up: Every displaced widget returns home
• Play chase: Explicitly start the mouse chase game; it never starts on its own
• Hide and seek: Explicitly start hide-and-seek; find Kira before the timer expires
• Peek now: Try her right now instead of waiting for the interval
• Send her away
• Only react to real music: Skips browser videos and players without artist metadata

Screen edges

• Peek from left edge
• Peek from right edge
• Peek from top edge
• Peek from bottom edge

Mascot surfaces

• Empty states: Notifications, clipboard, todo, media, calendar, wallpapers, search results
• About pages
• Session screen
• AI chat
• Dashboard
• Cheatsheet
• Boot greeting
• Update overlay
• Dialogs: Close confirmation and similar dialogs

AI

Get started

• Live model catalogs: Refresh provider availability, model IDs, context and capabilities

Providers & models

• Add custom endpoint: For providers that are not already supported above
• Provider name
• API endpoint URL
• Model code

Assistant behavior

• AI system prompt: Custom instructions the assistant always receives
• AI tools: Shell tools use typed actions and configuration previews. Raw commands are isolated in Advanced mode.
• Temperature: Higher is more creative, lower is more predictable. Default 0.5

Privacy & policy

• Allow AI features: Local only restricts the assistant to models running on this machine, such as Ollama or LM Studio

Voice input

• Transcription backend: Auto prefers local Whisper, then connected online speech providers
• Language: Auto detect is recommended for multilingual dictation
• Voice input

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

Live shell layout

• Edit live: Show the real taskbar and placement targets on the desktop

Taskbar placement

• Current position: Applies to every output enabled for the Waffle taskbar
• Reset placement: Restore the Waffle taskbar to the bottom edge

Hub

Sources

• Count my votes and installs: Without your name, from a key kept on this computer

About it

• Reaches: ,