Every iRiS setting

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

Home

What you change every day.

Language & time

• Clock: The Island, the lock screen and every clock in iRiS.
• Exact seconds: Clocks that show seconds tick on the second.
• Language: Every label in the shell.

Apps & login

• Starts with you: Apps and commands your compositor opens when you sign in.
• Startup file: The compositor’s file these lines live in, for the ones written by hand.
• Terminal: Where Spotlight’s commands, package installs and anime playback open.

Settings window

• Prism: The Settings iRiS opens by default: every page in one panel, what it holds over a beam of light.
• Opens as: Over the desktop previews every change on the screen behind it.
• Layout: How Settings lays out its areas.
• Original design: The Settings of v2.33 over every page and option of today: plated marks, an area’s groups in one list, a sidebar without captions.

Shell

• Family: The whole shell’s look.
• Low power: Turns glass, blur and heavy wallpaper effects off everywhere.
• Switch shortcut goes through: The families the switch keybind steps through, in the order you turn them on.
• Animated switch: A short transition while the families swap, instead of a cut.

Style

Presets, colour, material, shape and type.

Design

• Design: What iRiS is made of: its shapes, type, controls and motion.

Presets

• Pick a look: One tap sets the whole look; Ctrl+Z takes it back. The tiles below fine-tune it.
• Take only their colours: Themes change your colours only, not shapes, layout or motion.

Customize

• Customize opens: On the shell edits in place; Studio is a side panel with search.

Previews

• Animated previews: Live scenes in Settings and Customize.

App colours

• The shell’s accent: Apps and terminals wear the accent you chose instead of one from the wallpaper.
• The shell’s material: Apps and terminals sit on the same paper as the shell.
• The shell’s font: Apps read in the font the shell shows.
• Icons: The icon set apps and the tray draw.
• GTK and KDE apps: They wear the shell’s colours, made again for each wallpaper.
• Qt apps
• Terminals
• Terminals always dark: Terminals keep a dark palette in Ink and Light mode too.
• Which ones: Terminals and tools that take the colours.
• Terminal colour: How saturated the sixteen colours are.
• Terminal brightness
• Lean toward the accent: 0 keeps each colour’s own hue; 100 pulls them all toward your accent.
• Hues that lean: How far from the accent a colour can be and still lean toward it.
• Terminal background: Lower is darker; 50 matches the shell’s surfaces.
• Brighter terminal text
• Discord (Vesktop)
• Chrome and Chromium
• Firefox: Follows the wallpaper from its next launch; LibreWolf, Floorp, Waterfox and Zen too.
• VS Code
• Zed
• Spotify (Spicetify)
• Spotify theme
• YouTube Music (Pear Desktop)
• LiMusic: Follows the wallpaper, from the next time LiMusic opens.
• Claude Code: Adds iNiR themes to Claude Code’s theme list: two follow the wallpaper, two keep a fixed Monokai palette.
• Steam
• Neovim
• OpenCode
• Cava
• Cava colours from
• Cava gradient: How many colours its bars climb through.
• Cava sensitivity
• Cava bars
• Cava frame rate
• Cava in stereo

Colour theme

• Style: iRiS is vivid, Washi is paper and pigment, Material You follows your wallpaper.
• Colour theme: The palette your shell and apps wear.
• Match the shell: The shell takes the theme’s accent, highlight and material too.
• Softer colours: Takes the glare off a theme’s brightest colours.

Day and night

• A theme for each: One theme by day, another at night, switched on the hour you set.
• Hours

Scheme

• Scheme: Ink sits between dark and light: paper and ink, easier on the eyes.
• Light or dark from the wallpaper: With Auto, bright wallpapers pick light and dark ones pick dark.

Dark look

• Paper: Night is your style’s own.
• Warmth: How much washi fibre the night paper carries.
• Tone: Lifts or dims this mode’s material.
• Colour strength: How strong accents and colours read in this mode.
• Widget colour: How colourful desktop widgets look in this mode.

Ink look

• Paper: Washi grades, from bleached to sumi-dyed.
• Warmth: How much washi fibre the paper carries.
• Ink style: Ink wears washi whatever the style above.
• Tone: Lifts or dims this mode’s material.
• Colour strength: How strong accents and colours read in this mode.
• Widget colour: How colourful desktop widgets look in this mode.

Light look

• Paper: How bright the page is.
• Warmth: How much washi fibre the paper carries.
• Tone: Lifts or dims this mode’s material.
• Colour strength: How strong accents and colours read in this mode.
• Widget colour: How colourful desktop widgets look in this mode.

Material

• Material: What every surface is made of.
• Fills: Groups, tracks, hovered and pressed controls.
• Lines: Hairlines and borders.
• Shadows: Under bodies floating over windows.
• Button rows: Puts rows of round buttons on one plate: Veil, Glass or Solid.

Adaptive

• Adapt to the wallpaper: iRiS takes its shape from the wallpaper: calm images round, busy ones sharpen. 0 is off.

Texture

