Rainmeterを使ってみようの巻 〜Bang〜

Software Rainmeter
  • 2022年09月06日 4.5対応

Rainmeterの記事一覧

Rainmeterを使ってみようの巻 〜記事一覧〜

bangというのはRainmeterに実装されているコマンド群の事。Rainmeter本体に渡して使う事も出来る。

"C:\Program Files\Rainmeter\Rainmeter.exe" !RefreshApp

多くのbangが引数としてConfigを持っているがこれは特に指定がない場合はconfig nameを指定する。*を指定した場合は現在ロードされている全てのskinが対象となる。

Operating System

コマンド 引数 概要
!SetClip String 文字列をクリップボードにコピーする。
String(必須)
クリップボードにコピーする文字列。
!SetClip "This is copied to the clipboard!"
!SetWallpaper File
Position		 指定した画像ファイルを壁紙にセットする。
File(必須)
壁紙にしたい画像ファイルのPath。
Position(オプション)
壁紙の配置方法。有効な値は以下。
  • Center
  • Tile
  • Stretch
  • Fit(Windows7以降)
  • Fill(Windows7以降)
  • Span(Windows10以降) 4.5で追加
!SetWallpaper "Some Image.png" Center

Application

command 引数 概要
!About TabName 詳細Winddowを開く。
TabName(オプション)
開くタブを指定する。有効な値は以下。
  • Log
  • Skins
  • Plugins
  • Version
!About Skins
!Manage TabName
Config
File		 管理ツールWindowを開く。
TabName(オプション)
開くタブを指定する。有効な値は以下。
  • Skins
  • Layouts
  • Settings
Config(オプション)
File(オプション)
スキンのiniファイル名
!Manage Skins "illustro\Clock" "Clock.ini"
!TrayMenu トレイアイコンの右クリックメニューを開く。
!Log String
ErrorType		 詳細のログタブに書き込む。
String(必須)
書き込む文字列。
ErrorType(オプション)
エラータイプ。有効な値は以下。
  • Notice
  • Error
  • Warning
  • Debug
!Log "There was an error!" Error
!ResetStats ネットワークの統計情報をリセットする。
!LoadLayout LayoutName テーマをロードする。Windowsのコマンドラインから実行も出来る。
LayoutName(必須)
テーマ名。
!LoadLayout "My Saved Layout"
"C:\Program Files\Rainmeter\Rainmeter.exe" !LoadLayout "My Saved Layout"
!RefreshApp 全てのskin及び全設定の再読み込みを実行する。!Refresh *との違いはskinフォルダの再読み込み。
!Quit Rainmeterを終了する。
Play SoundFile 指定された音源ファイルを1回だけ鳴らす。
SoundFile(必須)
音源ファイルのPath。wavファイルのみ。
Play "SomeFile.wav"
ところでこの一連のコマンドだけ何故！が付いていないかというと、単にWindowsのAPIを叩いてるだけであって特段Rainmeterのコマンドという訳ではないからと言うことらしいが返って分かりにくい気がする。
PlayLoop SoundFile 指定された音源ファイルをLoopで鳴らす。
SoundFile(必須)
音源ファイルのPath。wavファイルのみ。
PlayLoop  "SomeFile.wav"
PlayStop Rainmeterが鳴らした音をストップする。

Option and Variable

command 引数 概要
!SetOption Meter/Measure
Option
Value
Config		 MeterまたはMeasureのオプションを設定する。
Meter/Measure(必須)
MeterまたはMeasure Sectionの名前を指定。
Option(必須)
項目名を指定。
Value(必須)
セットする値を指定。
Config(オプション)
!SetOption SomeStringMeter Text "New Text"
!SetVariable Variable
Value
Config		 Variables Sectionで定義された変数を設定する。存在しない場合はメモリ上に変数を新たに定義する。
Variable(必須)
変数名を指定。
Value(必須)
セットする値を指定
Config(オプション)
!SetVariable SomeVariable "New value!"
!WriteKeyValue Section
Key
Value
FilePath		 指定Sectionの指定Keyの値をiniファイルに直接書き込む。
Section(必須)
指定されたSectionが存在しない場合iniファイルの最後に新しく書き込む。
Key(必須)
指定されたKeyが存在しない場合Sectionの最後に新しく書き込む。
Value(必須)
書き換える値を指定する。
FilePath(オプション)
指定しなければ現在のloadされているファイルに書き込む。
!WriteKeyValue Variables MyFontName Arial "#@#Variables.inc"

