forked from vifm/vifm
-
Notifications
You must be signed in to change notification settings - Fork 0
/
FAQ
136 lines (94 loc) · 5.03 KB
/
FAQ
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
Q: Vifm fails to display some files, is it a bug?
A: Most likely reason for missing files are name filters. Use `:filter?`
command to see their state or try pressing zO shortcut to disable all
filters (undo that with zM).
--------------------------------------------------------------------------------
Q: Vifm doesn't run executables, what's wrong with it?
A: Nothing. Just set 'runexec' option on. It's off by default.
--------------------------------------------------------------------------------
Q: How can I use SSH with Vifm?
A: Follow this steps:
1) Download and install sshfs
2) Register an extension that will be used for connections over SSH.
The format is:
:filetype extensions FUSE_MOUNT2|some_mount_command using %PARAM and %DESTINATION_DIR variables
A sample line might look like this:
:filetype *.ssh FUSE_MOUNT2|sshfs %PARAM %DESTINATION_DIR
%PARAM and %DESTINATION_DIR are filled in by Vifm at runtime.
%PARAM value is filled from the first line of file (whole line).
You can also add %CLEAR if you want to clear screen before running FUSE
program.
3) Create a file with ssh extension that contains connection parameters in the
first line. A sample first line could be:
--------------------------------------------------------------------------------
Q: How to browse FTP in Vifm?
A: Use CurlFTPFS FUSE filesystem on *nix, which you can find here:
http://curlftpfs.sourceforge.net/
And on Windows you need to use FTPDrive, which will mount an FTP remote as
a drive for you. Get it here:
http://www.killprog.com/fdrve.html
--------------------------------------------------------------------------------
Q: How can I customize Vifm?
A: There are several ways to do that:
- using vifmrc file (run `:goto $MYVIFMRC` to find it)
This file can contain any of Vifm commands. You probably would like to set
mappings and options here. Vifm will never change this file (it's similar
to ~/.vimrc).
- changing color scheme (run `:cd $VIFM/colors` to find color schemes)
You can change colors of different TUI elements in existing color schemes or
add a new one.
--------------------------------------------------------------------------------
Q: What operations can be undone/redone?
A: List of currently supported operations:
- rename
- move
- copy
- non-permanent removal (i.e., deletion to trash)
- change of permissions (chmod)
- owner change
- group change
- creation of symbolic links with absolute or relative paths
- creation of directories
--------------------------------------------------------------------------------
Q: How to execute Vifm commands after using :! ?
A: The only way to do this is using :execute command. Example:
:execute ':!shell command' | some-other-command-here
--------------------------------------------------------------------------------
Q: Is there a way to copy/paste without sending to trash first?
A: Yes, to do that, one should yank (copy) files as usual, but use "P" key (not
"p") to put (paste) them into current directory.
--------------------------------------------------------------------------------
Q: Vifm expands macros in a wrong way in user defined commands with Vifm's
commands (like in `:command com :mkdir ~/tmp/%c:e | cd ~/tmp/%c:e`). How to
fix it?
A: Just double percent sign (%%). Why? Because user commands containing
Vifm's command-line commands are parsed twice. First time to replace %a
macro, and second time during command execution. So doubled percent sign
will be parsed with single % during first parse and a %x macro will be
expanded during second parse.
--------------------------------------------------------------------------------
Q: Vifm expands range in a wrong way in user defined commands (like in
`:command com :%yank`) and shows "Invalid command name" message. How to fix
it?
A: See answer to the previous question.
--------------------------------------------------------------------------------
Q: How to make shell aliases and functions work in Vifm when running them like
":!foo"?
A: Here is a solution for bash, other shells should allow to do something
similar.
1. Add the following lines to ~/.bashrc
shopt -s expand_aliases
unset BASH_ENV
2. Add the following line to ~/.vifm/vifmrc
let $BASH_ENV = '~/.bashrc'
After following the steps above aliases and functions should work the same
way as if they were typed in interactive shell by user. However, they won't
be completed by <tab> completion.
--------------------------------------------------------------------------------
Q: How can I help Vifm?
A: Just use it and report any problems, bugs or suggestions to its developers by
email or in bug trackers. You can also send your configuration and
colorscheme files to developers. They can be collected and published on
Vifm's web-site. Examples of configuration files can also show how Vifm is
typically used and suggest improvements of common use cases.