mirror of https://github.com/ryuslash/mode-icons.git synced 2024-12-24 13:48:04 +01:00

Show icons instead of mode names

Find a file

Matthew Fidler 30b56c9c37 Add generated icons		2016-04-04 08:18:10 -05:00
icons	Add generated icons	2016-04-04 08:18:10 -05:00
scripts	Add Makefile with dist rule	2012-11-11 03:01:29 +01:00
.gitignore	Ignore dist files	2012-11-11 03:12:42 +01:00
CHANGELOG.md	Add emoji support. (Undo-Tree = 🌿)	2016-04-01 01:28:18 -05:00
CONTRIBUTING.md	Add contributing guidelines	2016-02-21 14:46:02 +01:00
Makefile	No need for the -j flag	2012-11-11 03:05:52 +01:00
mode-icons.el	Generate xpms for font icons, when not present	2016-04-04 08:15:38 -05:00
README.org	Add mode-icons-grayscale-transform option	2016-04-01 00:13:00 -05:00

README.org

mode-icons

Requirements
Installation
- manually
Usage
- Ignoring mode-icons in other buffers
- Changing how mode-icons recolors images

Show icons instead of mode names in emacs.

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

Modes	icon
Coffee
CSS
Emacs-Lisp
Haml
HTML
JS
Lisp
Org-mode
PHP
Python
Ruby
SVG
Sass
Scheme
Shell
Slim
YAML

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.

Ignoring mode-icons in other buffers

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)

Changing how mode-icons recolors images

Additionally, if the image icon was an xpm icon, then you can have it changed to match your mode-line face. In the example below, the inactive mode-line shows the emacs and yasnippet icon changed to match the inactive mode-line:

This is enabled by default, and can be disabled by:

(setq mode-icons-desaturate-inactive nil)

You can also change the icon to match the active mode line (disabled by default):

(setq mode-icons-desaturate-active t)

Some of the black and white images are tagged as black and white and are automatically recolored to match the mode-line face. You can turn this off and use the black and white image by setting:

(setq mode-icons-grayscale-transform nil)