deer because I really like to use
ranger as an
extension of my shell to quickly navigate the
directories. Unfortunately, its startup time (even though short) is
deer implements the very basic ranger-like
file navigation + some basic operations on the commandline, like
inserting the selected path (in various ways), which makes it fast to
launch and ideal for the task. Not using the whole terminal can be
viewed as an another feature.
- Launches much faster.
- Better shell integration.
- Retains the terminal contents and only uses a small part of the terminal.
- Offers only a small subset of
You can supply a numeric argument (
alt-number) to go up the
appropriate number of directory levels upon start.
If you activate
deer with the cursor on a path, it will start in there.
KEYS AND FUNCTIONS
These functions can be bound custom keys (the default is in the parentheses):
down(j) -- One item down.
page_down(J) -- Five items down.
up(k) -- One item up.
page_up(K) -- Five items up.
enter(l) -- Enter the selected directory.
leave(h) -- Leave the current directory (one directory up).
next_parent(]) -- One item down in the left column.
prev_parent([) -- One item up in the left column.
search(/) -- Select the first file matching the given pattern.
filter(f) -- Shows only files matching the given pattern.
toggle_hidden(H) -- Show/hide the hidden files.
quit(q) -- Exit
append_path(a) -- Insert the current path and leave the cursor on its right.
append_abs_path(A) -- Absolute path version.
insert_path(i) -- Insert the current path and leave the cursor on its left.
insert_abs_path(I) -- Absolute path version.
multi_insert_dwim(s) -- Insert the current path, add a smart separator using the last character before the cursor (unless it's an opening brace, then use a comma), move the cursor down and don't quit yet.
multi_insert_abs(S) -- Insert the current absolute path and don't quit yet.
cdinto the current directory and quit.
cdinto the selected directory and quit.
rifle(r) -- Run
rifle(1)on the selected file.
To bind a function to a different key, add something like this to your
typeset -Ag DEER_KEYS DEER_KEYS[function]=key
DEER_KEYS variable is an associative array holding the keys
associated with functions. One function may be bound to only one key
(meaning the previous one is overwritten).
I assume you have
~/.fpath added to your
$FPATH variable here. If
you don't, either add it or use the second installation method. If you
use some other directory, modify the commands below accordingly.
deer main file to
~/.fpath/deer and make sure it gets
autoloaded in your
autoload -U deer
Adding these lines will make the script available to the line editor, and bind
zle -N deer bindkey '\ek' deer
Alternatively, you can directly source the file
deer, and bind the
initialization function to
alt+k as follows:
source /path/to/deer.sh zle -N deer bindkey '\ek' deer
antigen bundle Vifon/deer antigen apply autoload -U deer zle -N deer bindkey '\ek' deer
zgen load Vifon/deer zgen save autoload -U deer zle -N deer bindkey '\ek' deer
zplug "vifon/deer", use:deer zle -N deer bindkey '\ek' deer
deer will use 22 lines of your terminal. This is configurable
zstyle mechanism. Drop a line like this in
zshrc to adjust this
zstyle ':deer:' height 35
To customize the keys used by
deer, you may use the following code:
typeset -Ag DEER_KEYS # Prepare the associative table. DEER_KEYS[action_name]=key
Users of the Colemak keyboard layout may use the included
colemak_keys.sh.example file to adjust the default keys to Colemak:
These are the issues that I'm aware of, along with the reason for why I've decided not to fix them for now. If you think any of them is a dealbreaker, open a ticket on Github and I'll see what I can do.
Slashes are replaced with division slashes (U+2215) in file previews
This is an ugly workaround, and the issue is with the way the output is
formatted (slash is used as a separator for
column(1) as it cannot appear in the filename).
The ../ directory is not correctly shown when completing the previously typed path
The shown path is created by deleting the preexisting prefix from the absolute path. It greatly simplifies the code and makes it easier to maintain (it's already quite messy in some places).
Buggy behavior in the root directory (/)
The root directory handling is quite tricky as it's the only directory where going up and down does not keep you in the same directory. I've concluded that that directory itself is used very rarely and most of the bugs are not fatal.
Can you add colors?
Unfortunately, no. It's a limitation of the underlying
line editor) and I cannot do much about it.
Why are there so many strange features and their variations?
At first I add new features taylored for myself. Later I plan to review these features and clean them up. If you need something else, please leave a feature request or add it yourself if you know how.
The key binding system is ugly
Yes, it is. I plan to replace it with a proper keymap but for now it should suffice.
lscd from the author of the original ranger is a minimal file browser written in a POSIX shell (with only a few necessary bashisms).
blscd is a Bash fork of
is very similar to ranger.
Wojciech 'vifon' Siewierski < wojciech dot siewierski at gmail dot com >
Copyright (C) 2014-2015 Wojciech Siewierski
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.