# チャンネルを使用する場合
$ tv channel-name
# チャンネルを使用しない場合
$ tv --source-command="fd --type file" --preview-command="bat --color=always '{}'"

# fzfで同じことをやる場合
$ fd --type file | fzf --preview="bat --color=always '{}'"

# `tv --source-command="fd --type file" --preview-command="bat --color=always '{}'"`
# を `$ tv channel-name` で起動できるようにするチャンネル設定
[metadata]
name = "channel-name" # チャンネル名

[source]
command = ["fd -t f"] # 検索対象のデータを生成するコマンド

[preview]
command = "bat --color=always '{}'" # プレビュー表示のコマンド

[metadata]
# この値でチャンネル名が決まる。ファイル名では決まらない。
# この場合 `tv files` でこの.チャンネルが実行される
name = "files"
# channel切り替え、remote control(`Ctrl-t`)で使用される。
# remote controlで表示される説明文
description = "A channel to select files and directories"
# remote controlで表示されるコマンド
# 必要なコマンドがなくても、そのチャンネルは使用できる。
requirements = ["fd", "bat"]

[source]
# 検索対象のデータを生成するコマンド
# 配列の場合、`Ctrl-s`で切り替えができる
command = ["fd -t f", "fd -t f -H"]

[preview]
# プレビュー表示のコマンド
# `{}` は選択しているエントリに置換される。
# つまり `/path/to/file` を選択しているなら、
# `bat -n --color=always '/path/to/file'` が実行される
command = "bat -n --color=always '{}'"
# プレビューコマンドに渡す環境変数
env = { BAT_THEME = "ansi" }

[keybindings]
# F1キーでfilesチャンネルに切り変わる
shortcut = "f1"
# 選択しているエントリーに対して、この設定で定義している動作を実行する
f12 = "actions:edit"
ctrl-up = "actions:goto_parent_dir"

[actions.edit]
description = "Opens the selected entries with the default editor (falls back to vim)"
command = "${EDITOR:-vim} '{}'"
# `execute` なので新しいプロセスで実行する
# `fork` (デフォルト)なら、アクション終了後にtvに戻る
mode = "execute"

[actions.goto_parent_dir]
description = "Re-opens tv in the parent directory"
command = "tv files .."
mode = "execute"

$ tv # デフォルトチャンネルを起動する。デフォルトチャンネルは設定ファイルで変更できる
$ tv <チャンネル名> # <チャンネル名>のチャンネルを起動する
$ tv list-channels # 使用できるチャンネルの一覧を表示する

[shell_integration]
# スマートコマンド補完で、
# どのチャンネルにマッチしなかった場合に使用されるチャンネル
fallback_channel = "files"

# スマートコマンド補完で、
# プロンプトと紐付けるチャンネルの設定
[shell_integration.channel_triggers]
"dirs" = ["cd", "ls", "rmdir"]
"files" = [
  "cat"
]
"git-branch" = [
  "git checkout"
]

# シェル履歴検索やスマートコマンド補完で使用するキーバインド
[shell_integration.keybindings]
"smart_autocomplete" = "ctrl-t"
"command_history" = "ctrl-r"

# `tv` (引数なし)を実行したときに使用されるチャンネル
default_channel = "files"

[ui]
# 選択一覧ウィンドウとプレビューウィンドウの配置
# - londscape: 横並び
# - portrait: 縦並び
orientation = "landscape"

[ui.input_bar]
# 入力バーを上下どちらに配置するか
position = "botto"

[ui.preview_panel]
# プレビューウィンドウの幅または高さの割合 (パーセンテージ)
size = 50
# プレビューウィンドウのスクロールバーを表示するか
scrollbar = true

$ tv # tv設定の `default_channel` で指定したチャンネルが起動する

$ git show # Ctrl+T を押す
# => git-log チャンネルが起動

$ # Ctrl+R を押す => シェル履歴が起動する

$ tv gh-issues

$ tv files
# F12を押す => 選択したファイルをエディタで開く