Dirvish

#+AUTHOR: Alex Lu #+EMAIL: alexluigit@gmail.com #+startup: content #+html: <img src="https://user-images.githubusercontent.com/16313743/159204052-c8caf89d-c44f-42c7-a177-4cd2491eaab6.svg" align="center" width="100%">

#+html: <p align="center">A <i>polished</i> <b>Dired</b> with batteries included</p>

• 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.

#+begin_quote 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 [[https://github.com/alexluigit/dirvish/issues/34][this summary of Dirvish]] #+end_quote

• Screenshots

[[https://user-images.githubusercontent.com/16313743/190370038-1d64a7aa-ac1c-4436-a2a3-05cd801de0a4.png][https://user-images.githubusercontent.com/16313743/190370038-1d64a7aa-ac1c-4436-a2a3-05cd801de0a4.png]]

[[https://user-images.githubusercontent.com/16313743/189978788-900b3de7-b3e5-42a6-9f28-426e1e80c314.png][https://user-images.githubusercontent.com/16313743/189978788-900b3de7-b3e5-42a6-9f28-426e1e80c314.png]]

[[https://user-images.githubusercontent.com/16313743/189978802-f6fb09ea-13a2-4dc9-828b-992523d51dd5.png][https://user-images.githubusercontent.com/16313743/189978802-f6fb09ea-13a2-4dc9-828b-992523d51dd5.png]]

• Installation

Dirvish is available from [[https://elpa.nongnu.org/nongnu/dirvish.html][Nongnu-Elpa]] and [[https://melpa.org/#/dirvish][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 [[file:docs/CUSTOMIZING.org][example config]] for details.

• Documentation

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

• [[file:docs/CUSTOMIZING.org][Customizing]]
• [[file:docs/EXTENSIONS.org][Extensions]]
• [[file:docs/FAQ.org][FAQ]]
• [[file:docs/EMACS-NEWCOMERS.org][Absolute beginner's guide]]

• Resources

To delve deeper into Dirvish, explore these resources:

• [[file:docs/COMPARISON.org][Related projects]]
• [[file:docs/CHANGELOG.org][Changelog]]
• [[https://github.com/alexluigit/dirvish/discussions][Discussions]]

• Acknowledgements

This package draws inspiration from the terminal file manager [[https://github.com/ranger/ranger][ranger]]. Some extensions began as rewrites of packages from [[https://github.com/Fuco1/dired-hacks][dired-hacks]], but have since been significantly enhanced.

Code contributions:

@@html:<a href="https://github.com/alexluigit/dirvish/graphs/contributors">@@ @@html:<img src="https://contrib.rocks/image?repo=alexluigit/dirvish" />@@ @@html:</a>@@

Useful advice and discussions:

• [[https://github.com/noctuid][Fox Kiester]]
• [[https://github.com/jdtsmith][JD Smith]]
• [[https://github.com/karthink][karthink]]
• [[https://github.com/gcv][gcv]]
• [[https://github.com/aikrahguzar][aikrahguzar]]
• [[https://github.com/minad][Daniel Mendler]]

The name dirvish is a tribute to [[https://github.com/justinmk/vim-dirvish][vim-dirvish]].

[[https://elpa.nongnu.org/nongnu/dirvish.html][file:https://elpa.nongnu.org/nongnu/dirvish.svg]] [[https://melpa.org/#/dirvish][file:https://melpa.org/packages/dirvish-badge.svg]] [[https://stable.melpa.org/#/dirvish][file:https://stable.melpa.org/packages/dirvish-badge.svg]] [[https://github.com/alexluigit/dirvish/actions/workflows/melpazoid.yml][file:https://github.com/alexluigit/dirvish/actions/workflows/melpazoid.yml/badge.svg]]