Code Monkey home page Code Monkey logo

dirvish's Introduction


A polished Dired with batteries included

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.

Screenshots

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/190370038-1d64a7aa-ac1c-4436-a2a3-05cd801de0a4.png

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 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 (untested)

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

Installation

Dirvish is available on Melpa. Just type M-x package-install RET dirvish RET into Emacs 27.1+. el-get users can get the recipe from here.

For straight.el users, it is simply:

(straight-use-package 'dirvish)

Quickstart

After installation, let Dirvish take over Dired globally:

(dirvish-override-dired-mode)
  • M-x dirvish RET

    Welcome to Dirvish! Press ? for help.

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

Resources

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.


https://melpa.org/packages/dirvish-badge.svg https://stable.melpa.org/packages/dirvish-badge.svg https://github.com/alexluigit/dirvish/actions/workflows/melpazoid.yml/badge.svg

dirvish's People

Contributors

adomas-beep-boop-maggots avatar agsdot avatar aikrahguzar avatar alexluigit avatar dvzubarev avatar feltcat avatar gcv avatar isamert avatar kngwyu avatar liguangsheng avatar phundrak avatar rainstormstudio avatar tarsius avatar tpeacock19 avatar zrquan avatar zsxh avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.