Ranger layer

• use ranger to display dired with ranger like preview and stacked parent windows.

Toggle the use of - to enter deer or ranger with ranger-enter-with-minus. The possible values are:

• 'deer (default)
• 'ranger
• nil (restores the default behavior of -)

(setq ranger-enter-with-minus 'deer)

When disabling the mode you can choose to kill the buffers that were opened while browsing the directories.

(setq ranger-cleanup-on-disable t)

Or you can choose to kill the buffer just after you move to another entry in the dired buffer.

(setq ranger-cleanup-eagerly t)

You can choose to show dotfiles at ranger startup, toggled by zh

(setq ranger-show-hidden t)

Define custom function used to output header of primary ranger window. Must return a string that is placed in the header-line.

(setq ranger-header-func 'ranger-header-line)

Define custom function used to output header of parent and preview windows. Must return a string that is placed in the header-line.

(setq ranger-parent-header-func 'ranger-parent-header-line)

Enable dired-omit-mode in dirvish buffers by default (layer variable):

(setq-default dotspacemacs-configuration-layers
              '(ranger :variables
                       ranger-override-dired 'dirvish
                       dirvish-enable-dired-omit t))

You can customize dirvish-attributes in your dotspacemacs/user-config:

(setq dirvish-attributes
      '(file-size file-time all-the-icons subtree-state vc-state))

See dirvish documentation for the full list.

A recommended mode-line format for dirvish (add to dotspacemacs/user-config):

(setq dirvish-mode-line-format
      '(:left (sort file-time " " file-size " " file-modes " " file-link-number)
              :right (omit yank index)))

You can set the number of folders to nest to the left, adjusted by z- and z+

(setq ranger-parent-depth 2)

You can set the size of the parent windows as a fraction of the frame size

(setq ranger-width-parents 0.12)

When increasing number of nested parent folders, set max width as fraction of frame size to prevent filling up entire frame with parents.

(setq ranger-max-parent-width 0.12)

You can choose to show previews literally, or through find-file, toggled by zi

(setq ranger-show-literal t)

You can set the size of the preview windows as a fraction of the frame size

(setq ranger-width-preview 0.55)

You probably don't want to open certain files like videos when using preview. To ignore certain files when moving over them you can customize the following to your liking:

(setq ranger-excluded-extensions '("mkv" "iso" "mp4" "bin" "exe" "msi"))

To set the max files size (in MB), set the following parameter:

(setq ranger-max-preview-size 10)