「キーボードバックライト」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(スタイル修正)
(→‎On GNOME: 飜訳)
 
(同じ利用者による、間の8版が非表示)
1行目: 1行目:
 
[[Category:キーボード]]
 
[[Category:キーボード]]
 
[[en:Keyboard backlight]]
 
[[en:Keyboard backlight]]
  +
キーボードのバックライトの輝度レベルを制御するには、さまざまな方法があります。
 
== 全メーカー共通 ==
 
== 全メーカー共通 ==
  +
  +
明るさのレベルを管理する方法はさまざまで、{{Pkg|brightnessctl}} や {{Pkg|light}} など、これを実現するためのヘルパーツールもさまざまです。
  +
  +
{{ic|sys}} 疑似ファイルシステムは、キーボードバックライトへのインタフェースを公開します。現在の輝度レベルは {{ic|/sys/class/leds/tpacpi::kbd_backlight/brightness}} を読むことで得られます。例えば、最大の輝度レベルを得るには、以下のようにします。
  +
  +
$ cat /sys/class/leds/tpacpi::kbd_backlight/max_brightness
  +
  +
明るさを 1 に設定する
  +
  +
# echo 1 > /sys/class/leds/tpacpi::kbd_backlight/brightness
  +
  +
{{ic|brightnessctl}} を使用する場合、{{ic|brightnessctl --list}} で使用可能な輝度調整のリストを取得し、次に kbd のバックライト情報を表示することができます。
  +
  +
$ brightnessctl --device='tpacpi::kbd_backlight' info
  +
  +
これより、絶対値と相対値(%)で現在値、絶対値での最大値が表示されます。別の値を設定する場合
  +
  +
$ brightnessctl --device='tpacpi::kbd_backlight' set 1
  +
  +
=== xset ===
  +
  +
キーボードメーカーによっては、{{Pkg|brightnessctl}} や {{Pkg|light}} が認識しないものもありますが、Xorg を実行していれば {{Pkg|xorg-xset}} を使ってそのライトを制御することができます。
  +
  +
最初のパラメータ {{ic|led}} は点灯、{{ic|-led}} は消灯、{{ic|NUMBER}} パラメータは 1 から 32 までの整数(各数値はシステム内の led に対応、キーボードは一般に 3 番のようです)、または 'on' と 'off' (on はすべてのライトを点灯、off はすべてのライトを消灯) を受け取ります。
  +
  +
ライトを点灯させる
  +
  +
$ xset led NUMBER
  +
  +
ライトを消灯させる
  +
  +
$ xset -led NUMBER
  +
  +
=== D-Bus ===
 
[[D-Bus]] インタフェース経由でコンピュータのキーボードのバックライトを制御することができます。D-Bus を使用する利点は、デバイスファイルへの変更が必要なく、全てのメーカーで使えることです。
 
[[D-Bus]] インタフェース経由でコンピュータのキーボードのバックライトを制御することができます。D-Bus を使用する利点は、デバイスファイルへの変更が必要なく、全てのメーカーで使えることです。
   
43行目: 78行目:
 
print("Script takes exactly one argument.", len(argv[1:]), "arguments provided.")</nowiki>}}
 
print("Script takes exactly one argument.", len(argv[1:]), "arguments provided.")</nowiki>}}
   
  +
Alternatively the following bash one-liner will set the backlight to the value specified in the ''argument'':
== Asus ==
 
  +
  +
{{bc|<nowiki>
  +
setKeyboardLight () {
  +
dbus-send --system --type=method_call --dest="org.freedesktop.UPower" "/org/freedesktop/UPower/KbdBacklight" "org.freedesktop.UPower.KbdBacklight.SetBrightness" int32:$1
  +
}</nowiki>
  +
}}
  +
  +
==== GNOME ====
  +
  +
以下は、ターミナルから実行するか、キーバインディングにマッピングすることができます。
  +
  +
$ gdbus call --session --dest org.gnome.SettingsDaemon.Power --object-path /org/gnome/SettingsDaemon/Power --method org.gnome.SettingsDaemon.Power.Keyboard.StepUp
  +
$ gdbus call --session --dest org.gnome.SettingsDaemon.Power --object-path /org/gnome/SettingsDaemon/Power --method org.gnome.SettingsDaemon.Power.Keyboard.StepDown
  +
  +
==== On MATE ====
  +
  +
{{Style|Informal and unclear description. No relevance to MATE.}}
  +
  +
In case you use [[MATE]] environment you might get tired with repeated lighting keyboard backlight while logging in, unlocking screen or waking up dimmed display. Following setup prevent from automatic lighting up during any action. The only triggers remain plugging in the adapter and fresh boot. After that you can control keyboard backlight only via hotkeys (eg. ThinkPad Fn + spacebar).
  +
  +
