{"id":13646606,"url":"https://github.com/ryuslash/mode-icons","last_synced_at":"2025-07-15T13:19:57.532Z","repository":{"id":7879139,"uuid":"9253665","full_name":"ryuslash/mode-icons","owner":"ryuslash","description":"Show icons instead of mode names","archived":false,"fork":false,"pushed_at":"2023-09-11T00:20:49.000Z","size":863,"stargazers_count":159,"open_issues_count":12,"forks_count":28,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-22T17:16:54.352Z","etag":null,"topics":["emacs-lisp","emacs-packages","gui","icons","mode-line"],"latest_commit_sha":null,"homepage":"http://projects.ryuslash.org/mode-icons/","language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ryuslash.png","metadata":{"files":{"readme":"README.org","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2013-04-06T01:13:05.000Z","updated_at":"2024-09-06T04:25:27.000Z","dependencies_parsed_at":"2024-01-14T10:01:46.361Z","dependency_job_id":"85a53ea0-1596-4f8f-b5e9-351de6b2fa98","html_url":"https://github.com/ryuslash/mode-icons","commit_stats":{"total_commits":263,"total_committers":18,"mean_commits":14.61111111111111,"dds":"0.44106463878326996","last_synced_commit":"a5f978e84e07a1d79c6c8e35043ac93d8e5d50ed"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/ryuslash/mode-icons","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryuslash%2Fmode-icons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryuslash%2Fmode-icons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryuslash%2Fmode-icons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryuslash%2Fmode-icons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ryuslash","download_url":"https://codeload.github.com/ryuslash/mode-icons/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryuslash%2Fmode-icons/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265437625,"owners_count":23765124,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["emacs-lisp","emacs-packages","gui","icons","mode-line"],"created_at":"2024-08-02T01:03:00.691Z","updated_at":"2025-07-15T13:19:57.493Z","avatar_url":"https://github.com/ryuslash.png","language":"Emacs Lisp","funding_links":[],"categories":["Emacs Lisp"],"sub_categories":[],"readme":"#+TITLE: mode-icons\n#+DATE: Monday, Dec 21 2015\n#+STARTUP: content\n\n[[https://melpa.org/#/mode-icons][file:https://melpa.org/packages/mode-icons-badge.svg]]\n[[https://stable.melpa.org/#/mode-icons][file:https://stable.melpa.org/packages/mode-icons-badge.svg]]\n\nShow icons instead of mode names in emacs.\n\n[[https://raw.githubusercontent.com/rhoit/mode-icons/dump/screenshots/screenshot01.png]]\n\nSome of the modes that have icons instead of names now:\n\n| Modes      | icon                                                                     |\n|------------+--------------------------------------------------------------------------|\n| Coffee     | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/coffee.png]] |\n| CSS        | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/css.png]]    |\n| Emacs-Lisp | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/emacs.png]]  |\n| Haml       | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/haml.png]]   |\n| HTML       | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/html.png]]   |\n| JS         | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/js.png]]     |\n| Lisp       | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/cl.png]]     |\n| Org-mode   | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/org.png]]    |\n| PHP        | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/php.png]]    |\n| Python     | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/python.png]] |\n| Ruby       | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/ruby.png]]   |\n| SVG        | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/svg.png]]    |\n| Sass       | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/sass.png]]   |\n| Scheme     | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/scheme.png]] |\n| Shell      | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/bash.png]]   |\n| Slim       | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/slim.png]]   |\n| YAML       | [[https://raw.githubusercontent.com/rhoit/mode-icons/dump/icons/yaml.png]]   |\n\n* Requirements\n\n  As of version 0.3.0 you can also use icons from some icon fonts,\n  specifically:\n\n  - [[http://fontawesome.io/][Font Awesome]]\n  - [[https://octicons.github.com/][GitHub Octicons]]\n  - [[http://fizzed.com/oss/font-mfizz][Font Mfizz]]\n  - [[https://icomoon.io/#icons-icomoon][IcoMoon]]\n\n  The icons look the best if you have the fonts installed on your\n  system and mode-icons will not do this for you.\n\n* Installation\n** Manually\n\n   Place ~mode-icons.el~ somewhere in your =load-path= and copy the\n   ~icons/~ directory there as well. Then =require= ~mode-icons~ in your\n   [[http://gnu.org/software/emacs][Emacs]] init file.\n\n* Usage\n  Once installed you can add =(mode-icons-mode)= to your init file.\n** Ignoring mode-icons in other buffers\nWhen looking at buffers with commands like ~ibuffer~, they display the\nicons for the mode names as well. If you don't like this behavior you\ncan change ~mode-icons-change-mode-name~ to be nil:\n\n#+BEGIN_SRC emacs-lisp\n(setq mode-icons-change-mode-name nil)\n#+END_SRC\n \n** Changing how mode-icons recolors images\nAdditionally, if the image icon was an ~xpm~ icon, then you can have\nit changed to match your mode-line face.  In the example below, the\ninactive mode-line shows the emacs and yasnippet icon changed to match\nthe inactive mode-line:\n\n[[http://i.imgur.com/QOM9wYM.png]]\n\nThis also will match whatever color-theme you have installed.  For\nexample, if you use the popular cyberpunk theme, you would see the\nicons colored to match the color-theme\n\n[[http://i.imgur.com/qV6ncIb.png]]\n\nThis is enabled by default, and can be disabled by:\n\n#+BEGIN_SRC emacs-lisp\n(setq mode-icons-desaturate-inactive nil)\n#+END_SRC\n\nYou can also change the icon to match the active mode line (disabled by default):\n\n#+BEGIN_SRC emacs-lisp\n(setq mode-icons-desaturate-active t)\n#+END_SRC\n\nSome of the black and white images are tagged as black and white and\nare automatically recolored to match the mode-line face.  You can turn this off\nand use the black and white image by setting:\n\n#+BEGIN_SRC emacs-lisp\n(setq mode-icons-grayscale-transform nil)\n#+END_SRC\n** Creating xpm images from fonts\nTo create/recreate all the xpm images for the font images, you can\nrun =M-x mode-icons--convert-all-font-icons-to-xpm=.\n\nThis requires a working =gimp= installation, and all the fonts for the\nicons installed.  This will start an inferior scheme process for\n=gimp= in =*mode-icons-gimp*= and convert all the images to xpm files.\n\nAfter the images are created, you can stop the =gimp= process by\ntyping:\n\n=M-x mode-icons--stop-gimp-inferior=\n\nThis should be stopped evetually if there is no input received to gimp.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryuslash%2Fmode-icons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fryuslash%2Fmode-icons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryuslash%2Fmode-icons/lists"}