File: FAQ

package info (click to toggle)
vifm 0.7.8-3
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 4,872 kB
  • ctags: 5,880
  • sloc: ansic: 68,835; sh: 4,089; makefile: 283; perl: 21
file content (142 lines) | stat: -rw-r--r-- 5,388 bytes parent folder | download
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
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 contain connection parameters in the
      first line.  A sample first line could be:
      root@127.0.0.1:/

--------------------------------------------------------------------------------

Q: How can one access FTP with vifm?

A: Since vifm tries to adhere to the Unix philosophy VFS (Virtual File System)
probably will not be added.  To access FTP on a Unix-like system use FUSE file
system (see curlftpfs project at http://curlftpfs.sourceforge.net).  FUSE isn't
implemented for Windows, so Windows users should use one of programs that bind
FTP connections to file system (for example FTPDrive at
http://www.killprog.com/fdrve.html).

--------------------------------------------------------------------------------

Q: How can I customize vifm?

A: There are several ways to do that:

  - using vifmrc file (it's in ~/.vifm/)
    This file can contain any of vifm commands.  You probably would like too set
    mappings and options here.  vifm will never change this file (it's something
    similar too ~/.vimrc).

  - changing color scheme (~/.vifm/colorschemes)
    You can set change colors of different TUI elements of vifm here. Or add
    completely new color schemes.

--------------------------------------------------------------------------------

Q: What operations can be undone/redone?

A: List of currently supported operations:
  - rename
  - move
  - copy
  - delete (when using Trash)
  - permissions change (chmod)
  - owner change
  - group change
  - chmod
  - creating symbolic links with absolute paths
  - creating symbolic links with relative paths
  - creating of directories

--------------------------------------------------------------------------------

Q: How can one execute vifm commands after using :! ?

A: The only way to do this is using :execute command.  Example:
  :execute ":!shell command" | vifm command

--------------------------------------------------------------------------------

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`).  What to
   do 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.  What to
   do to fix it?

A: See answer for the previous question.

--------------------------------------------------------------------------------

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 a FTP remote as
   a drive for you. Get it here:
     http://www.killprog.com/fdrve.html

--------------------------------------------------------------------------------

Q: How can I help vifm?

A: Just use it and report any problems, bugs or suggestions to its developers by
   email or trackers.  You also can send you configuration and colorscheme files
   to developers.  They can be collected and published at site of vifm.
   Examples of configuration files can also show developers of vifm how users
   typically uses vifm, so they can improve support of the most common use
   cases.

--------------------------------------------------------------------------------

Q: How to make shell aliases and functions work in vifm when running them like
   ":!foo"?

A: Here is 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.  But they won't be
   completed with <tab> completion.