zsxh / dirvish

Dired can be a nice file manager.

---

A minimalistic yet versatile file manager based on Dired

Introduction

This package gives Dired the following features:

• Multiple window layouts
• Always available file preview
• Isolated sessions
• A modern and composable user interface

… to name a few.

The experience of dirvish is surreal and even bizarre after all these years of trying to use dired. Like how professionals make their craft look easy, dirvish does something similar with how it builds on dired. Dirvish is paradoxical in that it provides a completely different experience while still fundamentally being dired at its core.

– @noctuid (source)

Quickstart

Installation

Dirvish is available on Melpa, you can install it directly via package-install if you have melpa in your package-archives.

;;; For straight.el user
(straight-use-package 'dirvish)

;;; Manual install
(add-to-list 'load-path "/path/to/dirvish")
;; If you want the extensions as well
(add-to-list 'load-path "/path/to/dirvish/extensions")
(require 'dirvish)

Basic usage

Start a Dirvish session by M-x dirvish or dirvish-dired.

• dirvish-dired creates a session in current window (like dired).
• dirvish creates a session that makes use of the whole frame.

dirvish-toggle-fullscreen allows you to toggle the fullscreen state of the current session.

It is also recommended to enable dirvish-override-dired-mode, which makes all your Dired entry commands including dired[-other-window/tab/frame] initialize or reuse a Dirvish session automatically.

That’s it, you’re all set. Use Dirvish in the same as you use Dired.

Resources

• Customizing Dirvish
• Useful extensions
• FAQ | Related projects
• Changelog

Acknowledgements

Thanks Fox Kiester (@noctuid) for the awesome summary of Dirvish.

The name dirvish is a tribute to vim-dirvish.

---