• Texture: How surfaces are drawn.
• Light: A hot line on every edge that faces the Island, brightest by it.
• Aurora: Your colours rising off every lit edge onto what is behind, and glowing a little inside it.
• Trails: What a moving body leaves behind it: its lit edge, as a long exposure catches it.
• Aurora colours: Aurora runs your accent into its two neighbours; Your colours takes accent, wallpaper and highlight as they are.
• Grade: The light Afterglow is lit with.
• Atmosphere: How strongly the grade tints the blacks and the light.
• Chrome: The bevel every edge wears: a chrome lip reflecting a lit sky over dark ground.
• Bloom: Light that spills past the edges and glows on the side facing the light.
• Signal: Scanlines and the slight colour fringe of a tube screen.
• Grade the wallpaper: The wallpaper gets the same light, live ones and the lock included, so the whole screen matches.
• Shape: The shape the light takes: a haze from one corner over a band of colour, a prismatic eye over a hot horizon, a burnt corner, grain-gradient orbs, or a beam under a stroke of light.
• Across: Moves the light sideways.
• Up and down: Moves the light up or down.
• Frame: How much light the screen’s edge catches.
• Widgets: How much light the desktop widgets catch.
• Spill: Light that spills past the edges, red reaching furthest, its tail breaking into grain.
• Prism: How far the light splits into its colours.
• Grain: Film grain through the light: the edges of every shape dissolve into it.
• Grain size: Fine like a slow film, coarse like a fast one.
• Streaks: Vertical smears, as light dragged across the film.
• Dust and bokeh: Motes of dust and out-of-focus discs of the grade in the dark of the wallpaper.
• Film edge: The wallpaper’s corners fall off as a lens’s do; with Light only, the film’s edge shows too.
• Backdrop: Under the light: your wallpaper, exposed by it, or the darkroom and the light alone, as the textures it comes from.
• Expose the wallpaper: How far your wallpaper is printed in the light: faded, sunk into the dark away from it, live ones and the lock included. Glass blurs it as printed.
• Develop: A new wallpaper rises out of a milky ground, as a Polaroid does.

Glass

• Glass: Glass blurs the wallpaper.
• Tint: How much material covers the glass.
• Frost: How blurred the wallpaper is behind the glass, on iRiS and on glass widgets.
• Niri blur: Blur asks Niri to blur what is behind iRiS.
• Blur strength
• Colour behind: Above 1 makes what is blurred more vivid.
• Grain: A little noise hides banding in soft gradients.

Edges

• Style: Line is an even hairline.
• Outline colour
• Edge light: How much light the top edge catches.
• Edge line: The edge away from the light.
• Edge width: In screen pixels: 1 is the finest line your screen can draw.
• Edge colour: Scene takes the wallpaper’s light.

Shape

• Base corners: Corners of panels, buttons and fields that don’t set their own.
• Corners: Every radius in the family; nested corners keep stepping down.
• One shape for all: The Island, the Dock and the bubbles share the bubbles’ shape.
• All shapes
• Island shape
• Dock shape
• Fusion: How deeply shapes melt where they meet.
• Spacing: Padding, gaps and control sizes.

Icons

• Icon pack: How iRiS draws its icons.
• Shape: The corners of every icon plate.
• Colour: Auto gives each area its colour; a line look (Nothing) draws them in ink.
• Glyphs: The set every glyph is drawn from.
• Fill: Auto fills them, as the widgets do; a line look outlines them.
• Weight: How heavy every glyph’s line is.
• Plate: The plate behind icons.

Frame

• Close the shell around the screen: A black band around the screen with rounded inner corners.
• Frame width
• Screen corners: How round the frame turns inward at the corners of the screen.
• Rail: The frame grows wide on one side and holds your Dock’s apps, like a browser’s sidebar.
• Rail width: How wide the rail stands inside the frame; its icons grow with it.
• Rail apps: Top lines them up under the launcher like a browser’s tabs; Centre holds them in the middle like a Dock.
• Rail buttons: The + that pins apps and the gear that opens Settings.
• Frame light: Holo lights the frame like the back of a CD: a spectral rim with a halo over the screen, on any material.
• Holo light: How brightly the spectral rim burns.
• Holo halo: How far the light spills over the screen; 0 keeps it on the frame.

Look

• Look: The dialect iRiS speaks: how controls are made, what marks the chosen thing, the voice of labels. Each place below can wear its own.
• Chosen: What marks the chosen segment, the lit tile, the current row.
• Figures: How large numbers read: the dot matrix of Nothing OS, or Archivo’s wide figures.
• Keys light in: A key that is on, a chosen key, the one act.
• Levels run in: Faders and meters.
• Key depth: How far keys stand on their edge and sink when pressed.
• Printed labels: Lowercase Geist Mono on keys and titles, as printed on a panel.
• Gel colour: What fills a gel.
• Gloss: The light cap over a gel: a candy at 0, a mirror at the top.
• Round type: Titles and figures in Rubik.
• Island
• Dock
• Control Center
• Settings
• Spotlight
• Orbit
• Lock screen
• Desktop widgets
• Notifications
• Volume and brightness

Signal

• Signal: The one colour iRiS uses: something live, something that needs you, an action you can’t undo.

Accent

• System accent: What your apps wear, and what iRiS marks as chosen under the Apple look.
• Accent hue

Highlight

• Highlight: The glanced detail: clock separator, day number, timers.
• Highlight hue

Badges

• Unread counts: The family’s red, your accent, the highlight, or a quiet neutral.

Light

• Light: What lights an open card: its own colour or the wallpaper’s.
• Reach: How far the light goes into a body: just its head, or deeper.
• Glow: Floating surfaces cast an accent halo instead of a dark shadow.

Wallpaper tint

• Wallpaper tint: How much wallpaper colour the black carries.

Text

• Size: Text across iRiS, on top of the system scale.
• Weight: Every weight in iRiS one step lighter or firmer.
• Contrast: Secondary and quiet text.

Faces

• Pairing: Sets the three faces below together.
• Text: Labels, rows and everything you read.
• Titles: Page titles and card heads.
• Figures: Clocks, timers and levels.
• Figure weight

Settings

• Corners: Auto keeps the family’s shape for Settings.
• Light: Its own colour, the wallpaper’s, or plain black.

Menus

• Size: Compact rows fit more in less; Regular keeps them roomy.
• Corners: Auto keeps the family’s shape for menus.
• Light: Its own colour, the wallpaper’s, or plain black.

Material per surface

