Conkyのソースを表示

[[Category:システムモニタ]]
[[de:Conky]]
[[en:Conky]]
[[fr:Conky]]
[[zh-hans:Conky]]
{{Related articles start}}
{{Related|Conky/ヒントとテクニック}}
{{Related|Lm_sensors}}
{{Related|Hddtemp}}
{{Related articles end}}

[[Wikipedia:Conky (software)|Conky]] は、X Window System 用のシステムモニターソフトウェアです (Wayland のサポートは [https://github.com/brndnmtthws/conky/issues/56 進行中です]) GNU/Linux および FreeBSD で利用できます。これは、GPL ライセンスの条件に基づいてリリースされたフリーソフトウェアです。Conky は、CPU、メモリ、スワップ、ディスク容量、温度、トップ、アップロード、ダウンロード、システム メッセージなどを含む多くのシステム変数を監視できます。柔軟に設定可能ですが、設定を理解するのが少し難しい場合があります。''Conky'' は torsmo のフォークです。

== インストール ==

{{Pkg|conky}} パッケージを [[インストール]] します。追加のコンパイルオプションを有効にしてインストールできる代替パッケージもあります。

* {{AUR|conky-cli}} - X11 依存関係のない conky
* {{AUR|conky-lua-nv}} - Lua と Nvidia の両方をサポート

conky の一部の組み込み変数 (音楽の [[mpd]] など) を利用するには、追加のパッケージをインストールする必要があります。ハードドライブの温度については、[https://hwmon.wiki.kernel.org/device_support_status カーネル 5.6 以降] {{ic|drivetemp}} モジュールは hwmon を通じて SATA/SAS 温度を報告します。[[lm_sensors#S.M.A.R.T. ドライブの温度]] の議論を参照してください。conky の観点からは、{{ic|drivetemp}} は、その {{ic|hwmon}} 変数を使用することで、[[hddtemp]] パッケージと変数の代わりとして使用できます。

追加のユーティリティ:
* {{App|Conky Manager|Conky ウィジェットのテーママネージャー。システムにインストールされている Conky テーマを開始/停止、参照、編集するためのオプションが提供されます。|https://teejeetech.com/conky-manager/|{{Pkg|conky-manager}}}}

== 設定 ==

設定ファイルは、次のパスのいずれかにあります (最初に見つかったパスが使用されます):

* {{ic|~/.config/conky/conky.conf}}
* {{ic|~/.conkyrc}}
* {{ic|/etc/conky/conky.conf}}

これらのファイルが存在しない場合、conky はデフォルトの組み込み設定を使用します。これは次のように出力できます:

 $ conky --print-config

さらに、次のコマンドを使用してデフォルトの設定ファイルを作成できます:

 $ mkdir -p ~/.config/conky && conky --print-config > ~/.config/conky/conky.conf

[[ドットファイル]] をホームディレクトリに置きたい場合は、別の場所にファイルを作成し、引数を使用してそれを使用するように conky に指示できます。

たとえば、ユーザーのホームディレクトリにあるドットファイルを使用するように conky に指示するには:

 $ conky --config=~/.conky.conf

追加の設定ファイルの例は、[https://github.com/brndnmtthws/conky/wiki/Configs の上流の wiki 記事] で入手できます。

conky の実行中に設定ファイルを編集すると、ファイルに書き込むたびに conky が新しい変更内容を更新します。

すべての Conky オブジェクト/変数の完全なリファレンスについては、[https://conky.sourceforge.net/variables.html SourceForge ページ] を参照してください。これらは {{man|1|conky}} にもリストされています。

=== デュアルスクリーン ===

When using a dual screen configuration, you will need to play with a few options to place your ''conky'' window where you want it on the desktop. 

By adjusting {{ic|gap_x}}, let us say you are running a 1680x1050 pixels resolution and you want the window on middle top of your left monitor, you will use:
 alignment = 'top_left',
 gap_x = 840,
The {{ic|alignment}} option is self-explanatory, the {{ic|gap_X}} is the distance, in pixels, from the left border of your screen.

{{ic|xinerama_head}} is an alternative useful option, the following will place the ''conky'' window at the top right of the second screen: 
 alignment = 'top_right',
 xinerama_head = 2,

=== 設定ファイルの構文 ===

Since Conky 1.10 (Circa 2015Q2), configuration files are written with a  [[Lua]] syntax, like so:

  conky.config = {
    -- Comments start with a double dash
    bool_value = true,
    string_value = 'foo',
    int_value = 42,
  }
  conky.text = [[
  $variable
  ${evaluated variable}
  ]]

Pre 1.10 use the old syntax, which looks like this:

  bool_value yes
  string_value 'foo'
  int_value 42

A Lua script is available to convert from the old syntax to the new Lua syntax [https://github.com/brndnmtthws/conky/blob/master/extras/convert.lua at the GitHub repository]. The script is also at {{ic|/usr/share/doc/conky-1.15.0_pre/convert.lua}}.

== フォント ==

For displaying Unicode pictures and emoji with conky you will need a [[Fonts#Emoji and symbols|font]] that supports this and then configure conky to use the font with the Unicode you want to display. For example:

  ${font Symbola:size=48}☺${font}

=== 記号フォント ===

Symbolic fonts are also very commonly used in more decorated conky configurations, some of the more popular ones include;

* {{Pkg|otf-font-awesome}}
* {{AUR|ttf-pizzadude-bullets}} - PizzaDude Bullet's font
* {{AUR|ttf-weather-icons}} - Erik flowers weather icon font with 222 glyphs

== 自動起動 ==

There are several different ways to start Conky automatically, as outlined in [[Autostarting]].

Conky has a configuration setting which will tell it to fork to the background. This may be desirable for some autostarting setups.

In {{ic|conky.conf}}:
 conky.config = {
     background = true,
 }

If you use a graphical desktop environment and wish to use a {{ic|conky.desktop}} file for autostarting, use the following:

{{hc|~/.config/autostart/conky.desktop|2=
[Desktop Entry]
Type=Application
Name=conky
Exec=conky --daemonize --pause=5
StartupNotify=false
Terminal=false}}

The {{ic|1=pause=5}} parameter delays ''conky'''s drawing for 5 seconds at startup to make sure that the desktop had time to load and is up.

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

These are known issues people have with conky and their solutions.

=== Conky が起動しても画面に何も表示されない ===

First check for syntax errors in your configuration file's text variable. Then double check that your user has permission to run every command inside your configuration file and that all needed packages are installed.

=== 透明 ===

Conky supports two different types of transparency. Pseudo-transparency and real transparency that requires a [[composite manager]] to be installed and running. If you enable real transparency and do not have a composite manager running your conky will not be alpha transparent with transparency enabled for fonts and images as well as the background.

==== 擬似透明 ====

Pseudo-transparency is enabled by default in conky. Pseudo-transparency works by copying the background image from the root window and using the relevant section as the background for conky. Some window managers set the background wallpaper to a level above the root window which can cause conky to have a grey background. To fix this issue you need to set it manually. An example with [[feh]] is:

In {{ic|~/.xinitrc}}:

 sleep 1 && feh --bg-center ~/background.png &

==== 本当の透明性を有効にする ====

To enable real transparency, you must have a [[composite manager]] running and the following lines added to {{ic|.conkyrc}} inside the conky.config array:

  conky.config = {
     own_window = true,
     own_window_transparent = true,
     own_window_argb_visual = true,
     own_window_type = 'desktop',
  }

If window type "desktop" does not work try changing it to {{ic|normal}}. If that does not work try the other options: {{ic|dock}}, {{ic|panel}}, or {{ic|override}} instead. 

{{Note|1=[[Xfce]] requires enabled compositing, see [https://forum.xfce.org/viewtopic.php?pid=25939].}}

==== 半透明 ====

To achieve semi-transparency in real transparency mode, the following setup must be used in the conky configuration file:

  conky.config = {
     own_window = true,
     own_window_transparent = false,
     own_window_argb_visual = true,
     own_window_argb_value = 90,
     own_window_type = 'desktop',
  }

To reduce the transparency of the conky window, one can increase the value of {{ic|own_window_argb_value}} towards 255.

=== Show Desktop で最小化しないようにする ===

'''Compiz を使用:''' 'Show Desktop' ボタンまたはキーバインディングによって Conky が他のすべてのウィンドウとともに最小化される場合は、Compiz 構成設定マネージャーを起動し、"General Options" に移動し、"Hide Skip Taskbar Windows" のチェックを外します。

'''XFCE を使用:''' デスクトップをクリックすると Conky が非表示になる場合は {{ic|conky.conf}} 内に {{ic|1=own_window_hints = 'undecorated,below,sticky,skip_taskbar,skip_pager',}} を追加します。

'''その他の [[デスクトップ環境]]/[[ウィンドウマネージャ]]:''' の場合: conky.conf を編集し、次の行を追加/変更してみてください:
 own_window_type = 'override',

もしくは

 own_window_type = 'desktop',

正確な違いについては、{{man|1|conky}} [[man ページ]] を参照してください。ただし、後者のオプションを使用すると、Openbox などでサイズ変更キーバインドを使用してウィンドウを ''conky'' の境界線にスナップできますが、最初のオプションではできません。

=== GNOME シェルとの統合 ===

Some have experienced problems with ''conky'' showing up under [[GNOME]].

Add these lines to {{ic|conky.conf}}:
 own_window = true,
 own_window_type = 'desktop',

=== ちらつきを防ぐ ===

''Conky'' needs Double Buffer Extension ''(DBE)'' support from the X server to prevent flickering because it cannot update the window fast enough without it. It can be enabled with [[Xorg]] in {{ic|/etc/X11/xorg.conf}} with {{ic|Load "dbe"}} line in {{ic|"Module"}} section. The {{ic|xorg.conf}} file has been replaced (1.8.x patch upwards) by {{ic|/etc/X11/xorg.conf.d}} which contains the particular configuration files. ''DBE'' is loaded automatically as long as it is present within {{ic|/usr/lib/xorg/modules}}. The list of loaded modules can be checked with {{ic|grep LoadModule /var/log/Xorg.0.log}}.

To enable double buffering, add the {{ic|double_buffer}} option to {{ic|conky.conf}}:

  conky.config = {
      double_buffer = true,
  }

== 参照 ==

* [https://github.com/brndnmtthws/conky 公式ウェブサイト]
* [http://conky.sourceforge.net/config_settings.html 設定に使用する Conky 変数]
* [http://conky.sourceforge.net/variables.html Conky オブジェクト]
* [https://bbs.archlinux.org/viewtopic.php?id=39906 Arch フォーラムの Conky 設定スレッド]
* [https://github.com/brndnmtthws/conky/wiki/FAQ FAQ]