Corfu popup on terminal
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Akib Azmain Turja 7c5a8a1c07
Bump version to 0.4
3 months ago
.elpaignore Don't ship images in packages 3 months ago
COPYING Add COPYING 4 months ago
README.org Fix #6: Add "Complementary Packages" section in README 3 months ago
corfu-popup.el Add user option to disable on GUI 3 months ago
corfu-terminal.el Bump version to 0.4 3 months ago
demo-colorterm.png Update terminal screenshots 3 months ago
demo-gui.png Add some screenshots 3 months ago
demo-tty.png Update terminal screenshots 3 months ago

README.org

corfu-terminal - Corfu popup on terminal

Corfu uses child frames to display candidates. This makes Corfu unusable on terminal. This package replaces that with popup/popon, which works everywhere.

GUI Terminal (Colorterm) TTY (with face customizations)
/akib/emacs-corfu-terminal/src/branch/master/demo-gui.png /akib/emacs-corfu-terminal/src/branch/master/demo-colorterm.png /akib/emacs-corfu-terminal/src/branch/master/demo-tty.png

Note: The above screenshots were taken with kind-icon enabled. And the TTY screenshot isn't a screenshot of a real TTY, it was emulated on a terminal emulator with TERM=linux and COLORTERM=, and the Corfu faces were modified to make the popup/popon visible on TTY.

Installation

Package

Install from NonGNU ELPA.

Quelpa

(quelpa '(corfu-terminal
          :fetcher git
          :url "https://codeberg.org/akib/emacs-corfu-terminal.git"))

Straight.el

(straight-use-package
 '(corfu-terminal
   :type git
   :repo "https://codeberg.org/akib/emacs-corfu-terminal.git"))

Manual

Download the corfu-terminal.el file and put it in your load-path.

Usage

Enable the global minor mode M-x corfu-terminal-mode to enable it. You'll probably want to enable it only on terminal. In that case, put the following in your init file:

(unless (display-graphic-p)
  (corfu-terminal-mode +1))

Complementary Packages

  • kind-icon: kind-icon adds an icon in front of each candidate describing the kind of the candidate.
  • corfu-doc and corfu-doc-terminal: corfu-doc show a documentation popup for the current candidate. corfu-doc-terminal provides a Popon (overlay) based display, so that you can use it on terminal.