NonGNU-devel ELPA - dirvish

dirvish Atom Feed

Description
A modern file manager based on dired mode
Latest
dirvish-2.1.0.0.20250222.22937.tar (.sig), 2025-Feb-22, 410 KiB
Maintainer
Alex Lu <https://github.com/alexluigit>
Website
https://github.com/alexluigit/dirvish
Browse ELPA's repository
CGit or Gitweb
Badge

To install this package from Emacs, use package-install or list-packages.

Full description

A polished Dired with batteries included

1. Introduction

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)

Dirvish is an improved version of the Emacs inbuilt package Dired. It not only gives Dired an appealing and highly customizable user interface, but also comes together with almost all possible parts required for full usability as a modern file manager.

2. Screenshots

189978788-900b3de7-b3e5-42a6-9f28-426e1e80c314.png

189978802-f6fb09ea-13a2-4dc9-828b-992523d51dd5.png

190370038-1d64a7aa-ac1c-4436-a2a3-05cd801de0a4.png

3. Prerequisites

This package requires GNU ls (gls on macOS), and optionally:

  • fd as a faster alternative to find
  • imagemagick for image preview
  • poppler | pdf-tools for pdf preview
  • ffmpegthumbnailer (Linux/macOS) | mtn (Windows) for video preview
  • mediainfo for audio/video metadata generation
  • tar and unzip for archive files preview

Toggle install instructions

macOS

brew install coreutils fd poppler ffmpegthumbnailer mediainfo imagemagick

Debian-based

apt install fd-find poppler-utils ffmpegthumbnailer mediainfo imagemagick tar unzip

Arch-based

pacman -S fd poppler ffmpegthumbnailer mediainfo imagemagick tar unzip

FreeBSD

pkg install gnuls fd-find poppler ffmpegthumbnailer ImageMagick7 gtar

Windows

# install via Scoop: https://scoop.sh/
scoop install coreutils fd poppler imagemagick unzip

You might also want to install mtn for video preview.

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

5. Quickstart

  • M-x dirvish RET

    Welcome to Dirvish! Use your favorite dired commands here!

  • M-x dired | dired-jump | … RET

    Dirvish takes care all of your Dired entries.

  • M-x dirvish-dwim RET

    If the selected window is the only window, open Dirvish, otherwise open Dired.

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

6. Documentation

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

7. Resources

To delve deeper into Dirvish, explore these resources:

8. Acknowledgements

This package took inspiration from the terminal file manager ranger and treemacs from Alexander Miller. Some of the extensions was initially a rewrite of packages provided by dired-hacks. These extensions have been greatly enhanced in comparison to the original versions.

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

Code contributions:

Useful advice and discussions:

The name dirvish is a tribute to vim-dirvish.

dirvish.svg dirvish-badge.svg dirvish-badge.svg badge.svg

Old versions

dirvish-2.1.0.0.20250221.170835.tar.lz2025-Feb-2188.2 KiB
dirvish-2.1.0.0.20250221.83823.tar.lz2025-Feb-2188.0 KiB
dirvish-2.1.0.0.20250220.115021.tar.lz2025-Feb-2087.8 KiB
dirvish-2.1.0.0.20250217.61021.tar.lz2025-Feb-1787.6 KiB
dirvish-2.1.0.0.20250216.73653.tar.lz2025-Feb-1687.4 KiB
dirvish-2.1.0.0.20250214.184412.tar.lz2025-Feb-1487.3 KiB
dirvish-2.0.53.0.20250214.84334.tar.lz2025-Feb-1486.4 KiB
dirvish-2.0.53.0.20250101.212150.tar.lz2025-Jan-0282.3 KiB
dirvish-2.0.53.0.20241208.124326.tar.lz2024-Dec-0882.3 KiB
dirvish-2.0.53.0.20230519.150010.tar.lz2024-Nov-2982.3 KiB

News

1. 2.1.0

1.1. What's changed

  • Fixed incorrect vc states https://github.com/alexluigit/dirvish/issues/224
  • dirvish-hide-cursors and dirvish-hide-details now support list of symbols
  • A lot of window dedication issues fixed (#194 #258 #262 #264 #293)
  • Mode line errors (#233)
  • Modular directory data fetching (#162 #238)
  • Fixed image preview with dirvish-peek.
  • Performance imporvements with dirvish-side.
  • Respect dired-kill-when-opening-new-dired-buffer.
  • Fixed compatibility issue with find-dired.

1.2. Fixes from community

2. 2.0.53

2.1. Breaking changes

  • Use simulated dired buffers for parent directory and directory preview

    Prior to V2.0, `dirvish` command would create a ton of dired buffers because `dired-noselect` function were used to generate parent buffers and preview buffers for directory entries. Now these buffers are created internally by dirvish, meaning they'll not showing up as dired/dirvish buffers in your buffer list.

2.2. Changes since 1.9.23

  • core:
    • bind dirvish-dispatch to q
    • add basic perspective.el support
    • allow user to have classic dired header (#96)
    • basic mouse support
    • add dirvish-hide-cursor user option (#119)

… …