A company front-end with icons.
Differences with the built-in front-end:
quickhelp-string
)This package requires emacs 26.
Also, not compatible with emacs in a tty.
;; With use-package:
(use-package company-box
:hook (company-mode . company-box-mode))
;; Or:
(require 'company-box)
(add-hook 'company-mode-hook 'company-box-mode)
To customize:
M-x customize-group [RET] company-box [RET]
See the docstring of the variable company-box-backends-colors
:
C-h v company-box-backends-colors
You can select different themes with company-box-icons-alist
See the variable company-box-icons-functions
For now, there are customs icons for 4 backends only: company-lsp
, company-elisp
, company-yasnippet
and company-php
.
You can customize their icons with the variables:
company-box-icons-lsp
, company-box-icons-elisp
, company-box-icons-yasnippet
and company-box-icons-acphp
.
Notes:
By default, images are used to display icons.
You can also use font icons
With images, you can't change icons colors
You can position the frame downwards by setting the variable company-box-frame-top-margin
to a positive number. This is useful if your base code/text has an enlarged line height, and company box is intruding into the line above. It's also useful, if you're using copilot and want to see a few lines of suggested code unobscured by the company box. See PR #205 for details.
You can set the top margin mode-dependent via mode hooks, if you want. E.g. in Doom Emacs:
(use-package! company-box
:defer t
:config
(setq-hook! 'prog-mode-hook
company-box-frame-top-margin 20)
(setq-hook! 'text-mode-hook
company-box-frame-top-margin 75)
)