Skip to content

An extension for Double Commander file manager to provide Vim-like key bindings

License

Notifications You must be signed in to change notification settings

Galicarnax/dcvim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dcvim

An extension for Double Commander file manager to provide Vim-like key bindings

While there is a number of console file managers with Vim-like keybindings (e.g., ranger and vifm), it seems that no GUI analogs exist. The dcvim extension allows to use Double Commander (DC), a cross-platform GUI file manager, in Vim-like manner to the extent allowed by the application's API. Since DC does not expose some of its functionality (e.g., basic cursor movements) to its scripts, dcvim relies on external key emulation utilities (xdotool in case of Unix/Linux, and an ad hoc self-made small utility in case of MS Windows).

Currently, dcvim works in Unix/Linux and MS Windows only.

If you want to keep your custom shortcuts along with dcvim keybindings, you should copy the contents of keys.xml into shortcuts.csf instead of using dcvim.csf (but make sure there is no interference).

Install

Linux

  • Install xdotool utility (e.g., in Ubuntu: sudo apt install xdotool)
  • Make sure Lua library is installed (e.g., in Ubuntu: sudo apt install liblua5.1-0)
  • Copy/clone dcvim directory into DC's config directory
  • Copy or move dcvim.scf from dcvim one level up into DC's config directory
  • Configure DC:
    • Options->Keys: set Typing->Letters to None
    • Options->Keys->Hotkeys: select dcvim.scf as the Shortcut file

MS Windows

  • Make sure lua5.1.dll is present in your DC folder
  • Copy/clone dcvim directory into DC's config directory
  • Copy the contents of dcvim\mswin\toolbar_items.xml into doublecmd.xml, into the section enclosed by <Toolbars><MainToolbar><Row> tags (before copying, make sure DC is not running). [Note that this will introduce several buttons in the toolbar menu. They are used to launch key emulation utility from Lua scripts, since direct call of such utility from Lua does not work properly in Windows.]
  • (Optional) If you are fussy about running extraneous executables, you may prefer to build dcvim\mswin\keyemulate.exe from C++ code yourself.
  • Copy or move dcvim.scf from dcvim one level up into DC's config directory
  • Configure DC:
    • Options->Keys: set Typing->Letters to None
    • Options->Keys->Hotkeys: select dcvim.scf as the Shortcut file

Keybindings

Keys Description
k move cursor up
j move cursor down
h move to parent directory
l enter subdirectory or archive1
gg go to top of list
G go to bottom of list
gj move page down
gk move page up
] move 5 entries down
[ move 5 entries up
H move back in history
L move forward in history
f{char} jump to first entry which starts with the character {char}
; jump to next entry in the search initiated with f{char}
, jump to next entry in the search initiated with f{char} (exclude directories)
/ quick search
gh go to home directory
g/ go to root directory
: command line
vv select (mark) all entries
vu unselect all entries
va, v+ add entries to selection using masks
vd, v- remove entries from selection using masks
ve select files with the same extension as that of the file under cursor
vi invert selection
K move cursor up and toggle selection of entries
J move cursor down and toggle selection of entries
yy yank (copy) to clipboard
yd cut to clipboard
yf copy full paths to clipboard
yn copy names only
pp put (paste) from clipboard
cp copy into opposite panel (without confirmation)
cm move into opposite panel (without confirmation)
dd delete to trash
DD delete permanently
sn sort by name / toggle direction
ss sort by size / toggle direction
sd sort by date / toggle direction
se sort by extension / toggle direction
sa sort by attribute / toggle direction
m{char} bookmark current location2
'{char}, `{char} go to bookmarked location
'', `` show DC's directory hotlist
nf new file
nd new directory
nn new network connection
x close network connection
gf advanced search
g. toggle hidden files
gb toggle flat view of directory contents
gy sync directories
gi show history
rr rename
ri rename (put cursor in front of file name)
ra rename (put cursor after file name)3
re rename (put cursor after file extension)
rm multi-rename tool
gs count sizes of subdirectories
z hide/show right (or lower) panel
> increment size of the left/upper panel
< decrement size of the left/upper panel
u swap panels
R refresh
e edit file
gt open terminal
go open Options window
Esc cancel previous "modifier"-key - g, f, y, etc. (back to "normal" mode)
Q quit

1. Unlike in ranger and vifm, l does not open files, only directories. Binding it to open files is not a good idea as it often leads to casual launch of apps while navigating. However, this might be Ok if a file is an archive, in which case DC enters it as if it was a directory. However, with DC APIs it seems impossible to distinguish files and directories within archives, as well as within remote (FTP) paths, so in these cases l acts as an Open action for files as well.

2. These bookmarks are different from DC's own directory hotlist. NB: when bookmarking a remote (FTP) location, DC API does not provide WFX-plugin prefix in the path (although internally it works correct for DC's directory hotlist). So to be able to jump to that bookmark, you have to manually add a prefix (e.g., wfx://FTP/...) for the corresponding entry in dcvim/vars/bookmarks.

3. This key binding assumes you have set the option Select file name without extension when renaming in Options->File Operations->User Interface (if not, ra acts as re)

About

An extension for Double Commander file manager to provide Vim-like key bindings

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published