• Cards: Glass or solid for this surface alone.
• Control Center
• Side panels
• Spotlight
• Orbit
• Settings
• Menus
• Wallpaper gallery
• Volume and song pill

Wallpaper

Shuffle, live wallpapers, the gallery and the overview.

Overview backdrop

• Wallpaper behind the overview: Shown around workspaces when Niri’s overview is open.
• Same wallpaper as the desktop: Off keeps the overview’s own wallpaper; choose it in the gallery with Overview as the target.
• Only the backdrop on the desktop: Hides the desktop wallpaper: the desktop shows the backdrop with its blur and dim, and glass follows it.
• Animate in the overview: A live wallpaper moves behind the workspaces, only while the overview is open.
• Blur
• Dim
• Vignette

Wallpaper shuffle

• Shuffle wallpapers: A new wallpaper from your folder every few minutes.
• Every
• Colours follow: Each new wallpaper recolours the shell and your apps. Off keeps the current colours.
• From the folder: Where shuffle picks from.

Transition

• Animate the change: The next wallpaper arrives with a movement instead of a cut.
• Style
• From
• Duration
• Frames per second: How smoothly the movement is drawn.
• Dissolve step: Higher finishes Simple sooner, in coarser steps.
• Sweep step: Higher moves wipes, waves and circles in coarser steps.

Library

• Wallpapers folder: Where the gallery and shuffle look first.
• A wallpaper per screen: Each screen keeps its own; the gallery asks which screen it is for.
• Small wallpaper notice: A notification when a wallpaper is smaller than your screen, with a link to upscale it.
• Renderer: Interactive web plays a page or WebGL scene as the wallpaper.
• Web page: A local HTML file or a web address.
• Takes clicks and keys: Games and interactive pages get the pointer; the bar and dock stay above.

Wallpaper gallery

• Picker: Which picker opens for wallpapers.
• Preview on the desktop: The highlighted wallpaper shows behind the gallery; closing without applying restores yours.
• Play previews: Live wallpapers play a muted preview while chosen or hovered in the gallery.
• Library order: How your folders line up in the gallery.
• Online order: What the online gallery shows first. Trending, Most viewed and Most liked are Wallhaven’s.
• Shape: What the web is asked for.
• Top of the: How far back Top looks on Wallhaven, Konachan and yande.re.
• Online sources: Where the gallery looks beyond your folders, in the order you turn them on. Konachan and yande.re lean to fan service even when rated safe.
• Suggestive art: Off keeps swimsuits, lingerie and fan service out of online results.
• Live wallpaper downloads: Which file a live wallpaper downloads.
• Corners: Auto keeps the family’s shape for the gallery.
• Light: Its own colour, the wallpaper’s, or plain black.
• Layout: How the picker lays out what you browse.

Live wallpapers

• Animate on the desktop: Video and GIF wallpapers move.
• Pause: A hidden wallpaper stops decoding and keeps its frame.
• Pause on battery

Behind windows

• Blur the wallpaper: While windows are open on the workspace; it comes back sharp when they leave.
• Blur
• Blur live wallpapers too: Video and GIF wallpapers cost more to blur.
• Dim with windows open
• Always dim

Scaling

• Scaling: Fill crops, Fit shows bars, Span lays one picture across every screen.

Parallax

• Parallax: The wallpaper drifts a little as you move between workspaces and columns.
• Direction
• Depth

Motion

How every shape grows, moves and settles.

Motion

• Reduce motion: Surfaces appear in place.
• Movement: How every shape iRiS grows moves.
• Duration: How long a shape takes to grow out of what opened it.
• Bounce: How far arrivals and moves pass their place before settling, as a share of the style’s own. 0 never bounces; leaving never does.

Curve

• Curve: The path a Direct shape follows as it opens or adjusts.
• Shape: Drag the two handles.

Timing

• Open and close: How long a shape takes to grow out of what opened it and fold back.
• Adjusting: How long an open shape takes to change size, like switching pages.
• Content arrives: Lower shows what is inside while the shape is still growing; higher waits until it has formed.

Per surface

• Island: Speed of this surface’s morph.
• Cards
• Control Center
• Side panels
• Spotlight
• Orbit
• Settings
• Menus
• Wallpaper gallery
• Volume and song pill

Touch

• Press depth: How far buttons, bubbles and the Island dip under a press.

Style per surface

• Island: A surface can move in a style of its own.
• Cards
• Control Center
• Side panels
• Spotlight
• Orbit
• Settings
• Menus
• Wallpaper gallery
• Volume and song pill

Island

Composition, size and how the Island responds.

Design and modes

• Composition: How the Island holds media and controls.
• Island design: How the resting Island shows the time.
• Island layout: Where the Island sits on its edge.

Visibility

• Automatically hide: The Island tucks into its edge and comes back when you rest the pointer there.
• Stay visible on empty workspaces: When auto-hide is on, keep the Island visible on workspaces with no windows.
• Reserve space for windows: Bubbles on the same edge reserve their own room.

Live activities

• Screen recording: How long it has run, with a red dot.
• Timers: A timer, a stopwatch or a focus session, with its ring.
• Downloads and tasks: A job’s progress as a ring.
• Camera: A green camera tile with the app while the camera is on. The privacy dot shows either way.
• Calls: While an app listens through the microphone: a green handset and how long it has run. The privacy dot shows either way.
• Music: The song takes the Island while it plays, or the bubble beside it.
• Order: When several run at once, the first takes the Island and the next waits in the bubble beside it.
• Microphone glow: The screen’s edges glow for a moment when an app starts listening.

Notices

