mode-icons/README.org
Matthew Fidler 9d2d20f2c3 Allow xpm-bw with major-modes.
Also add option mode-icons-change-mode-name to suppress changing the
actual mode-name and just displaying the icons.
2016-03-30 23:42:55 -05:00

3.2 KiB

mode-icons

Show icons instead of mode names in emacs.

https://raw.githubusercontent.com/rhoit/mode-icons/dump/screenshots/screenshot01.png

Some of the modes that have icons instead of names now:

Modes icon
Coffee https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/coffee.png
CSS https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/css.png
Emacs-Lisp https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/emacs.png
Haml https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/haml.png
HTML https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/html.png
JS https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/js.png
Lisp https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/cl.png
Org-mode https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/org.png
PHP https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/php.png
Python https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/python.png
Ruby https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/ruby.png
SVG https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/svg.png
Sass https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/sass.png
Scheme https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/scheme.png
Shell https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/bash.png
Slim https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/slim.png
YAML https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/yaml.png

When looking at buffers with commands like ibuffer, they display the icons for the mode names as well. If you don't like this behavior you can change mode-icons-change-mode-name to be nil:

(setq mode-icons-change-mode-name nil)

This only displays the icon in the plain emacs mode-line.

This may not work with enhanced mode-lines like poweline or smart-mode-line, sicne they typically look at the mode-name variable.

Requirements

As of version 0.3.0 you can also use icons from some icon fonts, specifically:

You need to have installed these on your system in order to use these fonts, mode-icons will not do this for you.

Installation

manually

Place mode-icons.el somewhere in your load-path and copy the icons/ directory there as well. Then require mode-icons in your Emacs init file.

Usage

Once installed you can add (mode-icons-mode) to your init file.