To prevent automatic lighting up just edit file {{ic|/usr/share/dbus-1/system.d/org.freedesktop.UPower.conf}} as follows (two occurrences of "deny"):
  +
  +
{{hc|/usr/share/dbus-1/system.d/org.freedesktop.UPower.conf|<nowiki>
  +
<?xml version="1.0" encoding="UTF-8"?> <!-- -*- XML -*- -->
   
  +
<!DOCTYPE busconfig PUBLIC
{{Warning|以下の方法は推奨しません。誰でもキーボードバックライトのデバイスファイルに変更できるようにしてしまいます。}}
 
  +
"-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
キーボードバックライトのデバイスファイルは、通常、編集できないようになっています。起動時にファイルを編集できるようにするには、[[systemd]] サービスを作成する必要があります:
 
  +
"http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
  +
<busconfig>
  +
<!-- Only root can own the service -->
  +
<policy user="root">
  +
<allow own="org.freedesktop.UPower"/>
  +
</policy>
  +
<policy context="default">
   
  +
<allow send_destination="org.freedesktop.UPower"
{{hc|/usr/lib/systemd/system/asus-kbd-backlight.service|<nowiki>
 
  +
send_interface="org.freedesktop.DBus.Introspectable"/>
[Unit]
 
Description=Asus Keyboard Backlight
 
Wants=systemd-backlight@leds:asus::kbd_backlight.service
 
After=systemd-backlight@leds:asus::kbd_backlight.service
 
   
  +
<allow send_destination="org.freedesktop.UPower"
[Service]
 
  +
send_interface="org.freedesktop.DBus.Peer"/>
Type=oneshot
 
  +
<allow send_destination="org.freedesktop.UPower"
RemainAfterExit=yes
 
  +
send_interface="org.freedesktop.DBus.Properties"/>
ExecStart=/bin/chmod 666 /sys/class/leds/asus::kbd_backlight/brightness
 
  +
<allow send_destination="org.freedesktop.UPower.Device"
  +
send_interface="org.freedesktop.DBus.Properties"/>
  +
<deny send_destination="org.freedesktop.UPower.KbdBacklight"
  +
send_interface="org.freedesktop.DBus.Properties"/>
  +
<allow send_destination="org.freedesktop.UPower.Wakeups"
  +
send_interface="org.freedesktop.DBus.Properties"/>
   
  +
<allow send_destination="org.freedesktop.UPower"
[Install]
 
  +
send_interface="org.freedesktop.UPower"/>
WantedBy=multi-user.target</nowiki>}}
 
  +
<allow send_destination="org.freedesktop.UPower"
これでキーボードバックライトを変化させるスクリプト (例: [[ASUS G55VW#キーボードバックライトスクリプト]]) を使用できるようになります。
 
  +
send_interface="org.freedesktop.UPower.Device"/>
  +
<deny send_destination="org.freedesktop.UPower"
  +
send_interface="org.freedesktop.UPower.KbdBacklight"/>
  +
<allow send_destination="org.freedesktop.UPower"
  +
send_interface="org.freedesktop.UPower.Wakeups"/>
  +
</policy>
  +
</busconfig>
  +
</nowiki>}}

2022年1月6日 (木) 13:26時点における最新版

キーボードのバックライトの輝度レベルを制御するには、さまざまな方法があります。

全メーカー共通

明るさのレベルを管理する方法はさまざまで、brightnessctllight など、これを実現するためのヘルパーツールもさまざまです。

sys 疑似ファイルシステムは、キーボードバックライトへのインタフェースを公開します。現在の輝度レベルは /sys/class/leds/tpacpi::kbd_backlight/brightness を読むことで得られます。例えば、最大の輝度レベルを得るには、以下のようにします。

$ cat /sys/class/leds/tpacpi::kbd_backlight/max_brightness

明るさを 1 に設定する

# echo 1 > /sys/class/leds/tpacpi::kbd_backlight/brightness

brightnessctl を使用する場合、brightnessctl --list で使用可能な輝度調整のリストを取得し、次に kbd のバックライト情報を表示することができます。

$ brightnessctl --device='tpacpi::kbd_backlight' info

これより、絶対値と相対値(%)で現在値、絶対値での最大値が表示されます。別の値を設定する場合

$ brightnessctl --device='tpacpi::kbd_backlight' set 1

xset

キーボードメーカーによっては、brightnessctllight が認識しないものもありますが、Xorg を実行していれば xorg-xset を使ってそのライトを制御することができます。

最初のパラメータ led は点灯、-led は消灯、NUMBER パラメータは 1 から 32 までの整数(各数値はシステム内の led に対応、キーボードは一般に 3 番のようです)、または 'on' と 'off' (on はすべてのライトを点灯、off はすべてのライトを消灯) を受け取ります。

ライトを点灯させる

$ xset led NUMBER

ライトを消灯させる

$ xset -led NUMBER

D-Bus

D-Bus インタフェース経由でコンピュータのキーボードのバックライトを制御することができます。D-Bus を使用する利点は、デバイスファイルへの変更が必要なく、全てのメーカーで使えることです。

以下に Python 3 での実装例を示します。/usr/local/bin/ にスクリプトを置き、実行可能にします。/usr/local/bin/kb-light.py +/usr/local/bin/kb-light.py - を実行するキーボードショートカットを作成することでキーボードの輝度を変えることができます。

/usr/local/bin/kb-light.py
#!/usr/bin/env python3
# coding: utf-8

from sys import argv
import dbus


def kb_light_set(delta):
    bus = dbus.SystemBus()
    kbd_backlight_proxy = bus.get_object(org.freedesktop.UPower, /org/freedesktop/UPower/KbdBacklight)
    kbd_backlight = dbus.Interface(kbd_backlight_proxy, org.freedesktop.UPower.KbdBacklight)

    current = kbd_backlight.GetBrightness()
    maximum = kbd_backlight.GetMaxBrightness()
    new = max(0, current + delta)

    if new >= 0 and new <= maximum:
        current = new
        kbd_backlight.SetBrightness(current)

    # Return current backlight level percentage
    return 100 * current / maximum

if __name__ == __main__:
    if len(argv[1:]) == 1:
        if argv[1] == "--up" or argv[1] == "+":
            # ./kb-light.py (+|--up) to increment
            print(kb_light_set(1))
        elif argv[1] == "--down" or argv[1] == "-":
            # ./kb-light.py (-|--down) to decrement
            print(kb_light_set(-1))
        else:
            print("Unknown argument:", argv[1])
    else:
        print("Script takes exactly one argument.", len(argv[1:]), "arguments provided.")

Alternatively the following bash one-liner will set the backlight to the value specified in the argument:

setKeyboardLight () {
    dbus-send --system --type=method_call  --dest="org.freedesktop.UPower" "/org/freedesktop/UPower/KbdBacklight" "org.freedesktop.UPower.KbdBacklight.SetBrightness" int32:$1 
}

GNOME

以下は、ターミナルから実行するか、キーバインディングにマッピングすることができます。

$ gdbus call --session --dest org.gnome.SettingsDaemon.Power --object-path /org/gnome/SettingsDaemon/Power --method org.gnome.SettingsDaemon.Power.Keyboard.StepUp
$ gdbus call --session --dest org.gnome.SettingsDaemon.Power --object-path /org/gnome/SettingsDaemon/Power --method org.gnome.SettingsDaemon.Power.Keyboard.StepDown

On MATE

この記事あるいはセクションで使われている用語や表現には問題が存在します。
議論: Informal and unclear description. No relevance to MATE. (議論: トーク:キーボードバックライト#)

In case you use MATE environment you might get tired with repeated lighting keyboard backlight while logging in, unlocking screen or waking up dimmed display. Following setup prevent from automatic lighting up during any action. The only triggers remain plugging in the adapter and fresh boot. After that you can control keyboard backlight only via hotkeys (eg. ThinkPad Fn + spacebar).

To prevent automatic lighting up just edit file /usr/share/dbus-1/system.d/org.freedesktop.UPower.conf as follows (two occurrences of "deny"):

/usr/share/dbus-1/system.d/org.freedesktop.UPower.conf
<?xml version="1.0" encoding="UTF-8"?> <!-- -*- XML -*- -->

<!DOCTYPE busconfig PUBLIC
 "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>
  <!-- Only root can own the service -->
  <policy user="root">
    <allow own="org.freedesktop.UPower"/>
  </policy>
  <policy context="default">

    <allow send_destination="org.freedesktop.UPower"
           send_interface="org.freedesktop.DBus.Introspectable"/>

    <allow send_destination="org.freedesktop.UPower"
           send_interface="org.freedesktop.DBus.Peer"/>
    <allow send_destination="org.freedesktop.UPower"
           send_interface="org.freedesktop.DBus.Properties"/>
    <allow send_destination="org.freedesktop.UPower.Device"
           send_interface="org.freedesktop.DBus.Properties"/>
    <deny  send_destination="org.freedesktop.UPower.KbdBacklight"
           send_interface="org.freedesktop.DBus.Properties"/>
    <allow send_destination="org.freedesktop.UPower.Wakeups"
           send_interface="org.freedesktop.DBus.Properties"/>

    <allow send_destination="org.freedesktop.UPower"
           send_interface="org.freedesktop.UPower"/>
    <allow send_destination="org.freedesktop.UPower"
           send_interface="org.freedesktop.UPower.Device"/>
    <deny  send_destination="org.freedesktop.UPower"
           send_interface="org.freedesktop.UPower.KbdBacklight"/>
    <allow send_destination="org.freedesktop.UPower"
	   send_interface="org.freedesktop.UPower.Wakeups"/>
  </policy>
</busconfig>