Universal Wayland Session Manager - 版の履歴

Pikosip: 和訳の修正(参照実装->リファレンス実装)

2025-06-13T10:19:30Z

和訳の修正(参照実装->リファレンス実装)

← 古い版		2025年6月13日 (金) 19:19時点における版
3行目:		3行目:
	[https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager]('''uwsm''')は、スタンドアロンの[[Wayland#コンポジタ\|Wayland コンポジタ]] をオンザフライで [[systemd]] ユニットのセットにラップします。これにより、環境設定、[[XDG Autostart]] のサポート、ログインセッションとの双方向バインディング、クリーンシャットダウンを含む堅牢なセッション管理が提供されます。		[https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager]('''uwsm''')は、スタンドアロンの[[Wayland#コンポジタ\|Wayland コンポジタ]] をオンザフライで [[systemd]] ユニットのセットにラップします。これにより、環境設定、[[XDG Autostart]] のサポート、ログインセッションとの双方向バインディング、クリーンシャットダウンを含む堅牢なセッション管理が提供されます。

	{{Note\|[[D-Bus#dbus-broker\|dbus-broker]] を D-Bus デーモンの実装として使用することが強く推奨されます。その他の利点として、systemdのアクティベーション環境を再利用し、別の環境を持つことがないため、環境管理が簡素化され、適切なクリーンアップが可能になります。[[D-Bus#Reference_implementation\|参照実装]] もサポートされていますが、変数の解除ができないため、代わりに空の文字列を設定して最善の努力でクリーンアップが行われます。D-Bus デーモンの別々の環境を適切にクリーンアップする唯一の方法は、{{ic\|loginctl terminate-user ""}}を実行することです。}}		{{Note\|[[D-Bus#dbus-broker\|dbus-broker]] を D-Bus デーモンの実装として使用することが強く推奨されます。その他の利点として、systemdのアクティベーション環境を再利用し、別の環境を持つことがないため、環境管理が簡素化され、適切なクリーンアップが可能になります。[[D-Bus#Reference_implementation\|リファレンス実装]] もサポートされていますが、変数の解除ができないため、代わりに空の文字列を設定して最善の努力でクリーンアップが行われます。D-Bus デーモンの別々の環境を適切にクリーンアップする唯一の方法は、{{ic\|loginctl terminate-user ""}}を実行することです。}}

	== インストール ==		== インストール ==

Pikosip: 和訳の修正(システムd->systemd)

2025-06-13T10:17:34Z

和訳の修正(システムd->systemd)

← 古い版		2025年6月13日 (金) 19:17時点における版
3行目:		3行目:
	[https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager]('''uwsm''')は、スタンドアロンの[[Wayland#コンポジタ\|Wayland コンポジタ]] をオンザフライで [[systemd]] ユニットのセットにラップします。これにより、環境設定、[[XDG Autostart]] のサポート、ログインセッションとの双方向バインディング、クリーンシャットダウンを含む堅牢なセッション管理が提供されます。		[https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager]('''uwsm''')は、スタンドアロンの[[Wayland#コンポジタ\|Wayland コンポジタ]] をオンザフライで [[systemd]] ユニットのセットにラップします。これにより、環境設定、[[XDG Autostart]] のサポート、ログインセッションとの双方向バインディング、クリーンシャットダウンを含む堅牢なセッション管理が提供されます。

	{{Note\|[[D-Bus#dbus-broker\|dbus-broker]] を D-Bus デーモンの実装として使用することが強く推奨されます。その他の利点として、~~システムd~~のアクティベーション環境を再利用し、別の環境を持つことがないため、環境管理が簡素化され、適切なクリーンアップが可能になります。[[D-Bus#Reference_implementation\|参照実装]] もサポートされていますが、変数の解除ができないため、代わりに空の文字列を設定して最善の努力でクリーンアップが行われます。D-Bus デーモンの別々の環境を適切にクリーンアップする唯一の方法は、{{ic\|loginctl terminate-user ""}}を実行することです。}}		{{Note\|[[D-Bus#dbus-broker\|dbus-broker]] を D-Bus デーモンの実装として使用することが強く推奨されます。その他の利点として、systemdのアクティベーション環境を再利用し、別の環境を持つことがないため、環境管理が簡素化され、適切なクリーンアップが可能になります。[[D-Bus#Reference_implementation\|参照実装]] もサポートされていますが、変数の解除ができないため、代わりに空の文字列を設定して最善の努力でクリーンアップが行われます。D-Bus デーモンの別々の環境を適切にクリーンアップする唯一の方法は、{{ic\|loginctl terminate-user ""}}を実行することです。}}

	== インストール ==		== インストール ==

Kgx: 翻訳

2025-02-13T18:01:41Z

翻訳

差分を表示

Kgx: 英語版から転載

2025-02-13T17:33:14Z

英語版から転載

新規ページ

[[Category:グラフィカルユーザーインターフェイス]]
[[en:Universal Wayland Session Manager]]
The [https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager] ('''uwsm''') wraps standalone [[Wayland#Compositors|Wayland compositors]] into a set of [[systemd]] units on the fly. This provides robust session management including environment, [[XDG Autostart]] support, bi-directional binding with login session, and clean shutdown.

{{Note|It is highly recommended to use [[Dbus-broker|dbus-broker]] as the D-Bus daemon implementation. Among other benefits, it reuses the systemd activation environment instead of having a separate one. This simplifies environment management and allows proper cleanup. The [[D-Bus#Reference_implementation|reference implementation]]
is also supported, but it does not allow unsetting vars, so a best effort cleanup is performed by setting them to an empty string instead. The only way to properly clean up the separate environment of the reference D-Bus daemon is to run {{ic|loginctl terminate-user ""}}.}}

== Installation ==

[[Install]] the {{Pkg|uwsm}} package.

== Configuration ==

=== Service startup notification and vars set by compositor ===

{{Note|If managed compositors already set {{ic|WAYLAND_DISPLAY}} (and other useful environment variables) into the systemd activation environment, then you can skip this section and you do not need to use {{ic|uwsm finalize}}.}}

In order to find the current compositor wayland applications need the {{ic|WAYLAND_DISPLAY}} (or {{ic|DISPLAY}} variable, if they are intended to run through [[Wayland#Xwayland|Xwayland]]). Therefore this and other useful environment variables should be put into the systemd/dbus activation environment once the compositor has set their value.

The command {{ic|uwsm finalize}} puts {{ic|WAYLAND_DISPLAY}}, {{ic|DISPLAY}} and other environment variables listed via the whitespace-separated {{ic|UWSM_FINALIZE_VARNAMES}} list into the activation environment. Therefore you need to execute this command after the compositor is ready.

If other variables set by the compositors are needed in your activation environment, then you can also pass them as arguments:

exec uwsm finalize ''VAR1'' ''VAR2'' ''...''

=== Environment variables ===

All environment variables set in {{ic|${XDG_CONFIG_HOME}/uwsm/env}} file are sourced by ''uwsm'' and available to all managed compositors and graphical applications run inside such a session.

If you need certain environment variables to be set only for a specific ''compositor'' (and graphical applications in that graphical session), then put them in {{ic|${XDG_CONFIG_HOME}/uwsm/env-''compositor''}} instead.

All these files should set environment variables with the following format:

{{bc|export ''KEY1''{{=}}''VAR1''
export ''KEY2''{{=}}''VAR2''
export ''KEY3''{{=}}''VAR3''
''...''}}

and should not contain comments.

== Usage ==

=== Startup ===

''uwsm'' can be started both by TTY and by a [[display manager]].

==== TTY ====

Add in your {{ic|~/.profile}} file:

{{bc|if uwsm check may-start && uwsm select; then
exec uwsm start default
fi}}

If you want to always start the same ''compositor'', then you can use instead in your {{ic|~/.profile}} file:

{{bc|if uwsm check may-start; then
exec uwsm start ''compositor''.desktop
fi}}

==== Display manager ====

You can create a custom session desktop entry which starts your compositor through ''uwsm'':

{{hc|/usr/share/wayland-sessions/my-compositor-uwsm.desktop|[Desktop Entry]
Name{{=}}My compositor (with UWSM)
Comment{{=}}My cool compositor, UWSM session

# either full command line with metadata and executable
Exec{{=}}uwsm start -N "My compositor" -D mycompositor:mylib -C "My cool compositor" -- my-compositor

# or a reference to another entry
Exec{{=}}uwsm start -- my-compositor.desktop

DesktopNames{{=}}mycompositor;mylib
Type{{=}}Application}}

=== Session termination ===

If you want to terminate the current uwsm session, then you should use either {{ic|loginctl terminate-user ""}} (terminates the entire user session) or {{ic|uwsm stop}} (executes code after {{ic|uwsm start}} or terminates user session, if it replaced the [[login shell]]).

{{Warning|Do not use a compositor's native exit mechanism or kill its process directly. This will yank the compositor from under all the clients and interfere with ordered unit deactivation sequence.}}