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
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
# NAME
daffm - dumb as fuck file manager
# SYNOPSIS
**daffm** \[**-c** *config-file*\] \[**directory_or_file**\]
# DESCRIPTION
**daffm** is a dumb file manager/directory explorer that is meant to
integrate with system utils for file management features.
# OPTIONS
**-c, \--config config-path**
: Load toml config from file. If path is prefixed with @, will use
alternate config. Example: -c \@foo will load
\$XDG_CONFIG_HOME/daffm/config.foo.toml Default:
\$XDG_CONFIG_HOME/daffm/config.toml
**-v**
: Prints version information.
**-h, \--help**
: Prints help information.
# CONFIGURATION
**keymap**
: A mapping of key sequences to the commands. Example: gdl = \"cd
\~/Downloads\"
<!-- -->
**extend**
: Which config file to extend. This can use file paths or @-prefix for
alternate configs Example: extend = \"@custom-config\"
<!-- -->
**opener**
: Shell script that is executed when open command is invoked on a
file. Example: extend = \"xdg-open %\" \# Opens file under cursor
(ignores selections)
# COMMANDS
**back**
: Goes back one level in directory.
<!-- -->
**cd \<dir\>**
: Change current directory shown.
<!-- -->
**cmdline-enter**
: Switch focus to the command line input
<!-- -->
**cmdline-leave**
: Exit cmdline if focused
<!-- -->
**cmdline-set \<text \...\>**
: Enter the command line input with given text prefilled
<!-- -->
**eval \<command\> \[\...args\]**
: Runs command in shell. Any line in stdout that begins with \<daffm\>
is evaluated as a daffm command. This can be used to create more
dynamic commands and keybinds.
<!-- -->
**map \<key-sequence\> \<command\>**
: Add a new keymap to run given command when the key sequence is
pressed
<!-- -->
**move \<pos\>**
: Move the cursor to position. To move the cursor relative to current
position, use +/- (eg: \'move +1\' goes down 5 lines). You can also
use \'move \$\' to move the cursor to the last item in the list.
<!-- -->
**open**
: If cursor is on a directory, cd into the directory, otherwise, run
opener
<!-- -->
**quit**
: Quit
<!-- -->
**reload**
: Reloads the current directory and shows the latest information.
Daffm doesn\'t watch the directory for changes but after a call to a
shell or eval command, the directory contents are reloaded.
<!-- -->
**search \[text\]**
: Search the given text in the filenames in current directory. If text
is empty, stops search highlighting
<!-- -->
**search-next**
: Jump to next item in the search results
<!-- -->
**search-prev**
: Jump to previous item in the search results
<!-- -->
**selection-clear**
: Clear all selections
<!-- -->
**selection-toggle**
: Toggle selection for file under cursor
<!-- -->
**shell \<command\> \[\...args\]**
: Run a command in shell. If a command exits with non-zero status
code, a \"Press any key to continue\" prompt is shown.
<!-- -->
**shell! \<command\> \[\...args\]**
: Same as shell but it adds a \"Press any key to continue\" prompt
after the command runs regardless of exit status code.
# COMMAND SUBSTITUIONS
The following pattern (%,%d,%f,%s,%F,%S,%0) are replaced with absolute
paths
%: File under cursor
%d: Current directory
%s: Selected files separated by spaces
%S: Selected files separated by newlines
%f: Same as %s but if there are no selections, uses file under cursor
%F: Same as %S but if there are no selections, uses file under cursor
%0: First path that was loaded when daffm was initialized
# ENV VARIABLES
In addition to substitutions, there are also some env variables
available to access values those substitutions without escaping.
\$files: Same as %f but unescaped
\$selections: Same as %s but unescaped
\$init_path: Same as %0 but unescaped
\$cursor: Same as % but unescaped
# AUTHORS
Akshay Nair \<phenax5@gmail.com\>
# LICENSE
See the LICENSE file for the terms of redistribution.
# BUGS AND FEATURE REQUESTS
https://github.com/phenax/daffm/issues
|
