メインコンテンツまでスキップ

hmcs prefs

SQLite に保存されたキーバリュープリファレンスを管理します。

クイック例​

hmcs prefs list
hmcs prefs get theme
hmcs prefs set theme dark
hmcs prefs set shadow_panel::alpha 0.5
hmcs prefs delete theme

list​

構文​

hmcs prefs list

引数​

このサブコマンドには引数はありません。

例​

成功：

theme
shadow_panel::alpha
persona::elmer:vrm

保存されたプリファレンスがない場合：

No preferences found.

失敗例：

[stderr]
...database error...

動作​

  • キーのみを1行に1つずつ出力します。
  • ~/.homunculus/preferences.db から読み取ります。

関連​

get​

構文​

hmcs prefs get <key>

引数​

名前必須説明
keyはい読み込むプリファレンスキー。

例​

成功：

hmcs prefs get theme
dark (string)

JSON 値での成功：

hmcs prefs get profile
{
  "voice": "ja",
  "speed": 1.1
} (json)

失敗例：

hmcs prefs get missing_key
[stderr]
key not found: missing_key

動作​

  • value (type) を出力します。type は null、bool、number、string、json のいずれかです。
  • JSON 値は整形して出力します。
  • キーが存在しない場合はゼロ以外で終了します。

関連​

set​

構文​

hmcs prefs set <key> <value>

引数​

名前必須説明
keyはい書き込むプリファレンスキー。
valueはい型推論によりパースされる値文字列。

例​

成功：

hmcs prefs set theme dark
hmcs prefs set ui_scale 1.25
hmcs prefs set enabled true
hmcs prefs set profile '{"voice":"ja","speed":1.1}'

失敗例：

[stderr]
...database error...

動作​

  • ~/.homunculus/preferences.db に書き込みます。
  • 以下の順序で型を推論します：
    1. null
    2. bool
    3. number
    4. JSON オブジェクトまたは配列
    5. string
  • 成功時は出力なしです。

関連​

delete​

構文​

hmcs prefs delete <key>

引数​

名前必須説明
keyはい削除するプリファレンスキー。

例​

成功：

hmcs prefs delete theme

存在しないキーも成功として扱われます：

hmcs prefs delete missing_key

失敗例：

[stderr]
...database error...

動作​

  • キーが存在する場合は削除します。
  • キーが存在しなくても成功を返します。
  • 成功時は出力なしです。

関連​