Labwcのソースを表示

[[Category:Wayland コンポジタ]]
{{Related articles start}}
{{Related|ウィンドウマネージャ}}
{{Related|Wayland#コンポジタ}}
{{Related articles end}}

Labwc は Lab Wayland Compositor[https://github.com/labwc/labwc/blob/master/README.md] の略です。
[https://labwc.github.io/ 公式ウェブサイト]によると：

:Labwc は wlroots ベースのウィンドウスタッキングコンポジターで、Wayland 用に開発されました。openbox に触発されています。
:軽量で独立しており、ウィンドウを効果的にスタックし、いくつかのウィンドウ装飾を描画することに焦点を当てています。パネル、スクリーンショット、壁紙などをクライアントに依存して、フルデスクトップ環境を作成します。
:Labwc は、一般的なアプローチとコーディングスタイルの点で wlroots や sway と一致しようと試みています。
:Labwc は、wayland-protocols と wlr-protocols のみを理解し、dbus や sway/i3-IPC などの他の技術で制御することはできません。その理由は、カスタム IPC とプロトコルが Wayland の一般的な採用を妨げるフラグメンテーションを作り出すと考えているからです。

== インストール ==

Labwc は、パッケージ {{AUR|labwc}} または {{AUR|labwc-git}} で[[インストール]]できます。

デフォルトの[[ターミナルエミュレータ]]は {{Pkg|foot}} です。''labwc'' を開始する前に、それをインストールするか、設定で新しいターミナルを設定することが推奨されます。

== Configuration ==

{{Style|Multiple sections duplicate [https://labwc.github.io/getting-started.html upstream documentation]. Missing [[Template:ic]] and [[Template:man]] between other misc visual adjustments.}}

Openbox 3.6 specification is used for configuration and theme syntaxes.  
Config layout for ~/.config/labwc/ :

:- autostart
:- environment
:- menu.xml
:- rc.xml
:- themerc-override

See `man labwc-config and `man labwc-theme` for further details. rc.xml.all contain default settings with all options.

copy the sample configuration files located at {{ic|/usr/share/doc/labwc/}} to {{ic|~/.config/labwc/}}. 

see [https://labwc.github.io/integration.html integration] for more configuration

=== Autostart ===

~/.config/labwc/autostart is used as autostart.

=== Keymap ===

On  ~/.config/labwc/environment 

The following keyboard-configuration variables are supported: XKB_DEFAULT_RULES, XKB_DEFAULT_MODEL, XKB_DEFAULT_LAYOUT, XKB_DEFAULT_VARIANT and  XKB_DEFAULT_OPTIONS. :
 XKB_DEFAULT_LAYOUT=us
 XKB_DEFAULT_LAYOUT=us,de
 XKB_DEFAULT_OPTIONS=grp:alt_shift_toggle
 XKB_DEFAULT_OPTIONS=grp:shift_caps_toggle
for details see {{man|7|xkeyboard-config}}

=== Typematic delay and rate ===

To change typematic delay and rate, you can add the following lines to your input section, these are default value:
{{hc|~/.config/labwc/rc.xml|
<keyboard>
<repeatRate>25</repeatRate>
<repeatDelay>600</repeatDelay>
</keyboard>
}}

=== Statusbar ===

{{Pkg|waybar}} can be used.
{{hc|~/.config/labwc/autostart|
waybar >/dev/null 2>&1 &
}}
to enable a taskbar through the toplevel-foreign protocol in {{man|5|waybar-wlr-taskbar}}
{{hc|~/.config/waybar/config|
"modules-left": ["wlr/taskbar"],

 "wlr/taskbar": {
        "format": "{app_id}",
        "on-click": "minimize-raise",
    },
 }}

=== Outputs ===

external tools like {{Pkg|wlr-randr}},{{Pkg|kanshi}} {{hc|~/.config/labwc/autostart|
wlr-randr --output HDMI-A-2 --preferred --pos 0,0 --output HDMI-A-1 --preferred --pos -1920,0

}}

==== Wallpaper ====

use autostart and wallpaper [https://github.com/swaywm/sway/wiki/Useful-add-ons-for-sway#wallpaper setter] like {{Pkg|swaybg}}, {{Pkg|wallutils}}, {{Pkg|wpaperd}}, {{Aur|wbg}} etc
{{hc|~/.config/labwc/autostart|
swaybg -c '#113344' >/dev/null 2>&1 &
}}

=== Custom keybindings ===

{{hc|~/.config/labwc/rc.xml|
<keyboard>
<keybind key{{=}}"W-d"> <action name{{=}}"Execute" command{{=}}"fuzzel"/> </keybind>
<keybind key{{=}}"XF86_AudioLowerVolume">  <action name{{=}}"Execute" command{{=}}"wpctl set-volume  @DEFAULT_AUDIO_SINK@ 5%-"/> </keybind>
<keybind key{{=}}"XF86_AudioRaiseVolume"> <action name{{=}}"Execute" command{{=}}"wpctl set-volume  @DEFAULT_AUDIO_SINK@ 5%+"/> </keybind>
<keybind key{{=}}"XF86_AudioMute"> <action name{{=}}"Execute" command{{=}}"wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle "/> </keybind>
<keybind key{{=}}"XF86_MonBrightnessUp"> <action name{{=}}"Execute" command{{=}}"brightnessctl -e set 5%+"/> </keybind>
<keybind key{{=}}"XF86_MonBrightnessDown"> <action name{{=}}"Execute" command{{=}}"brightnessctl -e set 5%-"/> </keybind>
</keyboard>
}}

==== workspaces ====

{{hc|~/.config/labwc/rc.xml|
<labwc_config>
<desktops number{{=}}"4" />
<keyboard>
<keybind key{{=}}"W-1">  <action name{{=}}"GoToDesktop" to{{=}}"1" />  </keybind>
<keybind key{{=}}"W-2"> <action name{{=}}"GoToDesktop" to{{=}}"2" />  </keybind>
<keybind key{{=}}"W-3"> <action name{{=}}"GoToDesktop" to{{=}}"3" /> </keybind>
<keybind key{{=}}"W-4"> <action name{{=}}"GoToDesktop" to{{=}}"4" /> </keybind>
</keyboard>

</labwc_config>
}}

=== Menu ===

it uses openbox sepecification menu. see /usr/share/doc/labwc/menu.xml and man labwc-menu. you can also use automatic menu generators for openbox like {{Pkg|archlinux-xdg-menu}},  {{Aur|obmenu-generator}},etc 

example:
 <?xml version="1.0" ?>
 <openbox_menu>
 <menu id="root-menu" label="">
 <item label="󰈹   Firefox">
    <action name="Execute" command="firefox" />
  </item>
  <item label="  Terminal">
    <action name="Execute" command="foot" />
  </item>
  </menu>
  </openbox_menu>

=== Xwayland ===

it starts {{Pkg|xorg-xwayland}} automatically if xwayland support is enabled at build time.
to force disable it set:
{{hc|~/.config/labwc/enviroment|
WLR_XWAYLAND{{=}}' '
}}

== Starting ==

Like all wlroots based compositor for  seat it needs {{Pkg|polkit}} when using systemd-logind or {{Pkg|seatd}} service with your user added to {{ic|seat}} [[user group]]

To start Labwc,  type {{ic|labwc}} in the Linux console.

{{ic|labwc -s foot}} to start labwc with foot running.

== See also ==

* [https://github.com/labwc/labwc GitHub project]
* [https://labwc.github.io/ Website]