• System events: The Island says by itself what just happened, for a moment: a connection, a timer, a screenshot, Do Not Disturb.
• Size: How a notice shows in the Island.
• Stays for: How long a notice holds the Island.
• See one: The Island shows a notice in the size and for the time chosen here.
• Unlocked: A face drawn in green as the screen unlocks.
• Silent: The sound muted from anywhere.
• Do not disturb: Turned on or off.
• Low battery: When it runs low and nothing charges it.
• Screenshots: The picture itself; a tap opens it.
• Recordings: A recording saved, with its length.
• Upcoming events: A calendar event about to start, with a ring closing on it.
• First said: How long before an event starts the Island first says it.
• Rain and snow: Rain or snow on its way in the next hours.
• Timers: A timer that ends, and each focus or break.
• Finished jobs: Downloads, copies and updates that end or fail.
• Shelf: Files and text kept on the Shelf.
• Game mode: Turned on or off.
• Niri config: An error in Niri’s config, and when it is fixed.
• Loud jumps held back: When a sudden jump in volume is stopped.
• Caps Lock badge: A small pill drops out of the Island when Caps Lock turns on or off.

Connections

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

Interaction

• Expand on hover: The pointer has to rest on the Island; passing over it does nothing. A full-width Island always opens on a click instead.
• Hover delay
• Scroll on the Island: On the resting Island: Shift swaps volume and brightness; Ctrl adjusts the microphone.
• Scroll on bubbles: Also adjust over the media, controls and tray bubbles.

Resting Island

• Trailing bubble: The bubble beside a Cluster Island.
• Bubbles in the Island: Small faces the Island carries, in the order you switch them on. One picked here leaves the frame.
• Where they sit: Which end of the Island carries them.

Bar

• Start: What rests at the start of the full-width Island, in the order you switch it on. The Island itself is the live part: the time, or whatever is happening.
• Centre: Kept in the middle of the edge while there is room.
• End: What rests at the far end.

Face

• Sunlight: By day, the Island’s foot glows where the sun stands.
• Looks ahead: How far ahead it looks for the next event.
• Lit tile: Which half wears the accent.
• The day: The day and its date beside the tiles.
• Marks: The ticks round the dial.
• Beside the dial: What sits next to the watch.
• Next event: What is next on your calendar, within three hours.
• Weather: The temperature and the sky.
• Sunrise and sunset: When the sun rises or sets next. The date always stays.
• Temperature: The temperature in the window’s corner.
• Beside the time: The place and the sky, or the day and the date.
• Outer ring: The red one, round the outside.
• Middle ring: The green one. On a desktop the battery counts the week.
• Inner ring: The blue one, in the middle.
• Colours: The light round the Island.
• Turns under the pointer: The colours go once round while the pointer is over the Island.
• Counts: What the comet’s head marks, read clockwise from the top: a lap is an hour, a day or a full battery.
• Trail: A tail fading behind the head, or the whole way gone lit from the top.
• Laps under the pointer: The comet runs once round while the pointer is over the Island.
• Light: What the light under the Island tells: the battery climbs the sides as it charges.
• Foot: What the lamp along the foot counts: the battery’s charge, or the hour gone.
• Notifications lamp: The left side lights a third for each notification waiting, up to three.
• Event lamp: The right side fills over the last hour before an event and stays lit while it runs.
• Charge in figures: While charging, the percentage beside the time.
• Water: What the water stands at: the battery’s charge, the hour gone or the day gone.
• Light at the foot: A little of the light pooled inside the Island, under the time.
• Capsule: What the capsule at the end carries. Auto takes the battery, else a headset’s charge, else the weather, else the day.
• Connection: A cable, Wi-Fi’s bars, or none.
• Sound off: A red mark while the sound is muted.
• Hours: How many hours the strip shows, now included. A narrow Island shows fewer.
• Hour names: Each hour’s name over its sky.
• Sky in colour: The sun in yellow, rain in blue. Off, every sky is grey.
• City: Whose time sits beside yours.
• Second city: Another city after the first.
• Time apart: How many hours ahead or behind each city is. Two cities on a slim Island leave it out.
• Watch: A small watch for each city, lit by day and dim by night.

Layout

• Island rise: How far the Island rises out of the shelf’s middle; None keeps one straight edge.
• Screen edge
• Size: The Island’s height, clock size and breathing room, set together.
• Height: The resting Island, and how deep its notch melts into the edge.
• Gap from the edge
• Menu bar strip: Transparent leaves your items on the wallpaper, like macOS; Band lays a bar under them.

Notch

• Notch: The Island melts into the screen edge, like the notch it grows from.

Shape

• Notch curve: How wide the shoulders are where the Island turns into its edge.
• Open corners: Auto follows the Island’s shape; a size here overrides it.

At rest

• Clock: What the resting Island shows beside the time.
• Utility island: Emerges beside the Island; the tray hides when no apps are present.
• Clock size: The time and date on the resting Island.
• Clock accent: The colour of the time’s separator and the day number on the resting Island.
• Breathing room: Space around what the resting Island shows.
• Bubble gap: How far the bubbles beside the Island rest from it.
• Bubble size: The bubbles beside the Island, as a share of its height.

Desktop page

• Header: What sits behind the time when the Island shows your desktop.
• Header fade: How far the wallpaper melts into the Island under the time.
• Header top: How the wallpaper melts into the Island at the top, under its buttons.
• Header veil: How much the wallpaper is dimmed behind the time.
• Header blur: Softens the wallpaper behind the time.
• Blocks: What sits under the time, in the order you switch them on. You can also arrange them on the Island itself: open its desktop page and tap the pencil.
• Your modules: Modules written with the iRiS SDK sit in the page’s Modules block.
• Block style: How the Island page’s blocks sit.

Pages