Option and Variable group

command 引数 概要
!SetOptionGroup Group
Option
Value
Config		 Groupで指定するだけでOption and Variable bangの物と一緒。
!SetVariableGroup Variable
Value
Group		 Groupで指定するだけでOption and Variable bangの物と一緒。

Skin

!Show
!Hide
!Toggle		 Config skinを表示あるいは非表示する。
Config(オプション)
!Toggle "illustro\Clock"
!ShowFade
!HideFade
!ToggleFade		 Config フェード効果を伴ってskinを表示あるいは非表示する。
Config(オプション)
!FadeDuration milliseconds
Config		 FadeDurationをミリ秒で指定する。
milliseconds(必須)
Config(オプション)
!ShowBlur
!HideBlur
!ToggleBlur		 Config skinの背後にブラー効果を表示あるいは非表示する。
Config(オプション)
!AddBlur
!RemoveBlur		 Region
Config		 ブラー領域を加えるもしくは削除する。
Region(必須)
ブラー効果を追加もしくは削除する範囲。
Config(オプション)
!Move X
Y
Config		 skinの表示位置を指定する。
X(必須)
X座標を指定する。
Y(必須)
Y座標を指定する。
Config(オプション)
!Move "100" "100"
!SetWindowPosition
4.5で追加
WindowX(必須)
WindowXを指定する。
WindowY(必須)
WindowYを指定する。
AnchorX(オプション)
AnchorXを指定する。
AnchorY(オプション)
AnchorYを指定する。
Config(オプション)
!SetWindowPosition "100" "100" "10" "50"
!SetAnchor
4.5で追加
AnchorX(必須)
AnchorXを指定する。
AnchorY(必須)
AnchorYを指定する。
Config(オプション)
!SetAnchor "100" "100"
!ActivateConfig Config
File		 skinを有効にする。
Config(必須)
File(オプション)
iniファイルを指定する。
!ActivateConfig "illustro\Clock" "Clock.ini"
!DeactivateConfig Config skinを無効にする。
Config(オプション)
!DeactivateConfig "illustro\Clock"
!ToggleConfig Config
File		 skinの有効無効を切り替える。
Config(必須)
File(必須)
iniファイルを指定する。
!ToggleConfig "illustro\Clock" "Clock.ini"
!Update Config skin全体のUpdateを即時実行する。
Config(オプション)
!Redraw Config skin全体の再描画を即時実行する。!Updateは値の再取得をするのであって再描画ではない事に注意。
Config(オプション)
!Refresh Config skinを再読み込みする。
Config(オプション)
!SkinMenu Config skinのコンテキストメニューを開く。
Config(オプション)
!SkinCustomMenu Config skinのカスタムコンテキストメニューを開く。
Config(オプション)
!SetTransparency Alpha
Config		 skinの透明度を設定する。
Alpha(必須)
透明度を0-255の範囲で指定する。
Config(オプション)
!SetTransparency "128" "illustro\Clock"
!ZPos Position
Config		 skinの奥行き表示位置を設定する。
Position(必須)
  1. デスクトップに固定
  2. 背面へ
  3. 通常
  4. 前面へ
  5. 最前面に固定
Config(オプション)
!ZPos "2" "illustro\Clock"
!Draggable Setting
Config		 skinのドラッグの有効無効を設定する。
Setting(必須)
  1. 無効
  2. 有効
  3. 有効無効を切り替え
