ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

OmniWM settings.toml完全参考:如何用单个TOML文件掌控全部配置

OmniWM settings.toml完全参考:如何用单个TOML文件掌控全部配置 OmniWM settings.toml完全参考如何用单个TOML文件掌控全部配置【免费下载链接】OmniWMFree, open-source tiling window manager for Apple Silicon Macs, with Niri-style scrolling containers and Hyprland-style Dwindle BSP.项目地址: https://gitcode.com/gh_mirrors/om/OmniWMOmniWM 是一款面向 Apple Silicon Mac 的免费开源平铺窗口管理器tiling window manager支持 Niri 风格滚动容器与 Hyprland 风格 Dwindle BSP 布局。它的全部可编辑配置都集中在一个文件里settings.toml。这份 settings.toml 完全参考将带你逐张表读懂这个文件——布局、间距、快捷键、工作区、应用规则、每显示器覆盖项——一次讲清如何用它掌控 OmniWM 的全部行为。settings.toml 在哪里先找到这个文件OmniWM 把可编辑配置统一存放在标准位置默认路径为~/.config/omniwm/settings.toml如果你设置了XDG_CONFIG_HOME且为绝对路径文件会放在$XDG_CONFIG_HOME/omniwm/settings.toml菜单图标 →Reveal Settings File可在访达中定位该文件Edit Settings File直接打开编辑器即使文件被误删这两个命令也会按当前运行中的配置重建一份完整文件另一个重要特性是热加载在编辑器中保存settings.toml后立即生效无需重启而在设置窗口中做的修改也会写回这个文件。两者共享同一份“规范源”canonical source详见官方配置指南 configuration.md。文件骨架schemaVersion 3 与主表总览当前文件头部声明schemaVersion 3这是第 3 代严格模式 schema。整个文件按固定顺序组织为若干表[table]和表数组[[array]]表 / 数组管什么[general]全局快捷键总开关、Hyper 键、默认布局、更新检查、IPC、动画[focus]焦点跟随鼠标、屏幕边缘焦点/移动行为[gaps]平铺窗口内外间距[niri]/[dwindle]两套布局引擎各自的参数[borders]焦点窗口边框、渐变、光晕[workspaceBar]工作区栏外观与行为[gestures]鼠标与触控板手势[quakeTerminal]下拉式Quake终端[[hotkeys]]每个可绑定动作一条快捷键记录[[workspaces]]工作区定义名称、所属显示器、布局[[appRules]]按应用/窗口标题的规则最小尺寸、浮动等[[monitor*Overrides]]每显示器的覆盖项完整键位表见官方参考 settings-reference.md源码层的权威 schema 在 CanonicalTOMLConfig.swift默认值定义在 BuiltInSettingsDefaults.swift。核心配置速览最常改的几组键[general] 与 [focus]全局行为开关[general]是全局总闸[general] hotkeysEnabled true # 全局快捷键总开关 defaultLayoutType niri # 未指定布局的工作区使用 niri 或 dwindle ipcEnabled false # 启用后 omniwmctl 命令行才可用 animationsEnabled true[focus]控制指针与焦点的交互方式新手最值得关注的两个键followsMouse true指针进入窗口即聚焦无需点击moveCrossesMonitorAtEdge true方向键移动窗口到边缘时自动跨显示器[niri] 与 [dwindle]两套布局引擎各自调参OmniWM 的工作区可二选一切换布局两个表各自独立调参Niri方向感知滚动容器——横向屏幕窗口组成左右滚动的列纵向屏幕组成上下滚动的行[niri] visibleContainerCount 2 # 视口中并排显示的容器列数 centerFocusedColumn never # never / always / onOverflow singleWindowFit fill # 单独窗口大小fill / WIDTHxHEIGHT / container_primary_spanDwindleBSP 二叉空间划分——每开一个窗口就切分一次空间[dwindle] smartSplit false # 按光标位置自动选择切分方向 defaultSplitRatio 1.0 # 1.0 均分1 第一个窗口更大 useGlobalGaps true # 是否沿用 [gaps] 的间距[gaps]的size默认 16 点控制窗口内间距outer.left/right/top/bottom控制屏幕边缘外间距默认全为 0。[borders] 与 [appearance]一眼区分焦点窗口焦点窗口默认带 5 点宽的青色边框[borders]还可以叠加gradient双色线性渐变边框topLeftToBottomRight/topRightToBottomLeftglow边框外发光radius0–32、opacity0–1darkColor深色模式下的独立配色随系统外观实时切换[appearance].mode则控制 OmniWM 自身界面用automatic、light还是dark。[[workspaceBar]]顶部工作区栏工作区栏显示每个工作区的打开应用支持位置overlappingMenuBar/belowMenuBar、高度、背景不透明度、刘海notch处理模式等iconOverrides甚至可为指定 Bundle ID 换自定义图标支持文件路径或bundle-resource:内部资源。[[hotkeys]]严格校验的快捷键数组这是全文件最严格的部分每个可绑定动作必须恰好出现一次多一条、少一条、重复或未知 id 都会导致整个文件被拒收。改键位时只改binding值不要增删条目[[hotkeys]] binding Option1 id switchWorkspace.0 # 注意0 对应工作区 1 [[hotkeys]] binding Unassigned id toggleScratchpad.1binding支持Hyper简写展开为 [general].hyperKeyModifiers默认ControlOptionShiftCommand。所有默认键位可在 README.md 的 Keyboard Shortcuts 一节查到。[[workspaces]] 与 [[appRules]]组织与规则[[workspaces]]默认定义 9 个工作区1–9每条含稳定idUUID编辑时保持不变、name、可选displayName欢迎用 emoji ❤️、所属显示器与layoutTypedefault/niri/dwindle[[appRules]]按 Bundle ID、窗口标题子串/正则匹配窗口可为其指定浮动、指定工作区、最小宽高等出厂自带 13 条针对 Safari、Chrome、Firefox、Discord 等应用的尺寸下限规则每显示器覆盖同一个设置不同屏幕文件尾部的五组数组允许按显示器“打补丁”未写的键自动回落到全局值monitorBarOverrides栏外观、monitorOrientationOverrides横/纵朝向、monitorNiriOverrides、monitorDwindleOverrides、monitorGapOverrides间距。例如给某块 2K 屏单独把innerGap设为 8只需一行[[monitorGapOverrides]]。安全编辑规则严格 schema 下的正确姿势版本 3 的校验是整文件级别的记住三条原则即可安全手改只改值不删键——缺一个必填键整个文件无效OmniWM 会以默认配置启动并在诊断中报告枚举值要写对——字符串键如defaultLayoutType niri取值不对会拒收整个文件手势指头数不能冲突——[gestures]中多个启用手势共用同一指头数会整体拒收出错时的恢复机制也很完善解析失败的文件保持原样不被改动若你之后从设置窗口保存OmniWM 会先把被拒的字节备份为settings.toml.corrupt再替换旧版本文件v0–v2会自动迁移并先写入settings.toml.pre-v3一次性备份。细节见 configuration.md 的自动版本升级章节。上手建议三步定制你的 OmniWM先用Settings → Edit Settings File打开settings.toml通读一遍建立整体印象从[gaps]、[general].defaultLayoutType、[[hotkeys]]三个最常用处开始改每次改完保存即可热生效遇到不认识的键不要删——未识别键会被保存保留并由诊断报告可对照 settings-reference.md 逐个确认运行时状态剪贴板历史、窗口恢复目录、Quake 终端自定义尺寸等刻意存放在~/.local/state/omniwm不混入配置文件方便你用 dotfiles 管理这一个 TOML。一个文件、热加载、严格校验——这就是 OmniWM settings.toml 的设计哲学把全部配置装进一个可版本管理的 TOML 里改完即生效。【免费下载链接】OmniWMFree, open-source tiling window manager for Apple Silicon Macs, with Niri-style scrolling containers and Hyprland-style Dwindle BSP.项目地址: https://gitcode.com/gh_mirrors/om/OmniWM创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表