Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/frostyx/helm-dired-open
An 'Open with' dialog for opening files in external applications from Dired.
https://github.com/frostyx/helm-dired-open
emacs emacs-package xdg
Last synced: 4 months ago
JSON representation
An 'Open with' dialog for opening files in external applications from Dired.
- Host: GitHub
- URL: https://github.com/frostyx/helm-dired-open
- Owner: FrostyX
- Created: 2021-08-28T01:46:53.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-03T09:37:13.000Z (8 months ago)
- Last Synced: 2024-10-13T20:07:27.044Z (4 months ago)
- Topics: emacs, emacs-package, xdg
- Language: Emacs Lisp
- Homepage:
- Size: 62.5 KB
- Stars: 9
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.org
Awesome Lists containing this project
README
#+TITLE: helm-dired-open
#+BEGIN_QUOTE
[!IMPORTANT]
It is recommended to migrate to [[https://github.com/FrostyX/dired-open-with][dired-open-with]].
#+END_QUOTE
Right-clicking a file in most GUI file managers provides an
"Open with" menu for choosing an application to be used. This package
implements such functionality for Emacs default file manager Dired.
You can see it in action [[https://www.youtube.com/watch?v=ZU1E0M8FAX4][in this video]].
[[images/helm-dired-open.png]]
** Installation
The package is not available on MELPA yet, please use Quelpa (or your
preferred package manager) to install.
#+BEGIN_SRC emacs-lisp
(use-package helm-dired-open
:ensure t
:quelpa (helm-dired-open
:fetcher github
:repo "FrostyX/helm-dired-open"
:branch "main"))
#+END_SRC
Or if you are a developer.
#+BEGIN_SRC emacs-lisp
(use-package helm-dired-open
:ensure t
:quelpa (helm-dired-open
:fetcher file
:path "~/git/helm-dired-open"))
#+END_SRC
** Configuration
The ~M-x helm-dired-open~ command works out of the box without any
additional configuration. However ...
By default, the list of associated applications is searched in the
user-defined ~helm-dired-open-extensions~ variable and then in the XDG
database. The first source that returns non-nil value is used, the
rest is not evaluated. To add a custom source, disable some
predefined, or change their order, configure
~helm-dired-open-functions~.
#+BEGIN_SRC emacs-lisp
(setq helm-dired-open-functions
'(helm-dired-open-configured-applications
helm-dired-open-xdg-applications))
#+END_SRC
*** Custom applications
The configuration schema was inspired by and tries to resemble the
~dired-open-extensions~ variable from ~dired-open~ (provided by
~dired-hacks~ package). See the following example.
#+BEGIN_SRC emacs-lisp
(setq helm-dired-open-extensions
(let ((images
'(("eog" . "Open with image viewer")
("pinta" . "Edit in pinta")
("gimp" . "Edit in GIMP")))
(video
'(("vlc --one-instance" . "Play in VLC")
("vlc --one-instance --playlist-enqueue" . "Add to VLC queue"))))
`(("png" . ,images)
("jpg" . ,images)
("mp4" . ,video)
("avi" . ,video))))
#+END_SRC
*** Custom applications with icons
One of the many options to make the list of applications a bit cooler.
#+BEGIN_SRC emacs-lisp
(setq helm-dired-open-extensions
(let ((images
`(("eog" .
,(format "%s Open with image viewer" (fontawesome "image")))
("pinta" .
,(format "%s Edit in pinta" (fontawesome "edit")))
("gimp" .
,(format "%s Edit in GIMP" (fontawesome "edit")))))
(video
`(("vlc --one-instance" .
,(format "%s Play in VLC" (fontawesome "play")))
("vlc --one-instance --playlist-enqueue" .
,(format "%s Add to VLC queue" (fontawesome "list"))))))
`(("png" . ,images)
("jpg" . ,images)
("mp4" . ,video)
("avi" . ,video))))
#+END_SRC
** Credits
Based on [[https://github.com/emacs-helm/helm][Helm]] and
[[https://github.com/Fuco1/dired-hacks#dired-open][dired-open]].