• Page width: How wide the open Island is.
• Navigation: What the open Island’s navigation row offers, in the order you switch them on. Pages come first; scroll over the row, or swipe sideways anywhere on the open Island, to move between them.
• Page buttons: What holds the navigation row.

Shelf

• Shelf: A page on the open Island with what you copied, the screenshots you took and the files you dropped on it.
• Items kept: How many it keeps besides the ones you pin.
• Copied pictures: Pictures you copy go on the shelf too.
• Clear on logout: What isn’t pinned leaves when you log in again.

Player page

• Blocks: What the player page shows, in the order you switch them on.

Dock

Visibility, material and app icons.

Visibility

• Show dock
• Automatically hide: Rest the pointer at the screen edge to reveal it.
• Reserve space for windows: Keep tiled windows clear of the visible Dock.
• Stay visible on empty workspaces

Icons

• Notification badges
• Icon size
• Magnify on hover
• Magnification: How large the icon under the pointer grows; its neighbours follow.
• Applications button: Opens Spotlight from the start of the Dock.

Apps

• Pinned apps: Drag one to move it in the Dock.
• Open apps: Where open apps sit in the dock.
• Drag to reorder: Slide an icon along the Dock to move it.

Look

• Screen edge: Auto keeps the Dock on the edge opposite the Island.
• Dock notch: The Dock melts into its screen edge like the Island’s notch.
• Material: What this surface is made of.

Bubbles & Cards

Pieces you carry and the cards they grow.

Behaviour

• Bubble design: How each bubble beside the Island is drawn.
• Tapping a bubble: What a tap on a bubble does.
• Snap to corners and edges: Dropped near a ring, a bubble joins that corner or edge in the spot you let it go; off, it stays where you let go.

On the contour

• Reserve space for windows: Windows keep clear of the bubbles resting on an edge.
• Group into a bar: Bubbles resting in the same place share one plate and read as a small bar; off, each one floats as its own disc.
• Keep them on the frame: Bubbles in a corner or on an edge sit on the shell’s own edge, where they read as a swelling of it, instead of floating over your windows.
• Meet the edge: Notch: they melt into the edge with the Island’s curved shoulders.
• Grow from the corner: Bubbles in a corner run out of the frame’s curve as one contour, however far along the edge they reach.
• Shoulders: How deep the curve is where a bubble melts into the edge.

Floating

• Space from the screen edges: How far floating bubbles rest from the edges when they are not on the frame.

Tray

• Bubble shows: Apps turns the bubble into the tray itself: every app is a disc you can click, right-click or scroll.
• App names
• Hide passive apps
• Columns

Size

• Bubble size: Bubbles off the Island, as a share of the Island’s height.

Opening bodies

• Join to opener: When settled, let a card or Control Center become one silhouette with the bubble or Island that opened it.

Cards

• Design: A whole look for every card at once.
• Room around the content: Auto follows the design.
• Handle: A small bar on the edge facing its bubble or the Island.
• Corners: Auto keeps the family’s shape for cards.
• Width: Auto keeps the family’s width.
• Stand off its piece: How far a card rests from the bubble or Island that opened it.
• Light: Its own colour, the wallpaper’s, or plain black.

Joining

• Opens: Where a card or the Control Center grows from a bubble: away from the edge it sits on, or along it.
• Air: The space between what opened and the bar or bubble it came from.

Card contents

• Header: The glyph, name and figure at the top of the sound and microphone cards.
• Devices: Pick the output or input right inside the card.
• App volumes: Each app’s level under the sound card.

Desktop

Widgets and the desktop menu.

Widgets

• Desktop widgets: Turning this off also unloads their data providers.
• On the desktop: Tap a widget to add it to this screen or take it away.
• Arrange the desktop: Move, size and dress every widget on the desktop itself; the shelf has these same options.
• Desktops: Ready-made desktops (Glance, Dashboard, Focus, Listening, Bare) and the ones you saved: wear one, Undo takes it back.
• Design: One look on every widget.
• Widgets with a look of their own: Some widgets were given a different design in their Look controls.
• Undo the last design change: Brings back the design and each widget’s own look from before you started changing it.
• Widget corners: Individual widget overrides take priority.
• Accents: The three colours every widget draws its rings, bars and figures with.
• Accent strength: Low keeps soft pastels; high makes accents saturated and bright.
• Material: What sits behind every widget.
• Shrink the desktop while editing: Off, widgets are arranged on the full desktop, in place.
• Lume on every widget: Every widget reads as if the wallpaper under it were bright and busy: a deeper veil on glass and a stronger text shadow on widgets without a background.
• On bright wallpapers: Where the wallpaper under a widget is light, it turns to frost with dark ink and deeper accents.
• Titles and figures
• Surface opacity: How much material a widget carries.
• Outline: The line around each widget.
• Widgets with their own material: They chose a material or surface opacity in their Look controls, so the rows above don’t reach them.

Desktop menu

• Wallpaper at the top: The right-click menu opens on your wallpaper: tap it for the gallery, or the round button for the next one.
• Actions: What the right-click menu offers, in the order you switch them on. They group themselves: the desktop, tools, then the shell.

Windows

Gaps, borders, corners and how Niri moves them.

Layout

• Gaps: Space around and between windows.
• Centre the focused column
• Centre a column that is alone
• New columns
• Empty workspace above the first

Borders

• Border: A solid line around every window, drawn by Niri.
• Width
• Focused
• Others
• Focus ring: A ring outside the focused window only.
• Ring width
• Ring colour

Shape

• Window corners: Rounds every window’s corners.
• Clip content to the corners
• Shadows
• Softness
• Spread

Glass behind apps

