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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
Those common file operations may be discovered elsewhere in the site, or in the help screen in Broot.
This page is a cheat sheet gathering them in one place.
It focuses on the default settings, on the basis that you change the settings only after you understood the feature.
I'll assume here you know the basics of command line file operations. Broot doesn't hide the operations, it makes them easier and faster to type and shows you immediately the result but you won't be able to do them if you don't know what a `cp` or a `mkdir` does.
For each command here, don't forget you can hit <kbd>esc</kbd> to remove it. It's the fast way to cance.
!!! Note
To be easier to read, this page uses `:` to start verbs but a space is equivalent and is often more convenient to type.
!!! Note
Most screenshots here don't feature a filtering pattern (i.e. the part before the first space or colon) but you never need to remove your filter to execute your file operation. Typing a pattern is usually the fastest way to select the file you want.
# cd
A `cd` here means changing the current directory in the shell from which broot was launched.
This is done either by hitting <kbd>alt</kbd><kbd>enter</kbd> or by issuing the `:cd` verb.
It needs broot to be launched with the [`br` shell function](../install-br).
# chmod
This operation only exists on unix-like systems.
The built in `chmod` command takes as argument the mode modifier.
For example, to make the selected file executable, you type `:ch` then a space or tab, then `+x`.
![chmod](img/20210603-chmod.png)
After having checked the status line, you hit enter and the modification is done.
When you're not sure about the current mode, you may show them before starting the operation. This is done either
- by starting broot with the `-p` command line argument
- by hitting `:perm` in broot
Here's how the same `chmod` operation would look like with the mode displayed:
![chmod](img/20210603-chmod-perm.png)
# copy
## with one panel
Select the file or directory you want to copy, type `:cp` then a tab or a space, then the destination path.
Don't hesitate to hit the <kbd>tab</kbd> key while typing your path to get completion. Broot accepts and solves relative paths:
![file op](img/20210603-cp.png)
After having checked the status line, you hit enter and the copy is done.
## with two panels
When you do changes involving distant location, you may want to see both trees side to side. This is done by [opening two panels](../panels).
When using two panels, no argument is needed for the copy. The verb to use is `:cpp`:
![file op](img/20210603-cpp.png)
As there's no argument, you may [define a key binding](../conf_verbs#keyboard-key) for cpp in your configuration if you like this operation.
# create a file
The default configuration assumes the `$EDITOR` env variable is set. If it isn't and you can't set it, you should edit the `create` verb in the [configuration file](../conf_file).
The desired parent being selected, type `:cr` then hit <kbd>tab</kbd> or a space, then the name of the new file:
![file op](img/20210603-cr.png)
On <kbd>enter</kbd> you'll enter your favourite text editor and you'll be back to broot when quitting it.
# create a directory
Select the desired parent, type `:md` then hit a space or a tab, then enter the name of the new directory and hit <kbd>enter</kbd>.
You may type several slash separated elements as the command will contain the `-p` flag:
![file op](img/20210603-md.png)
# delete
## the selected file or directory
Select a file, type `:rm`
![file op](img/20210603-rm.png)
Check the status line then hit <kbd>enter</kbd>:
## with staging
Let's assume you want to remove a lot of files and directories because your disk is full.
In such a case, you start broot in "whale hunt" mode, with `br -w` to have files and directories sorted by size.
![file op](img/20210603-br-w.png)
Instead of removing files one per one, you may want to "stage" them, that is to add them to the staging area where they're counted, summed, and where you'll remove them in one operation at the end.
You stage a file (and display the staging area) with the <kbd>ctrl</kbd><kbd>g</kbd> shortcut:
![file op](img/20210603-br-w-stage.png)
The total size of the staging area is displayed on top (here "8.1G").
(when not doing screenshots for a website, I suggest you use a bigger console, so it's less crowded, but as you see broot stays usable in a tiny one)
When you ready to remove everything, you go to the staging area with <kbd>ctrl</kbd><kbd>right</kbd> then type `:rm`:
![file op](img/20210603-br-w-stage-rm.png)
You finish by hitting <kbd>enter</kbd>.
# edit a text file
The default configuration assumes the `$EDITOR` env variable is set. If it isn't and you can't set it, you should edit the `edit` verb in the [configuration file](../conf_file).
Select the file you want to edit, type `:e` then hit <kbd>enter</kbd>.
![file op](img/20210603-e.png)
As there's no argument, you may [define a key binding](../conf_verbs#keyboard-key).
You may have noticed the `+0`. If you're in a preview on a specific line, or you [searched on file content](../navigation#file-content-searches), the file may be directly open on that line with this standard argument :
![file op](img/20210603-e-line.png)
Here, on <kbd>enter</kbd>, we'd go to line 13 where is the first occurence of "lazy-" in this file.
(you may change the configuration if your editor has a different syntax)
# move
*Note that there's also a [rename](#rename) which is usually better if you only want to change the name.*
## with one panel
Select the file or directory you want to copy, type `:mv` then a tab or a space, then the destination path.
Don't hesitate to hit the <kbd>tab</kbd> key while typing your path to get completion. Broot accepts and solves relative paths:
![file op](img/20210603-mv.png)
After having checked the status line, you hit enter and the copy is done.
## with two panels
When you do changes involving distant location, you may want to see both trees side to side. This is done by [opening two panels](../panels).
When using two panels, no argument is needed for the copy. The verb to use is `:mvp`:
![file op](img/20210603-mvp.png)
As there's no argument, you may [define a key binding](../conf_verbs#keyboard-key) for mvp in your configuration if you like this operation.
# open
When a file (not a directory) is selected and you hit <kbd>enter</kbd>, the `:open_stay` internal is executed, which calls the standard file opening solution of your system and doesn't close Broot. For example on a desktop linux, this calls a variant of xdg-open which in turns will choose an application using the file's extension.
When your system doesn't know how to open files (for example on server linux with no windowing solution), this may be a problem and you can [change this behavior](../tricks#change-standard-file-opening).
# rename
If all you want is to change part of the name of a file, perhaps its extension, the `:rename` verb is ideal.
It's mapped by default to <kbd>F2</kbd>.
Just hitting the trigger key prefills the input with the command with the name as argument.
You only have to edit this name then hit <kbd>enter</kbd>.
![file op](img/20210603-rename.png)
|