#+TITLE: Dired-Phundrak layer
#+author: Lucien “Phundrak” Cartier-Tilet
#+TAGS: layer|dired|configuration|phundrak

[[img/dired-phundrak.png]]

* Table of Contents                                        :TOC_4_gh:noexport:
- [[#description][Description]]
  - [[#features][Features:]]
- [[#install][Install]]
- [[#key-bindings][Key bindings]]

* Description
  This layer adds my  custom configuration of Dired on top  of the default dired
  configuration for Spacemacs.

** Features:
  Sane functions for Dired from Ergomacs’ website,  and one of my own, mapped to
  sane keybindings in ~dired-mode~:
  - Open several files at once from Dired in Emacs
  - Open several  files at  once from  Dired in  external software  (useful when
    using EXWM)
  - Sort files in Dired by name, date, size or extension
  - Rename files, replacing whitespace in the filename by:
    - underscores ~_~
    - or hyphens ~-~

* Install
  To use this configuration layer, add  it to your =~/.spacemacs=. You will need
  to  add =dired-phundrak=  to the  existing =dotspacemacs-configuration-layers=
  list in this file.

* Key bindings

  The following keybindings are only available from a =dired= buffer:
  | Key Binding | Description                                                   |
  |-------------+---------------------------------------------------------------|
  | ~f~         | Open all marked files in Emacs                                |
  | ~F~         | Open all marked files in external application                 |
  | ~s~         | Sort files in Dired buffer                                    |
  | ~-~         | Replace whitespace in filename of marked files by hyphens     |
  | ~_~         | Replace whitespace in filename of marked files by underscores |

  The following keybinding is available globally in Emacs:
  | Key Binding | Description                                    |
  |-------------+------------------------------------------------|
  | ~S-F1~      | Open a dired buffer in your home =~= directory |