• Window in focus: Blur only shows through a window that is not fully opaque.
• Windows out of focus: How opaque the windows you are not using stay.
• Blur behind apps: Niri blurs what is behind every window that lets it through.
• Blur shows: What the glass blurs.
• Keep borders out of the glass: Stops the border and focus ring from showing through a see-through window.
• Niri blur: Off turns blur off everywhere, iRiS included.
• Blur strength
• Colour behind: Above 1 makes what is blurred more vivid.
• Grain: A little noise hides banding in soft gradients.

Movement

• Animate windows: Niri’s own motion: opening, closing, moving and switching.
• Style: How windows open, close and slide between columns.
• Speed: Above 1 slows every Niri animation down.
• Overview size: How big workspaces are in Niri’s overview.
• Jump back to the previous workspace: Picking the workspace you are on takes you to the one before.

Room for iRiS

• Focus, when kept open
• Today, when kept open

Closing

• Confirm before closing windows: Asks before the close-window shortcut closes an app.

Control Center

What it carries and how it looks.

Hotspot

• Network name: What other devices see when the hotspot in the Control Center is on.
• Password
• Band: 5 GHz is faster nearby; 2.4 GHz reaches further and works with older devices.

VPN

• VPN button in quick controls: Adds a VPN switch to the Control Center beside Ethernet and Bluetooth.
• Connection details: The VPN card shows addresses, the tailnet’s devices and live traffic; tap a value to copy it.

Control Center

• Control Center
• Corners: Auto keeps the family’s shape for the panel.
• Light: Its own colour, the wallpaper’s, or plain black.
• What it carries: Every control the panel holds.
• Columns: How many controls fit across.
• Names under the controls: Off shows a name in the header while you point at it.
• Control shape: Round draws each switch as a disc with its name under it; Tiles are rounded squares.
• Accent: What a switch lights up with.
• Slider fill
• Connections plate: Up to four round switches, in this order.
• Levels: Which sliders stand side by side in Levels.
• Opens as: The Island itself becomes the Control Center, or a panel hangs from it.
• Width

Spotlight

Search apps, files, the clipboard and more.

Spotlight

• Spotlight
• Maximum results
• Search mode shortcuts: Clipboard, calculator, actions and more under the suggestions.
• Forgive typos: Ranks apps by how few letters differ, so “firefx” still finds Firefox.
• Corners: Auto keeps the family’s shape for Spotlight.
• Light: Its own colour, the wallpaper’s, or plain black.
• Opens as: Floating opens a sheet of its own; Island turns the Island into Spotlight.
• Width

Clipboard

• Entries shown: How many recent copies Spotlight lists first; scroll or keep pressing Down to go through the whole history. Type ; to open it.

Prefixes

• Clipboard: Typed first, searches what you copied.
• Calculator: Typed first, works out the rest.
• Actions: Typed first, lists switches, themes and commands.
• Emoji: Typed first, finds an emoji to copy.
• Command: Typed first, runs the rest in your terminal.
• Web: Typed first, searches the web.
• Apps only: Typed first, leaves out everything but apps.

Web search

• Search the web with: What ? and Search the web use in Spotlight.

Orbit

Every workspace and window, and the way to any of them.

Orbit

• Orbit: Every workspace with its windows where they are, and a search that finds any of them.
• Opens as: The Island grows into it, or a sheet opens under the Island.
• Window pictures: What each window looks like, from Niri’s own screenshot of it. Off shows app icons and takes no screenshots.
• Picture age: How old the picture of the workspace you are on may be before Orbit takes a new one.
• Corners: Auto keeps the family’s shape for Orbit.
• Light: Its own colour, the wallpaper’s, or plain black.

Size

• Width
• Workspace height: The tallest the workspace you are on gets.
• Neighbours: How much of the workspaces above and below shows.

Look

• Wallpaper on the workspaces
• Window titles: On the window under the cursor, on every window, or never.
• Workspace names
• Fade what doesn’t match: How far the windows that don’t match your search fall back.
• Key hints: A quiet line at the bottom with the keys.

Shelf

• Recent windows: The windows you were in before this one.
• How many
• Set-aside windows: Windows you minimised, ready to bring back.
• Window actions: Go, send to another workspace, set aside, float and close, for the window under the cursor.
• Thumbnail size

Behaviour

• Close after going: Off keeps Orbit open after you pick a window.
• Scroll changes workspace
• Ask Spotlight when nothing matches: ↵ on a search with no window hands it to Spotlight.
• Bring windows back to: Where a set-aside window returns to: the workspace it left, or the one you are on.
• Arrow keys: Niri: up and down change workspace, left and right change window.

Hot corner

• Hot corner: Rest the pointer in a corner of the screen and Orbit opens.
• Corner: Auto picks a free one: a corner Niri’s overview doesn’t use and where none of your pieces sits. Niri’s own corner is never taken.
• Corner size
• Wait before opening: How long the pointer rests in the corner.

Screenshots & Recording

Snip, annotate, read Japanese and record.

Snip

• Save screenshots to: Empty uses Pictures/Screenshots.
• Snap to windows: The selection jumps to the window under the pointer.
• Annotate in Satty: Edit opens Satty instead of the built-in editor.
• Circle to search: Google Lens takes a circle drawn around anything instead of a rectangle.
• Remember the last mode: The next snip opens on the mode you used last.
• Snap to panels
• Snap to content: Images and blocks of text inside a window.
• Aim lines: Guides across the screen while you drag a rectangle.
• Circle stroke
• Circle padding
• File name: Date codes such as %Y, %m and %H fill in when it is saved.

Read text

• Read text in: The language Copy text recognises.

Recording

