television 0.15.6

A very fast, portable and hackable fuzzy finder for the terminal
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

# Showcase

This section is meant as a community-driven list of user workflows and ways to use television in different contexts to inspire others.

### ⭐ VSCode extension

https://marketplace.visualstudio.com/items?itemName=alexpasmantier.television

### ⭐ Zed Editor File Finder

This is a drop-in file finder setup for the [zed editor](https://zed.dev/) leveraging television, a task, and keybinding.

![tv-zed-editor-compressed](https://github.com/user-attachments/assets/fc50f835-a282-438a-bbad-507320017765)

1. Install television
2. Add a task for a file finder (`zed: open tasks` command)

`tasks.json`

```jsonc
{
  "label": "File Finder",
  "command": "zed $(tv files)",
  "hide": "always",
  "allow_concurrent_runs": true,
  "use_new_terminal": true
},
```

3. Add keybinding to open file finder in center terminal (`zed: open keymap` command)

`keymap.json`

```jsonc
[
  {
    "bindings": {
      // replace file_finder::Toggle
      "cmd-p": [
        "task::Spawn",
        { "task_name": "File Finder", "reveal_target": "center" },
      ],
    },
  },
]
```

This should result in an interaction similar to the GIF above.

### ⭐ Vim/Neovim plugin

credit: https://github.com/prabirshrestha/tv.vim

![tv.vim](https://github.com/user-attachments/assets/c2a1dc2a-55d0-4b7b-9ac9-f04a5ac0cb33)

### ⭐ Zed Editor Live Grep

This is a drop-in project search setup for the [zed editor](https://zed.dev/) with a setup similar to the file finder above.

https://github.com/user-attachments/assets/5afb94af-f10a-4cac-9f51-0aa97b771bf0

1. Install television
2. Add a task for a file finder (zed: open tasks command)

`tasks.json`

```json
{
    "label": "Live Grep",
    "command": "zed $(tv text)",
    "hide": "always",
    "allow_concurrent_runs": true,
    "use_new_terminal": true,
},
```

3. Add keybinding to open file finder in center terminal (zed: open keymap command)

`keymap.json`

```json
{
  "bindings": {
    "space f w": [
      "task::Spawn",
      { "task_name": "Live Grep", "reveal_target": "center" }
    ]
  }
}
```

You can replace `space f w` with your keybinding

**Improve performance**

If there's a delay before the Live Grep window launches you can optimize this by spawning it in a different shell, eg. `bash` or `sh`.
In the example below zed will use sh to spawn the process:

`tasks.json`

```json
  {
    "label": "Live Grep",
    "command": "zed $(tv text)",
    "hide": "always",
    "allow_concurrent_runs": true,
    "use_new_terminal": true,
    "shell": {
      "program": "sh"
    }
  },
```

If you need further optimization you can add command line args like `--noediting`, `--norc`, `--noprofile` to the shell process:

`tasks.json`

```json
    "shell": {
      "with_arguments": {
        "program": "sh",
        "args": ["--noediting", "--norc", "--noprofile"]
      }
    }
```

or

`tasks.json`

```json
    "shell": {
      "with_arguments": {
        "program": "bash",
        "args": ["--norc", "--noprofile"]
      }
    }
```

> Note that you need to have `tv` in your `$PATH`

> These optimizations can also be applied to the file finder above.

Huge thanks to [eddiebergman](https://github.com/eddiebergman) and [thomdabrowski](https://github.com/thomdabrowski) for these optimizations, [original thread](https://github.com/zed-industries/zed/discussions/22581#discussioncomment-11860946)

### ⭐ Yazi plugin

https://github.com/cap153/tv.yazi