eee.el: Extended Emacs With External Tui application

eee.el launches excellent terminal user interface tools (such as yazi, fzf, lazy-git, etc.) with Emacs asynchronously. It is very fast and does not burden Emacs.

ee.el Support:

1. yazi : launch yazi from Emacs asynchronously, then yazi tell emacs which file to open
2. ripgrep : launch ripgrep + fzf from Emacs asynchronous, then ripgrep tell emacs jump to which file and position
3. fzf : combined with ripgrep
4. lazygit : launch lazygit from Emacs asynchronously
5. ripgrep-all: search pdf files by ee-rga
6. delta: show git delta by ee-delta
7. htop: launch htop by ee-htop
8. btop: launch btop by ee-btop

… more tui tools and options will be enhanced and provided.

2024-09-13_22-56-02.mp4

Note

ee-find need devicon-lookup (https://github.com/coreyja/devicon-lookup) to display file icons. We should install devicon-lookup executable by:

cargo install devicon-lookup --force

Installation

Elpaca

(use-package eee
  :ensure (:type git :host github :repo "eval-exec/eee.el"
                 :files (:defaults "*.el" "*.sh"))
  :bind-keymap
  ("s-e" . ee-keymap)
  )

Straight

(use-package eee
  :ensure '(:type git :host github :repo "eval-exec/eee.el"
                 :files (:defaults "*.el" "*.sh")))

Doom Emacs

(package! eee
  :recipe (:host github :repo "eval-exec/eee.el"
           :files (:defaults "*.el" "*.sh")))

Local

(use-package eee
  :load-path "<local path to eee.el project directory>")

Configuration

Example

(use-package eee
  :load-path "~/Projects/github.com/eval-exec/eee.el/"
  :bind-keymap
  ("s-e" . ee-keymap)
  :config
  
  ;; Should have wezterm or alacritty installed, more terminal application is supporting...
;; Issues and pull requests are welcome
  (setq ee-terminal-command "wezterm")

  ;; (global-definer "f" 'ee-find)
  ;; (global-definer "g" 'ee-lazygit)
  ;; (global-definer "y" 'ee-yazi-project)
  ;; (general-def "C-x C-f" 'ee-yazi)
  ;; (general-def "C-S-f" 'ee-rg)
  ;; (general-evil-define-key 'normal 'global "M-f" 'ee-line)
  )

Please submit an issue to let me know what you need and want. Thank you! 💙