---

A polished Dired with batteries included

Introduction

Dirvish enhances Emacs’ built-in Dired mode, providing a visually appealing and highly customizable interface. More than just a facelift, Dirvish delivers a comprehensive suite of features, transforming Dired into a modern and fully functional file manager.

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.

– Special thanks to @noctuid for this summary of Dirvish

Screenshots

Installation

Dirvish is available from Nongnu-Elpa and Melpa. You can install it directly via M-x package-install RET dirvish RET on Emacs 28.1+. After installation, activate Dirvish globally with M-x dirvish-override-dired-mode RET.

Quickstart

• M-x dirvish RET

  Welcome to Dirvish! Use your favorite dired commands here, press q to quit.

• M-x dirvish-dwim RET

  Works the same as dirvish when the selected window is the only window; otherwise, it avoids occupying the entire frame.

• M-x dirvish-dispatch RET

  This is a help/cheatsheet menu powered by transient.el, the same library used to implement keyboard-driven menus in Magit and many Dirvish extensions. If you prefer this interaction style, consider binding these menus to dirvish-mode-map. See example config for details.

Documentation

For more dirvish customization options and features, see our documentation:

• Customizing
• Extensions
• FAQ
• Absolute beginner’s guide

Resources

To delve deeper into Dirvish, explore these resources:

• Related projects
• Changelog
• Discussions

Acknowledgements

This package draws inspiration from the terminal file manager ranger. Some extensions began as rewrites of packages from dired-hacks, but have since been significantly enhanced.

Code contributions:

Useful advice and discussions:

• Fox Kiester
• JD Smith
• karthink
• gcv
• aikrahguzar
• Daniel Mendler

The name dirvish is a tribute to vim-dirvish.

---