Compton配置中的选项有哪些

Compton 配置选项全览

一 基础与运行控制

• 配置文件与日志
  • config / config-file：指定配置文件路径，例如 ~/.config/compton.conf。
  • log-level / log-file / quiet / debug：日志级别（如 debug/info/warning/error）、输出文件、静默与调试开关。
• 合成开关与渲染后端
  • backend：渲染后端，常用 glx / xrender（部分构建可能支持 wayland）。
  • 合成总开关：disable-composite（禁用合成，极少使用）。
• 显示与刷新
  • vsync：开启/关闭垂直同步以减少撕裂。
  • frame-rate：限制合成帧率（如 60）。
  • max-frame-time / min-frame-time：帧时间上下限（单位毫秒，例如 16.67 对应 60 FPS）。

二 视觉效果参数

• 透明度与淡化
  • opacity / alpha / background-opacity：窗口/背景透明度（取值 0.0–1.0；也可用规则为不同窗口设不同透明度）。
  • fade / fade-in / fade-out：窗口出现/消失的淡入淡出动画。
  • ignore-root：忽略根窗口透明度，提升某些桌面环境下的稳定性。
• 阴影
  • shadow：全局阴影开关。
  • shadow-exclude：按窗口属性/正则排除阴影（如匹配特定类/标题）。
  • shadow-color / shadow-dim：阴影颜色与暗化强度。
• 模糊
  • blur / blur-background / blur-method / blur-radius / blur-size / blur-deviation：背景/区域模糊，算法如 gaussian，配合半径/强度等参数调节。
  • screen-edge-blur：屏幕边缘模糊。
• 其它视觉细节
  • mouse-pointer-shadow：鼠标指针阴影。

三 性能与调优

• 渲染与绕过
  • unredirect：是否对全屏窗口绕过合成以降低延迟（可能导致撕裂或特效受限）。
  • ignore-glx-glitz：忽略部分 OpenGL 加速路径以提升兼容性/稳定性。
• GLX 细节与高级渲染
  • glx-no-stencil / glx-fbconfig / glx-use-glxteximage2d / glx-use-dri3：GLX 相关细节，按硬件/驱动酌情开关。
  • custom shader：通过 shader-file 加载自定义片段着色器，及一系列 shader-* 参数控制效果细节。
• 资源与帧控制
  • max-cpu-usage：限制最大 CPU 占用（如 80%）。
  • max-frame-time / min-frame-time / frame-rate：进一步约束帧时间/帧率，平衡功耗与流畅度。

四 窗口规则与忽略列表

• 窗口选择
  • shadow-exclude / ignore-windows：按窗口类、实例、标题、角色等匹配并排除/忽略特定窗口（支持正则）。
• 透明度规则
  • opacity-rule：为匹配到的窗口设置固定或范围透明度，例如：[“90:class_g ‘Firefox’”, “100:class_g ‘Xephyr’”]。

五 配置示例与生效方式

• 示例配置（~/.config/compton.conf）

  [general]
  backend = "glx"
  vsync = true
  log-level = "info"
  
  [shadow]
  shadow = true
  shadow-exclude = [ "name = 'Conky'", "class_g = 'Polybar'" ]
  
  [blur]
  method = "gaussian"
  size = 10
  deviation = 5.0
  
  [fading]
  fade = true
  fade-in = true
  fade-out = true
  
  [opacity-rule]
  ["90:class_g 'Firefox'"]
  ["100:class_g 'Xephyr'"]
  

• 启动与热重载
  • 直接启动：compton --config ~/.config/compton.conf -f
  • 重启生效：killall compton && compton -f
  • 使用 systemd 服务：创建服务单元，ExecStart 指向带 –config 的 compton 命令，然后 systemctl enable --now compton。