• Quality: Small files, a balance, sharper, or near lossless and large.
• Sound
• Tell me when it is saved
• Save to: Empty uses your Videos folder.
• System sound from
• Microphone
• A copy for Discord: Each recording also gets a smaller .discord.mp4 beside it, under the size Discord takes.
• Keep it under
• Only when it is too big
• Largest side
• Copy sound
• Copy encoding: Slower makes a better copy at the same size.
• Retry in software: If the encoder fails, recording starts again without the GPU.
• Sound system
• File name: Date codes such as %Y, %m and %H fill in when it is saved.

Japanese lookup

• Look up Japanese: Text you capture from a manga, a game or a stream shows readings and meanings.
• Send words to Anki: Adds the word you pick as a card through AnkiConnect.
• Deck
• Dictionary: Jitendex, about 37 MB: readings and meanings for what you capture.
• Translate to
• AnkiConnect address
• Note type
• Front field
• Back field
• Kaishi 1.5k: Japanese to English, beginner vocabulary.
• Manabi 2.7k: Japanese to English, words and sentences.
• Niponismo: Japanese to Spanish, grammar.

Now Playing

Music in the Island, on the lock screen and on the frame.

Frame music

• Music on the edges: Let music animate an Organic Edge wave or swell the iRiS frame itself.
• Music drives

Edge wave

• Look: Where the wave sits, what it is made of and how it answers the music, at once.
• Colours: Adaptive follows the wallpaper and the cover; Theme keeps to your accent.
• Moves with the music: Off, it drifts on its own whatever plays.
• In silence
• Strength: How much of the wave shows over the desktop.

Frame response

• Edges: Which sides of the frame move with the music.
• Strength: How far the frame swells into the screen.
• Sensitivity: How strongly quiet passages move the frame.
• Travel speed: How quickly the swell flows along the edge.

Frame finish

• Appearance: Sculpted is pure shape.
• Light colour: Pearl follows iRiS ink; the other choices follow your theme and wallpaper.
• Light: How much of the chosen colour rests on the moving frame.
• Light width: A hairline for Etched, or a wider falloff for Satin.

Bubble

• Media bubble opens: A card that floats out of the bubble, or the Island’s player page.
• Keep the card open: The card stays beside the Island while a player is active.

Name song

• Listen for up to: How long Name song listens before it gives up.
• Ask every: How often it checks what it has heard so far.

Visualizer

• Visualizer: How what plays is drawn on the resting Island, its player page and the Visualizer bubble.
• Bands: How many parts of the sound it follows.
• Visualizer colour: The artwork’s own colour, the accent, the highlight or the ink.

Player

• Round album cover
• Blurred album background: Tints the expanded Island and media cards with the cover.

Anime

Airing, Continue and the anime colour layer.

Colour layer

• Anime colour layer: Anime accents over your colours.
• Palette
• Strength: How far the palette pulls the accents away from your own; 0 keeps them exactly.
• Recolour the highlight: The highlight takes the anime palette too.

Airing

• Airing bubble: The next episode on the Island; its card lists what’s coming.
• Episodes in the card: How many upcoming episodes the Airing bubble lists.

Continue

• Audio: Japanese with subtitles, or dubbed where a dub exists.
• Quality: The stream every episode starts in.
• Subtitle size: Every episode starts with subtitles this size.
• Subtitle height: How high subtitles sit; 100 is the bottom edge.
• Skip intros: Jumps over openings where ani-skip knows them.

Notifications

Banners, quiet hours and Do Not Disturb.

Banners

• Notification banners
• Banner duration: How long a notification stays when the app does not choose.
• Ignore how long apps ask: Every banner uses the duration above, even when the app picks its own.
• Urgent banners stay: How long a critical notification stays.
• Longest a banner stays: Even notifications that ask to stay forever leave the screen after this.
• Width

Do Not Disturb

• Do Not Disturb: Banners stay away; notifications still collect in Today.
• Quiet hours: Do Not Disturb turns itself on every day between these times.
• From
• Until

Sound

• Play a sound

Apps

• Apps that notify: Every app that sent you something.

Sound & Feedback

Volume, alert sounds and what the OSD shows.

Output

• Sound plays on: Pick where the sound goes; the volume is the one in use.

Input

• Microphone: Pick the microphone apps hear; the level is the one in use.

Apps playing

• Volume per app: Every app making sound now.

Feedback

• On-screen feedback: Volume, brightness, song and keyboard changes show on the Island, or in a small pill when it is hidden.
• Volume, brightness and mic: When the Island shows a change of volume, brightness or mic.
• Song changes: When the Island shows the song.
• Keyboard layout and locks
• Level style: How a level shows in its pill.
• Show the percentage
• Pill corners: Auto keeps it a capsule.
• Pill light: Own lights volume indigo, the mic orange and brightness in the highlight.
• OSD width
• OSD position: Where the level pill shows when the Island is not there to answer, like over a fullscreen game.
• Distance from the edge
• Time on screen: Songs and warnings stay a little longer so they can be read.

Volume

• Ear protection: Holds back sudden jumps and keeps the volume under the limit.
• Largest jump: The most one change can raise the volume.
• Volume limit: Above 100 % amplifies the sound and can distort it; 153 % is as far as the system mixer goes.

Alert sounds

• Alert volume: Notifications, timers and battery warnings.
• Timers
• Focus sessions

Display

Resolution, scale, night light and bright flashes.

Screens

• Island on: None chosen shows it on every screen.
• Widgets on: None chosen shows them on every screen.
• Main screen: Where the wallpaper gallery and other one-screen panels open.

Night Light

• On a schedule: Warmer colours in the evening, back to normal in the morning.
• From
• Until
• Night Light now
• Warmth: Lower is warmer.

Comfort

• Soften bright flashes: Dims the screen when a mostly white window suddenly fills it.

Screen

• Screen

• Beside the other screen: Which side the pointer crosses to reach it.

• Resolution: Applies now; keep it or it goes back in 15 seconds.

• Refresh rate

• Scale

