https://github.com/alexluigit/dirvish
A polished Dired with batteries included.
https://github.com/alexluigit/dirvish
dired emacs file-manager
Last synced: 1 day ago
JSON representation
A polished Dired with batteries included.
- Host: GitHub
- URL: https://github.com/alexluigit/dirvish
- Owner: alexluigit
- License: gpl-3.0
- Created: 2021-05-20T21:26:01.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-05T10:00:32.000Z (about 1 month ago)
- Last Synced: 2025-04-13T20:44:20.518Z (about 1 month ago)
- Topics: dired, emacs, file-manager
- Language: Emacs Lisp
- Homepage:
- Size: 1.73 MB
- Stars: 901
- Watchers: 9
- Forks: 52
- Open Issues: 8
-
Metadata Files:
- Readme: README.org
- License: LICENSE.md
Awesome Lists containing this project
README
#+AUTHOR: Alex Lu
#+EMAIL: [email protected]
#+startup: content
#+html: 
-----
#+html:
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.
#+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:@@
@@html:
@@
@@html:@@
*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]]