Config(オプション)
!KeepOnScreen Setting
Config		 skinの全てを画面上に表示の有効無効を設定する。
Setting(必須)
  1. 無効
  2. 有効
  3. 有効無効を切り替え
Config(オプション)
!ClickThrough Setting
Config		 skinのクリックをスルーの有効無効を設定する。
Setting(必須)
  1. 無効
  2. 有効
  3. 有効無効を切り替え
Config(オプション)
!SnapEdges Setting
Config		 skinの端に合わせるの有効無効を設定する。
Setting(必須)
  1. 無効
  2. 有効
  3. 有効無効を切り替え
Config(オプション)
!AutoSelectScreen Setting
Config		 スキンの位置に応じて自動選択の有効無効を設定する。
Setting(必須)
  1. 無効
  2. 有効
  3. 有効無効を切り替え
Config(オプション)
!EditSkin 4.5で変更 Config
File		 指定されたもしくはiniに関連づけられたテキストエディタでskin.iniを開く。

Skin group

command 引数 概要
!ShowGroup
!HideGroup
!ToggleGroup		 Group Groupで指定するだけでskin bangの物と一緒。
!ShowFadeGroup
!HideFadeGroup
!ToggleFadeGroup		 Group Groupで指定するだけでskin bangの物と一緒。
!FadeDurationGroup milliseconds
Group		 Groupで指定するだけでskin bangの物と一緒。
!DeactivateConfigGroup Group Groupで指定するだけでskin bangの物と一緒。
!Updategroup Group Groupで指定するだけでskin bangの物と一緒。
!RedrawGroup Group Groupで指定するだけでskin bangの物と一緒。
!RefreshGroup Group Groupで指定するだけでskin bangの物と一緒。
!SetTransparencyGroup Alpha
Group		 Groupで指定するだけでskin bangの物と一緒。
!DraggableGroup Setting
Group		 Groupで指定するだけでskin bangの物と一緒。
!ZPosGroup Position
Group		 Groupで指定するだけでskin bangの物と一緒。
!KeepOnScreenGroup Setting
Group		 Groupで指定するだけでskin bangの物と一緒。
!ClickThroughGroup Setting
Group		 Groupで指定するだけでskin bangの物と一緒。
!SnapEdgesGroup Setting
Group		 Groupで指定するだけでskin bangの物と一緒。
!AutoSelectScreenGroup Setting
Group		 Groupで指定するだけでskin bangの物と一緒。

Meter

command 引数 概要
!ShowMeter
!HideMeter
!ToggleMeter		 Meter
Config		 Meterを表示あるいは非表示する。
Meter(必須)
Meter名を指定。
Config(オプション)
!ToggleMeter "MyMeter"
!UpdateMeter Meter
Config		 MeterのUpdateを即時実行する。
Meter(必須)
Meter名を指定。
Config(オプション)
!UpdateMeter "MyMeter"
!MoveMeter X
Y
Meter
Config		 Meterの表示位置を指定する。
X(必須)
X座標を指定する。
Y(必須)
Y座標を指定する。
Meter(必須)
Meter名を指定。
Config(オプション)
!MoveMeter 15 10 "MyMeter"

Meter group

command 引数 概要
!ShowMeterGroup
!HideMeterGroup
!ToggleMeterGroup		 Group
Config		 Groupで指定するだけでMeter bangの物と一緒。
!UpdateMeterGroup Group
Config		 Groupで指定するだけでMeter bangの物と一緒。

Measure