• Rotation

• Variable refresh

• Night Light

Keyboard & Mouse

Layouts, repeat, pointer speed and cursor.

Keyboard

• Layout: XKB layouts, comma separated: us,es
• Variant
• Options: Such as caps:escape or grp:alt_shift_toggle.
• Layout follows
• Repeat after
• Repeat speed
• Num Lock on at login
• Shortcut key: What Mod means in your shortcuts.

Mouse

• Speed
• Acceleration
• Natural scrolling
• Left-handed
• Middle click with both buttons

Trackpad

• Tap to click
• Natural scrolling
• Speed
• Ignore while typing
• Right click
• Off while a mouse is plugged in

Pointer

• Cursor
• Cursor size
• Hide while typing
• Focus follows the pointer: The window under the pointer takes the keyboard.
• Pointer jumps to the focused window

Battery

Warnings, suspend and charge limit.

Warnings

• Charged notice: Says when the battery reaches this level, so you can unplug.
• Low battery
• Critical battery
• Warning sounds

Suspend

• Suspend when almost empty
• At

Charge limit

• Limit charging: Stops charging early so the battery ages slower.
• Stop at

Gaming & Fullscreen

What iRiS steps back from while you play.

Fullscreen

• Notification banners: Over a fullscreen video or game.
• Volume and song pill: Quiet keeps volume, brightness and mic and drops songs and keyboard; Hidden shows nothing.

Game mode

• Turn on for fullscreen apps: Game mode starts by itself while a window is fullscreen and ends when it leaves.

• Stop shell animations: iRiS shapes appear in place while you play.

• Stop glass and blur

• Stop Niri animations

• Hold notifications: Banners wait until you are done; they still collect in Today.

• Stop audio visualizers

• Close the Discord overlay

• Hide reload notices: The small notice when your config reloads stays away while you play.

• Game mode

Lock Screen

What it shows, when it locks and how it reads.

Scene

• Behind everything: The desktop wallpaper, a picture of its own, or nothing but the material.
• Picture: Full path to the image or video the lock screen uses.
• Blur: 0 leaves the picture sharp.
• Colour left in the blur: How much of the picture’s colour survives.
• Dim
• Play live wallpapers: Off shows the first frame, which costs nothing while the screen is locked.
• Vignette: Darkens the corners so the middle carries the eye.
• Slow drift: The picture creeps and breathes instead of standing still.
• One pass takes
• Fit: Cover fills the screen and crops; contain shows the whole picture.
• Legibility wash: What keeps white text readable over a bright picture.
• Wash strength
• Plates: What the player, the field and the chips sit on.

Type

• Text size: Everything on the lock screen, together.
• Clock size
• Clock face: The typeface the hour is set in.
• Clock weight
• Clock tracking: Space between the digits.
• Clock format
• Seconds: Ticks every second while the screen is locked.
• Date
• Clock colour

Clock

• Clock
• Style
• Show the date
• Where it sits
• Size

At a glance

• At a glance: Small glass chips under the clock: the weather, what is next and the battery.
• Weather
• Next event
• Battery
• Where it sits
• Size

Now playing

• Now playing
• Style
• Where it sits
• Size

Activity

• Activity: A recording or a running timer, as a plate.
• Where it sits
• Size

Sign in

• Avatar
• Your name
• Hint under the field: Says what went wrong, or that the reader is waiting for a finger.
• Field width
• Where it sits
• Size

Status

• Status: Battery, network and keyboard layout, in small type.
• Battery
• Network
• Keyboard layout
• Where it sits
• Size

Security

• Lock when the session starts: Locks right after you sign in, for computers that log in on their own.
• Lock with Hyprlock: Hyprlock and its own look lock the screen instead of iRiS’s lock screen.
• Unlock the keyring: Your password also opens the login keyring, so apps stop asking for it.

When idle

• Turn the screen off after
• Lock after
• Suspend after
• Lock before sleeping
• Shorter times on battery
• On battery, screen off after
• On battery, lock after
• On battery, suspend after

Login Screen

Where you sign in after starting the computer.

Login Screen

• Login screen: Where you sign in after starting the computer.
• Login style: Cover shows your picture sharp, Frame hangs it in a mat, Lens cuts the time out of it.

Sources

Where the Island gets what it shows.

Weather

• Weather: The forecast every weather piece and widget shows.
• Latitude: With longitude, overrides the place.
• Longitude
• Fahrenheit: Degrees and distances in US units instead of Celsius and metric.
• Show my city: Off, no surface prints where you are: the Island, the lock screen, sidebars, widgets. For streams and screen sharing.
• Place: The city the forecast is for. Leave it empty and iRiS works it out from your connection, which is usually close but not always right.
• Use GPS when there is one: Asks geoclue instead of guessing from your connection.
• Check every

Network

• Browser identity: The user agent sent to wallpaper, news and image sites that refuse unknown clients.

Calendar

• Bring in other calendars: Google and iCal feeds show up beside your own events, in the calendar bubble and in Today.
• Calendars: What each feed brings in the next two weeks.
• Refresh every

Updates

• Look for updates every: How often the Updates bubble counts what is waiting.
• Update command: What the Updates bubble runs in your terminal.

New iNiR

• Watch for new iNiR versions: A bubble shows up on its own when there is a new iNiR upstream, and goes away once you update.
• Where it shows up: The bubble’s place while an update waits: a spot on the frame, or the Island.
• Check every
• Say it again after: If you leave an update sitting, iNiR brings it back this often, also after Not now.
• Update in a terminal: Opens a terminal for the update, so you can watch it run.

System readings

• Read every: How often CPU, memory, disk and temperatures refresh wherever iRiS shows them.
• Read the GPU: Adds the graphics card to what Vitals shows.