Files
niri/Gestures.html
T
2026-06-18 11:14:14 +00:00

1950 lines
42 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link rel="canonical" href="https://niri-wm.github.io/niri/Gestures.html">
<link rel="prev" href="Xwayland.html">
<link rel="next" href="Fullscreen-and-Maximize.html">
<link rel="icon" href="_assets/icons/logo.svg">
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.6.15">
<title>Gestures - niri</title>
<link rel="stylesheet" href="assets/stylesheets/main.342714a4.min.css">
<link rel="stylesheet" href="assets/stylesheets/palette.06af60db.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<link rel="stylesheet" href="_assets/stylesheets/niri.css">
<script>__md_scope=new URL(".",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
</head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="indigo">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#overview" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="." title="niri" class="md-header__button md-logo" aria-label="niri" data-md-component="logo">
<img src="_assets/icons/logo.svg" alt="logo">
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
niri
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
Gestures
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="indigo" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9zM20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12zm-9.15 3.96h2.3L12 9z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="indigo" aria-label="Switch to system preference" type="radio" name="__palette" id="__palette_2">
<label class="md-header__button md-icon" title="Switch to system preference" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
</label>
</form>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
</button>
</nav>
<div class="md-search__suggest" data-md-component="search-suggest"></div>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://github.com/niri-wm/niri" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
</div>
<div class="md-source__repository">
GitHub
</div>
</a>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="." title="niri" class="md-nav__button md-logo" aria-label="niri" data-md-component="logo">
<img src="_assets/icons/logo.svg" alt="logo">
</a>
niri
</label>
<div class="md-nav__source">
<a href="https://github.com/niri-wm/niri" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg>
</div>
<div class="md-source__repository">
GitHub
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" checked>
<label class="md-nav__link" for="__nav_1" id="__nav_1_label" tabindex="0">
<span class="md-ellipsis">
Usage
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_1">
<span class="md-nav__icon md-icon"></span>
Usage
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="Getting-Started.html" class="md-nav__link">
<span class="md-ellipsis">
Getting Started
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Example-systemd-Setup.html" class="md-nav__link">
<span class="md-ellipsis">
Example systemd Setup
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Important-Software.html" class="md-nav__link">
<span class="md-ellipsis">
Important Software
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Workspaces.html" class="md-nav__link">
<span class="md-ellipsis">
Workspaces
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Floating-Windows.html" class="md-nav__link">
<span class="md-ellipsis">
Floating Windows
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Tabs.html" class="md-nav__link">
<span class="md-ellipsis">
Tabs
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Overview.html" class="md-nav__link">
<span class="md-ellipsis">
Overview
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Screencasting.html" class="md-nav__link">
<span class="md-ellipsis">
Screencasting
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Layer%E2%80%90Shell-Components.html" class="md-nav__link">
<span class="md-ellipsis">
LayerShell Components
</span>
</a>
</li>
<li class="md-nav__item">
<a href="IPC.html" class="md-nav__link">
<span class="md-ellipsis">
IPC, niri msg
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Application-Issues.html" class="md-nav__link">
<span class="md-ellipsis">
Application-Specific Issues
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Nvidia.html" class="md-nav__link">
<span class="md-ellipsis">
Nvidia
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Xwayland.html" class="md-nav__link">
<span class="md-ellipsis">
Xwayland
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
Gestures
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="Gestures.html" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
Gestures
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#overview" class="md-nav__link">
<span class="md-ellipsis">
Overview
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#mouse" class="md-nav__link">
<span class="md-ellipsis">
Mouse
</span>
</a>
<nav class="md-nav" aria-label="Mouse">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#interactive-move" class="md-nav__link">
<span class="md-ellipsis">
Interactive Move
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#interactive-resize" class="md-nav__link">
<span class="md-ellipsis">
Interactive Resize
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#reset-window-height" class="md-nav__link">
<span class="md-ellipsis">
Reset Window Height
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#toggle-full-width" class="md-nav__link">
<span class="md-ellipsis">
Toggle Full Width
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#horizontal-view-movement" class="md-nav__link">
<span class="md-ellipsis">
Horizontal View Movement
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#workspace-switch" class="md-nav__link">
<span class="md-ellipsis">
Workspace Switch
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#touchpad" class="md-nav__link">
<span class="md-ellipsis">
Touchpad
</span>
</a>
<nav class="md-nav" aria-label="Touchpad">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#workspace-switch_1" class="md-nav__link">
<span class="md-ellipsis">
Workspace Switch
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#horizontal-view-movement_1" class="md-nav__link">
<span class="md-ellipsis">
Horizontal View Movement
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#open-and-close-the-overview" class="md-nav__link">
<span class="md-ellipsis">
Open and Close the Overview
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#all-pointing-devices" class="md-nav__link">
<span class="md-ellipsis">
All Pointing Devices
</span>
</a>
<nav class="md-nav" aria-label="All Pointing Devices">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#drag-and-drop-edge-view-scroll" class="md-nav__link">
<span class="md-ellipsis">
Drag-and-Drop Edge View Scroll
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#drag-and-drop-edge-workspace-switch" class="md-nav__link">
<span class="md-ellipsis">
Drag-and-Drop Edge Workspace Switch
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#drag-and-drop-hold-to-activate" class="md-nav__link">
<span class="md-ellipsis">
Drag-and-Drop Hold to Activate
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#hot-corner-to-toggle-the-overview" class="md-nav__link">
<span class="md-ellipsis">
Hot Corner to Toggle the Overview
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="Fullscreen-and-Maximize.html" class="md-nav__link">
<span class="md-ellipsis">
Fullscreen and Maximize
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Window-Effects.html" class="md-nav__link">
<span class="md-ellipsis">
Window Effects
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Packaging-niri.html" class="md-nav__link">
<span class="md-ellipsis">
Packaging niri
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Integrating-niri.html" class="md-nav__link">
<span class="md-ellipsis">
Integrating niri
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Security-Model.html" class="md-nav__link">
<span class="md-ellipsis">
Security Model
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Accessibility.html" class="md-nav__link">
<span class="md-ellipsis">
Accessibility
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Name-and-Logo.html" class="md-nav__link">
<span class="md-ellipsis">
Name and Logo
</span>
</a>
</li>
<li class="md-nav__item">
<a href="FAQ.html" class="md-nav__link">
<span class="md-ellipsis">
FAQ
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
<label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
<span class="md-ellipsis">
Configuration
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2">
<span class="md-nav__icon md-icon"></span>
Configuration
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="Configuration%3A-Introduction.html" class="md-nav__link">
<span class="md-ellipsis">
Introduction
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Input.html" class="md-nav__link">
<span class="md-ellipsis">
Input
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Outputs.html" class="md-nav__link">
<span class="md-ellipsis">
Outputs
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Key-Bindings.html" class="md-nav__link">
<span class="md-ellipsis">
Key Bindings
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Switch-Events.html" class="md-nav__link">
<span class="md-ellipsis">
Switch Events
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Layout.html" class="md-nav__link">
<span class="md-ellipsis">
Layout
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Named-Workspaces.html" class="md-nav__link">
<span class="md-ellipsis">
Named Workspaces
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Miscellaneous.html" class="md-nav__link">
<span class="md-ellipsis">
Miscellaneous
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Window-Rules.html" class="md-nav__link">
<span class="md-ellipsis">
Window Rules
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Layer-Rules.html" class="md-nav__link">
<span class="md-ellipsis">
Layer Rules
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Animations.html" class="md-nav__link">
<span class="md-ellipsis">
Animations
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Gestures.html" class="md-nav__link">
<span class="md-ellipsis">
Gestures
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Recent-Windows.html" class="md-nav__link">
<span class="md-ellipsis">
Recent Windows
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Debug-Options.html" class="md-nav__link">
<span class="md-ellipsis">
Debug Options
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Configuration%3A-Include.html" class="md-nav__link">
<span class="md-ellipsis">
Include
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
<span class="md-ellipsis">
Development
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3">
<span class="md-nav__icon md-icon"></span>
Development
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="Development%3A-Design-Principles.html" class="md-nav__link">
<span class="md-ellipsis">
Design Principles
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Development%3A-Developing-niri.html" class="md-nav__link">
<span class="md-ellipsis">
Developing niri
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Development%3A-Documenting-niri.html" class="md-nav__link">
<span class="md-ellipsis">
Documenting niri
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Development%3A-Releasing-niri.html" class="md-nav__link">
<span class="md-ellipsis">
Releasing niri
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Development%3A-Fractional-Layout.html" class="md-nav__link">
<span class="md-ellipsis">
Fractional Layout
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Development%3A-Redraw-Loop.html" class="md-nav__link">
<span class="md-ellipsis">
Redraw Loop
</span>
</a>
</li>
<li class="md-nav__item">
<a href="Development%3A-Animation-Timing.html" class="md-nav__link">
<span class="md-ellipsis">
Animation Timing
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#overview" class="md-nav__link">
<span class="md-ellipsis">
Overview
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#mouse" class="md-nav__link">
<span class="md-ellipsis">
Mouse
</span>
</a>
<nav class="md-nav" aria-label="Mouse">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#interactive-move" class="md-nav__link">
<span class="md-ellipsis">
Interactive Move
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#interactive-resize" class="md-nav__link">
<span class="md-ellipsis">
Interactive Resize
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#reset-window-height" class="md-nav__link">
<span class="md-ellipsis">
Reset Window Height
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#toggle-full-width" class="md-nav__link">
<span class="md-ellipsis">
Toggle Full Width
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#horizontal-view-movement" class="md-nav__link">
<span class="md-ellipsis">
Horizontal View Movement
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#workspace-switch" class="md-nav__link">
<span class="md-ellipsis">
Workspace Switch
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#touchpad" class="md-nav__link">
<span class="md-ellipsis">
Touchpad
</span>
</a>
<nav class="md-nav" aria-label="Touchpad">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#workspace-switch_1" class="md-nav__link">
<span class="md-ellipsis">
Workspace Switch
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#horizontal-view-movement_1" class="md-nav__link">
<span class="md-ellipsis">
Horizontal View Movement
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#open-and-close-the-overview" class="md-nav__link">
<span class="md-ellipsis">
Open and Close the Overview
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#all-pointing-devices" class="md-nav__link">
<span class="md-ellipsis">
All Pointing Devices
</span>
</a>
<nav class="md-nav" aria-label="All Pointing Devices">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#drag-and-drop-edge-view-scroll" class="md-nav__link">
<span class="md-ellipsis">
Drag-and-Drop Edge View Scroll
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#drag-and-drop-edge-workspace-switch" class="md-nav__link">
<span class="md-ellipsis">
Drag-and-Drop Edge Workspace Switch
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#drag-and-drop-hold-to-activate" class="md-nav__link">
<span class="md-ellipsis">
Drag-and-Drop Hold to Activate
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#hot-corner-to-toggle-the-overview" class="md-nav__link">
<span class="md-ellipsis">
Hot Corner to Toggle the Overview
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<a href="https://github.com/niri-wm/niri/edit/main/docs/wiki/Gestures.md" title="Edit this page" class="md-content__button md-icon" rel="edit">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg>
</a>
<h1>Gestures</h1>
<h3 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">#</a></h3>
<p>There are several gestures in niri.</p>
<p>Also see the <a href="Configuration%3A-Gestures.html">gestures configuration</a> wiki page.</p>
<h3 id="mouse">Mouse<a class="headerlink" href="#mouse" title="Permanent link">#</a></h3>
<h4 id="interactive-move">Interactive Move<a class="headerlink" href="#interactive-move" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v0.1.10">Since: 0.1.10</a></span></p>
<p>You can move windows by holding <kbd>Mod</kbd> and the left mouse button.</p>
<p>You can customize the look of the window insertion preview in the <a href="Configuration%3A-Layout.html#insert-hint"><code>insert-hint</code> layout config</a>.</p>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v25.01">Since: 25.01</a></span> Right click while moving to toggle between floating and tiling layout to put the window into.</p>
<h4 id="interactive-resize">Interactive Resize<a class="headerlink" href="#interactive-resize" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v0.1.6">Since: 0.1.6</a></span></p>
<p>You can resize windows by holding <kbd>Mod</kbd> and the right mouse button.</p>
<h4 id="reset-window-height">Reset Window Height<a class="headerlink" href="#reset-window-height" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v0.1.6">Since: 0.1.6</a></span></p>
<p>If you double-click on a top or bottom tiled window resize edge, the window height will reset to automatic.</p>
<p>This works with both window-initiated resizes (when using client-side decorations), and niri-initiated <kbd>Mod</kbd> + right click resizes.</p>
<h4 id="toggle-full-width">Toggle Full Width<a class="headerlink" href="#toggle-full-width" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v0.1.6">Since: 0.1.6</a></span></p>
<p>If you double-click on a left or right tiled window resize edge, the column will expand to the full workspace width.</p>
<p>This works with both window-initiated resizes (when using client-side decorations), and niri-initiated <kbd>Mod</kbd> + right click resizes.</p>
<h4 id="horizontal-view-movement">Horizontal View Movement<a class="headerlink" href="#horizontal-view-movement" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v0.1.6">Since: 0.1.6</a></span></p>
<p>Move the view horizontally by holding <kbd>Mod</kbd> and the middle mouse button (or the wheel) and dragging the mouse horizontally.</p>
<h4 id="workspace-switch">Workspace Switch<a class="headerlink" href="#workspace-switch" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v0.1.7">Since: 0.1.7</a></span></p>
<p>Switch workspaces by holding <kbd>Mod</kbd> and the middle mouse button (or the wheel) and dragging the mouse vertically.</p>
<h3 id="touchpad">Touchpad<a class="headerlink" href="#touchpad" title="Permanent link">#</a></h3>
<h4 id="workspace-switch_1">Workspace Switch<a class="headerlink" href="#workspace-switch_1" title="Permanent link">#</a></h4>
<p>Switch workspaces with three-finger vertical swipes.</p>
<h4 id="horizontal-view-movement_1">Horizontal View Movement<a class="headerlink" href="#horizontal-view-movement_1" title="Permanent link">#</a></h4>
<p>Move the view horizontally with three-finger horizontal swipes.</p>
<h4 id="open-and-close-the-overview">Open and Close the Overview<a class="headerlink" href="#open-and-close-the-overview" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v25.05">Since: 25.05</a></span></p>
<p>Open and close the overview with a four-finger vertical swipe.</p>
<h3 id="all-pointing-devices">All Pointing Devices<a class="headerlink" href="#all-pointing-devices" title="Permanent link">#</a></h3>
<h4 id="drag-and-drop-edge-view-scroll">Drag-and-Drop Edge View Scroll<a class="headerlink" href="#drag-and-drop-edge-view-scroll" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v25.02">Since: 25.02</a></span></p>
<p>Scroll the tiling view when moving the mouse cursor against a monitor edge during drag-and-drop (DnD).
Also works on a touchscreen.</p>
<h4 id="drag-and-drop-edge-workspace-switch">Drag-and-Drop Edge Workspace Switch<a class="headerlink" href="#drag-and-drop-edge-workspace-switch" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v25.05">Since: 25.05</a></span></p>
<p>Scroll the workspaces up/down when moving the mouse cursor against a monitor edge during drag-and-drop (DnD) while in the overview.
Also works on a touchscreen.</p>
<h4 id="drag-and-drop-hold-to-activate">Drag-and-Drop Hold to Activate<a class="headerlink" href="#drag-and-drop-hold-to-activate" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v25.05">Since: 25.05</a></span></p>
<p>While drag-and-dropping, hold your mouse over a window to activate it.
This will bring a floating window to the top for example.</p>
<p>In the overview, you can also hold the mouse over a workspace to switch to it.</p>
<h4 id="hot-corner-to-toggle-the-overview">Hot Corner to Toggle the Overview<a class="headerlink" href="#hot-corner-to-toggle-the-overview" title="Permanent link">#</a></h4>
<p><span class="badge"><a href="https://github.com/niri-wm/niri/releases/tag/v25.05">Since: 25.05</a></span></p>
<p>Put your mouse at the very top-left corner of a monitor to toggle the overview.
Also works during drag-and-dropping something.</p>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": ".", "features": ["navigation.instant", "search.suggest", "content.code.copy", "content.action.edit"], "search": "assets/javascripts/workers/search.d50fe291.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
<script src="assets/javascripts/bundle.56ea9cef.min.js"></script>
</body>
</html>