command 引数 概要
!EnableMeasure
!DisableMeasure
!ToggleMeasure		 Measure
Config		 Measureの有効無効を設定する。
Measure(必須)
Measure名を指定。
Config(オプション)
!ToggleMeasure "CPUMeasure"
!PauseMeasure
!UnpauseMeasure
!TogglePauseMeasure		 Measure
Config		 Measureの一時停止の有効無効を設定する。
Measure(必須)
Measure名を指定。
Config(オプション)
!TogglePauseMeasure "CPUMeasure"
!UpdateMeasure Measure
Config		 MeasureのUpdateを即時実行する。
Measure(必須)
Measure名を指定。*を指定した場合全てのMeasureが対象となる。
Config(オプション)
!UpdateMeasure "CPUMeasure"
!CommandMeasure Measure
Arguments
Config		 指定されたMeasureにcommandを渡す。
Measure(必須)
Measure名を指定。*を指定した場合全てのMeasureが対象となる。
Arguments(必須)
Measureに渡す引数を指定する。
Config(オプション)
!CommandMeasure "NowPlayingParent" "Previous"

Measure group

command 引数 概要
!EnableMeasureGroup
!DisableMeasureGroup
!ToggleMeasureGroup		 Group
Config		 Groupで指定するだけでMeasure bangの物と一緒。
!PauseMeasureGroup
!UnpauseMeasureGroup
!TogglePauseMeasureGroup		 Group
Config		 Groupで指定するだけでMeasure bangの物と一緒。
!UpdateMeasureGroup Group
Config		 Groupで指定するだけでMeasure bangの物と一緒。

Mouse Action state

Meterに設定されたMouseActionの有効無効を切り替える物。各bangは基本的に下記の3種類の状態を持つ。ToggleはEnabledとDisabled/Clearedを切り替える。

Enabled
MouseActionが有効。
Disabled
!SetOptionでMouseActionに[]をセットするのと同じ。つまりMouseAction自体は存在しているがcommandが空。
Cleared
!SetOptionでMouseActionに""をセットするのと同じ。つまりMouseAction自体が存在してない。

また対応しているMouseActionは下記の通り

  • LeftMouseUpAction
  • LeftMouseDownAction
  • LeftMouseDoubleClickAction
  • RightMouseUpAction
  • RightMouseDownAction
  • RIghtMouseDoubleClickAction
  • MiddleMouseUpAction
  • MiddleMouseDownAction
  • MiddleMouseDoubleClickAction
  • X1MouseUpAction
  • X1MouseDownAction
  • X1MouseDoubleClickAction
  • X2MouseUpAction
  • X2MouseDownAction
  • X2MouseDoubleClickAction
  • MouseScrollUpAction
  • MouseScrollDownAction
  • MouseScrollLeftAction
  • MouseScrollRightAction
  • MouseOverAction
  • MouseLeaveAction
Meter
command 引数 概要
!DisableMouseAction
!ClearMouseAction
!EnableMouseAction
!ToggleMouseAction		 Meter
MouseAction(s)
Config
Meter(必須)
Meter名を指定。*も有効。
MouseAction(必須)
MouseAction名を指定。複数ある場合は「｜」で繋げる。*も有効。
Config(オプション)
※MeterはRainmeter Sectionを指定する事も出来る。
!DisableMouseAction MyMeter "LeftMouseUpAction"
!DisableMouseAction MyMeter "MouseOverAction｜MouseLeaveAction"
!DisableMouseAction Rainmeter "MouseScrollDownAction｜MouseScrollUpAction"
!ClearMouseAction MyMeter "MouseOverAction｜MouseLeaveAction"
!EnableMouseAction MyMeter "MouseOverAction｜MouseLeaveAction"
!ToggleMouseAction MyMeter "*"
Meter group
command 引数 概要
!DisableMouseActionGroup
!ClearMouseActionGroup
!EnableMouseActionGroup
!ToggleMouseActionGroup		 MouseAction(s)
Group
Config		 Meter Groupで指定するだけでMeter bangの物と一緒。
Skin group
command 引数 概要
!DisableMouseActionSkinGroup
!ClearMouseActionSkinGroup
!EnableMouseActionSkinGroup
!ToggleMouseActionSkinGroup		 MouseAction(s)
Group		 Skin groupで指定するだけでMeter bangの物と一緒。