カーソルテーマのソースを表示

[[Category:X サーバー]]
[[Category:視覚効果]]
[[en:Cursor themes]]
[[es:Cursor themes]]
[[it:Cursor themes]]
[[pt:Cursor themes]]
[[ru:Cursor themes]]
[[zh-hans:Cursor themes]]
ディスプレイサーバーには GUI のナビゲーションや操作を楽にする ''カーソルテーマ'' が付属しています。ディスプレイサーバーにカーソルテーマは含まれていますが、他のカーソルテーマをインストールして選択することもできます。

== インストール ==

パッケージを使ってインストールするか、適当なディレクトリにダウンロード・解凍してインストールします。

=== パッケージ ===

カーソルテーマは公式リポジトリと AUR からインストールできます:

* [[公式リポジトリ]] — [https://www.archlinux.jp/packages/?sort=&q=xcursor-&maintainer=&last_update=&flagged=&limit=50 "xcursor-" 検索]
* [[AUR]] — [https://aur.archlinux.org/packages.php?O=0&L=0&C=17&K=cursor&SeB=nd&SB=n&SO=a&PP=50&do_Search=Go "cursor" 検索]

=== 手動 ===

カーソルテーマが公式リポジトリや AUR にない場合、手動で追加することができます。カーソルテーマをダウンロードすることができるウェブサイトは星の数ほどあります。ダウンロードしたら、''icons'' ディレクトリに配置して下さい (カーソルはアイコンテーマと一緒に配布されていることがあります)。

カーソルテーマを入手できるウェブサイト:

* [https://www.gnome-look.org/browse/cat/107/ord/latest/ GNOME Look]
* [https://www.deviantart.com/browse/all/customization/skins/linuxutil/x11cursors/ Deviant Art]
* [https://www.opendesktop.org/browse/cat/107/ Open Desktop]

''ユーザー個別''にインストールする場合、{{ic|~/.local/share/icons/}} または {{ic|~/.icons/}} ディレクトリを使います。次のコマンドを使えば大抵のアーカイブを展開できます:

 $ tar xvf foobar-cursor-theme.tar.gz -C ~/.local/share/icons

カーソルテーマのディレクトリは {{ic|theme-name/cursors}} です。例: {{ic|~/.local/share/icons/''theme''/cursors/}}。展開したファイルがこのディレクトリを含んでいることを確認して下さい。

{{Note|''システム全体''にインストールする場合 {{ic|/usr/share/icons}} ディレクトリを使います。このディレクトリにファイルを手動で配置することは [[pacman]] で追跡できなくなるので推奨されません。代わりにカーソルテーマの[[PKGBUILD|パッケージ]]を作成することを推奨します。}}

インストールしたカーソルテーマは次のコマンドで確認できます:

 find /usr/share/icons ~/.local/share/icons ~/.icons -type d -name "cursors"

パッケージに index.theme ファイルが含まれているときは、そのファイルの中に "Inherits" 行があるかどうか確認してください。もしその行があれば、システムにその名前で継承されるテーマが存在しているか確認してください (必要なら名前を変更してください)。

== 設定 ==

カーソルテーマを設定する方法は複数あります。

=== XDG の仕様 ===

この方法は [[Xorg|X11]] と [[Wayland]] 両方のカーソルテーマに適用されます。

''ユーザー個別''に設定する場合、{{ic|~/.icons/default/index.theme}} を作成・編集してください。''システム全体''に設定する場合、{{ic|/usr/share/icons/default/index.theme}} を編集します。

{{ic|[icon theme]}} セクションの {{ic|Inherits}} オプションを xcursor テーマのディレクトリ名 {{ic|''cursor_theme_name''}} に設定する必要があります (例: {{ic|xcursor-breeze-snow}}):

{{hc|~/.icons/default/index.theme|2=
[icon theme] 
Inherits=''cursor_theme_name''}}

それから {{ic|~/.config/gtk-3.0/settings.ini}} を編集してください ({{ic|''cursor_theme_name''}} を使用するテーマに置き換えてください):  

{{hc|~/.config/gtk-3.0/settings.ini|2=
[Settings]
gtk-cursor-theme-name=''cursor_theme_name''}}

変更を適用するには再ログインが必要です。

=== LXAppearance ===

[[LXDE#カーソル|LXAppearance]] は [[#XDG の仕様]] で指定されている {{ic|index.theme}} ファイルを作成することでデフォルトカーソルを設定します。

=== デスクトップ環境 ===

[[デスクトップ環境]] は [https://specifications.freedesktop.org/xsettings-spec/xsettings-latest.html XSETTINGS プロトコル] を使います。通常は設定デーモンによって実装されます。オンザフライでカーソルを変更することができますが、適用されるテーマがアプリケーションによって異なってしまう可能性があります。手動でカーソルテーマを変更する方法は [[#XDG の仕様]] を見て下さい。

==== GNOME ====

[[GNOME]] でテーマを変更するには {{Pkg|gnome-tweaks}} を使用するか、次のコマンドで直接設定します:

 gsettings set org.gnome.desktop.interface cursor-theme ''theme-name''

カーソルのサイズを変更するには (テーマによりますが選べるサイズは 24, 32, 48, 64 です):

 gsettings set org.gnome.desktop.interface cursor-size ''theme-size''

{{Note|Wayland ではデフォルトで、Gnome アプリケーションは {{ic|~/.local/share/icons}} に置かれているカーソルテーマを表示することができません。対応策として、[[#環境変数|パスを XCURSOR_PATH に追加]]してください。}}

==== KDE (Wayland) ====

GTK/Gnome アプリケーションが Wayland でカーソルテーマを正しく適用するには、{{Pkg|xdg-desktop-portal-gtk}} をインストールする必要があります。

==== MATE ====

MATE では mate-control-center または gsettings を使います。テーマを変更するには:

 gsettings set org.mate.peripherals-mouse cursor-theme ''theme-name''

サイズを変更するには:

 gsettings set org.mate.peripherals-mouse ''theme-size''

==== XFCE ====

xcursor テーマを変更するには:

 xfconf-query --channel xsettings --property /Gtk/CursorThemeName --set ''cursor_theme_name''

サイズを変更するには:

 xfconf-query --channel xsettings --property /Gtk/CursorThemeSize --set ''cursor_theme_size''

=== X リソース ===

ローカルでカーソルテーマに名前を付けるには、{{ic|~/.Xresources}} ファイルに以下を加えて下さい:

 Xcursor.theme: cursor-theme

カーソルテーマを正しくロードするには {{ic|~/.Xresources}} がウィンドウマネージャによって呼び出される必要があります。呼び出されない場合、次のコマンドを {{ic|~/.xinitrc}} か [[xprofile|.xprofile]] に置くことで強制的にロードするようにできます:

 $ xrdb ~/.Xresources

カーソルテーマが複数のサイズをサポートしている場合、任意で次の行を {{ic|~/.Xresources}} に追加できます:

 Xcursor.size: 16

{{Tip|32, 48, 64 も指定できます。}}

サポートされているカーソルサイズがわからない場合は、この設定を使わずに X を起動してカーソルサイズを自動的に選ばせるようにしてください。詳しくはウィンドウマネージャのドキュメントを参照してください。

=== 環境変数 ===

[[環境変数]]を使って単一のアプリケーションでテーマを設定して、一時的に試してみることができます:

 $ XCURSOR_THEME=SomeThemeName xclock

カーソルテーマが複数のサイズをサポートしている場合は XCURSOR_SIZE は任意です。

カーソルテーマを {{ic|~/.local/share/icons}} にインストールしている場合、問題を避けるためにパスを XCURSOR_PATH に追加してください。例:

{{hc|~/.bash_profile|2=
export XCURSOR_PATH=${XCURSOR_PATH}:~/.local/share/icons}}

=== ディスプレイマネージャ ===

ディスプレイマネージャの中でもカーソルテーマを設定することはできますが、ユーザーセッションにはカーソルテーマが持ち越されないことがあるので注意してください。

==== GDM ====

[[GDM#カーソルテーマの変更]] を見てください。

=== Tor ブラウザ ===

Tor ブラウザには独自の "仮想" ホームディレクトリがあり、ユーザーのホームディレクトリ内のファイルを読み取りません。したがって、設定とアイコンのテーマを Tor ブラウザのインストールディレクトリにコピーする必要があります。

 # $HOME of tor browser
 TBHOME=~/.local/share/torbrowser/tbb/x86_64/tor-browser/Browser
 # path to tor browser's gtk3 settings.ini
 TBG3RC=$TBHOME/.config/gtk-3.0/settings.ini
 # your user's directory where custom cursors are stored, might be below .local/share/ instead
 ICONSDIR=~/.icons
 
 # make sure first line of the settings.ini is '[Settings]'
 [ -f $TBG3RC ] && [ $(head -1 $TBG3RC) == '[Settings]' ] || echo '[Settings]' >> $TBG3RC
 # add your gtk3 settings to torbrowser's, strip leading [Settings] tag line
 tail -n +2 ~/.config/gtk-3.0/settings.ini >> $TBG3RC
 # copy your cursor files to torbrowser
 # ONLY NEEDED IF YOU HAVE CURSORS NOT INSTALLED SYSTEM-WIDE
 cp --recursive $ICONSDIR $TBHOME/

== トラブルシューティング ==

=== 欠けているカーソルへのリンクを作成 ===

テーマにカーソルが欠けているとき、アプリケーションがデフォルトのカーソルを使いつづけるかもしれません。こういった場合は、欠けているカーソルへのリンクを追加して修正できます。例:

 $ cd ~/.icons/foobar/cursors/
 $ ln -s right_ptr arrow
 $ ln -s cross crosshair
 $ ln -s right_ptr draft_large
 $ ln -s right_ptr draft_small
 $ ln -s cross plus
 $ ln -s left_ptr top_left_arrow
 $ ln -s cross tcross
 $ ln -s hand hand1
 $ ln -s hand hand2
 $ ln -s left_side left_tee
 $ ln -s left_ptr ul_angle
 $ ln -s left_ptr ur_angle
 $ ln -s left_ptr_watch 08e8e1c95fe2fc01f976f1e063a24ccd

上のリンクが問題を解決しないときは、テーマに欠けているカーソルを {{ic|/usr/share/icons/whiteglass/cursors}} で探して、同じようにリンクを作成してください。

{{Tip|不要なカーソルを削除することもできます。例えば"時計"カーソルを削除するには:

 $ cd ~/.icons/''theme''/cursors/
 $ rm watch left_ptr_watch
 $ ln -s left_ptr watch
 $ ln -s left_ptr left_ptr_watch
}}

=== 欠けているカーソルを補う ===

プログラムによってはカスタムカーソルを設定するものがあります。例えば、rdesktop は Microsoft Windows コンピュータに接続してリモートマシンから取得したカーソルを使います。プロトコルの制限によって変換品質が悪く、それによってカーソルが見づらいことが多々あります。

カーソルを同一 (または他の) カーソルテーマで置き換えることで解決できます。それには、画像の''ハッシュ''を取得する必要があります。アプリケーションを起動する前に {{ic|XCURSOR_DISCOVER}} 環境変数を設定してください:

 $ XCURSOR_DISCOVER=1 rdesktop ...

カーソルが設定されると、以下のような表示がされます:

 Cursor image name: 24020000002800000528000084810000
 ...
 Cursor image name: 7bf1cc07d310bf080118007e08fc30ff
 ...
 Cursor hash 24020000002800000528000084810000 returns 0x0

Xcursor が欠けているカーソルを探すとき、検索パスには {{ic|~/.icons/default/cursors}} が含まれています。まず、このディレクトリを作成します (存在しない場合):

 $ mkdir -p ~/.icons/default/cursors

次にハッシュから画像にリンクを作成します。{{ic|Vanilla-DMZ}} カーソルテーマの {{ic|left_ptr}} 画像を使用する例:

 $ ln -s /usr/share/icons/Vanilla-DMZ/cursors/left_ptr ~/.icons/default/cursors/24020000002800000528000084810000

アプリケーションを再起動するとすぐに変更が適用されます。アプリケーションを起動するときに特別な操作は必要ありません。

=== 形が X のデフォルトカーソルの変更 ===

デフォルトカーソルを left_ptr に設定しないウィンドウマネージャや、Xlib の代わりに XCB が使われるウィンドウマネージャ ([[awesome]] など) では X の形をしたカーソルが表示されます。

以下を {{ic|~/.xinitrc}} や xsession あるいはウィンドウマネージャのスタートアップ設定に追加することで修正できます (例えば bspwm の bspwmrc):
 $ xsetroot -cursor_name left_ptr

カーソル形状のリストは X プロトコルの [https://tronche.com/gui/x/xlib/appendix/b/ appendix B] に記載されています。

=== .Xdefaults ===

カーソルの衝突が発生する場合、おそらく {{ic|~/.Xdefaults}} ファイルで別々のカーソルが設定されています。

=== 起動時にカーソルのサイズが変わらない ===

{{ic|~/.xinitrc}} で {{ic|~/.Xresources}} を使ってカーソルのサイズを変更しているのにうまくいかない場合、{{ic|~/.Xresources}} のロード前に xrandr を実行するようにしてください。

{{ic|~/.xinitrc}} が以下のようになっていることを確認してください:
{{hc|~/.xinitrc|2=
xrandr &&
...
xrdb -merge ~/.Xresources &&
exec wm}}

=== Plasma (Wayland) でカーソルサイズやテーマが変わらない ===

[[Wayland]] 環境下で [[Plasma]] を使用する際、カーソルサイズやテーマを変更する場合は、変更適用後に必ずセッションを再起動してください [https://community.kde.org/Plasma/Wayland_Showstoppers#KWin.2Fcompositing.2Fwindow_management] [https://bugs.kde.org/show_bug.cgi?id=420859]

このバグについては、[[KDE#Plasma のカーソルがときどきおかしくなる]] の回避策を参照してください。

== 参照 ==

* {{man|3|Xcursor}} — X のカーソルに関する詳細情報 (サポートされているディレクトリ、フォーマット、互換性など)

{{TranslationStatus|Cursor themes|2023-12-14|698767}}