{"id":13443411,"url":"https://github.com/seagle0128/doom-modeline","last_synced_at":"2025-05-15T12:05:52.224Z","repository":{"id":37742413,"uuid":"136944483","full_name":"seagle0128/doom-modeline","owner":"seagle0128","description":"A fancy and fast mode-line inspired by minimalism design.","archived":false,"fork":false,"pushed_at":"2025-04-20T05:50:08.000Z","size":1502,"stargazers_count":1361,"open_issues_count":13,"forks_count":165,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-20T06:28:29.469Z","etag":null,"topics":["all-the-icons","doom-emacs","doom-modeline","elisp","emacs","emacs-lisp","mode-line","modeline"],"latest_commit_sha":null,"homepage":"https://seagle0128.github.io/doom-modeline/","language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seagle0128.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-06-11T15:20:04.000Z","updated_at":"2025-04-20T05:50:12.000Z","dependencies_parsed_at":"2023-12-12T03:23:45.940Z","dependency_job_id":"9dd9ea87-96af-4ebc-a5f1-73dd9dc3b66a","html_url":"https://github.com/seagle0128/doom-modeline","commit_stats":null,"previous_names":[],"tags_count":103,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seagle0128%2Fdoom-modeline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seagle0128%2Fdoom-modeline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seagle0128%2Fdoom-modeline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seagle0128%2Fdoom-modeline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seagle0128","download_url":"https://codeload.github.com/seagle0128/doom-modeline/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254337613,"owners_count":22054253,"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":["all-the-icons","doom-emacs","doom-modeline","elisp","emacs","emacs-lisp","mode-line","modeline"],"created_at":"2024-07-31T03:02:00.337Z","updated_at":"2025-05-15T12:05:47.212Z","avatar_url":"https://github.com/seagle0128.png","language":"Emacs Lisp","funding_links":["https://paypal.me/seagle0128","https://www.buymeacoffee.com/s9giES1"],"categories":["Emacs Lisp"],"sub_categories":[],"readme":"# doom-modeline\n\n[![Build Status](https://github.com/seagle0128/doom-modeline/workflows/CI/badge.svg?branch=master)](https://github.com/seagle0128/doom-modeline/actions)\n[![Release Tag](https://img.shields.io/github/tag/seagle0128/doom-modeline.svg?label=Release)](https://github.com/seagle0128/doom-modeline/release)\n[![License](http://img.shields.io/:License-GPL3-blue.svg)](License)\n[![MELPA](https://melpa.org/packages/doom-modeline-badge.svg)](https://melpa.org/#/doom-modeline)\n[![MELPA Stable](https://stable.melpa.org/packages/doom-modeline-badge.svg)](https://stable.melpa.org/#/doom-modeline)\n\n\u003c!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc --\u003e\n\n## Table of Contents\n\n- [Feature](#feature)\n- [Screenshots](#screenshots)\n- [Install](#install)\n  - [Manual](#manual)\n  - [Use-package](#use-package)\n- [Customize](#customize)\n- [FAQ](#faq)\n- [Donate](#donate)\n\n\u003c!-- markdown-toc end --\u003e\n\nA fancy and fast mode-line inspired by minimalism design.\n\nIt's integrated into [Centaur Emacs](https://github.com/seagle0128/.emacs.d), [Doom\nEmacs](https://github.com/hlissner/doom-emacs) and\n[Spacemacs](https://github.com/syl20bnr/spacemacs).\n\n## Feature\n\nThe `doom-modeline` was designed for minimalism, and offers:\n\n- A match count panel (for `anzu`, `visual-replace`, `iedit`, `multiple-cursors`, `symbol-overlay`,\n  and `evil-search`, etc.)\n- An indicator for recording a macro\n- Current environment version (e.g. `python`, `ruby`, `go`, etc.) in the major-mode\n- A customizable mode-line height (see `doom-modeline-height`)\n- A minor modes segment which is compatible with `minions`\n- An error/warning count segment for `flymake`/`flycheck`\n- A workspace number/name segment for `eyebrowse` or `tab-bar-mode`\n- A perspective name segment for `persp-mode`\n- A window number segment for `ace-window`, `winum` and `window-numbering`\n- An indicator for modal editing state, including `evil`, `overwrite`, `god`, `ryo` and\n  `xah-fly-keys`, etc.\n- An indicator for `battery` status\n- An indicator for current input method\n- An indicator for debug state\n- An indicator for remote host\n- An indicator for Kubernetes state with [`kele.el`](https://github.com/jinnovation/kele.el)\n- An indicator for LSP state with `lsp-mode` or `eglot`\n- An indicator for GitHub notifications\n- An indicator for unread emails with `mu4e-alert` and `gnus`\n- An indicator for IRC notifications with `circe`, `rcirc` or `erc`\n- An indicator for buffer position which is compatible with `nyan-mode` or `poke-line`\n- An indicator for party `parrot`\n- An indicator for PDF page number with `pdf-tools`\n- An indicator for markdown/org preview with `grip`\n- Truncated file name, file icon, buffer state and project name in buffer\n  information segment, which is compatible with `project`, `projectile` and\n  `find-file-in-project`.\n- New mode-line for `Info-mode` buffers\n- New package mode-line for `paradox`\n- New mode-line for `helm` buffers\n- New mode-line for `git-timemachine` buffers\n\n## Screenshots\n\n![modeline](https://user-images.githubusercontent.com/140797/49694177-10dcd280-fbc0-11e8-8d21-971ede6afdb5.png \"Mode-line\")\n\n![search_replace](https://user-images.githubusercontent.com/140797/49694189-6913d480-fbc0-11e8-93ae-9578455dcd2c.png \"Search and Replace\")\n\n![evil_search](https://user-images.githubusercontent.com/140797/162925065-0ffe40fd-1efd-469b-bf09-c62fe2d22fd2.png \"Evil Search\")\n\n![macro](https://user-images.githubusercontent.com/140797/49694199-cc056b80-fbc0-11e8-9bb1-533b1e64da66.png \"Macro\")\n\n![no_icons](https://user-images.githubusercontent.com/140797/51301117-0805d900-1a69-11e9-957d-b4c7a70a1cf8.png \"No Icons\")\n\n![color_icon_cpp](https://user-images.githubusercontent.com/140797/50414928-3c63ec00-0853-11e9-9b26-6a1df278d332.png \"Color C++ icon\")\n\n![color_icon_java](https://user-images.githubusercontent.com/140797/50415081-1428bd00-0854-11e9-9ae5-91805290c524.png \"Color Java icon\")\n\n![color_icon_elisp](https://user-images.githubusercontent.com/140797/50415381-9f568280-0855-11e9-9478-34a6dd614d96.png \"Color Elisp icon\")\n\n![evil_normal_state_icon](https://user-images.githubusercontent.com/140797/68990534-332aa600-088f-11ea-920f-20c9527a6466.png \"Evil Normal State icon\")\n\n![evil_insert_state_icon](https://user-images.githubusercontent.com/140797/68990540-4dfd1a80-088f-11ea-8e53-ab77af4c58c2.png \"Evil Insert State icon\")\n\n![evil_normal_state](https://user-images.githubusercontent.com/140797/49694476-b8103880-fbc5-11e8-9c18-91f5e9258333.png \"Evil Normal State\")\n\n![evil_insert_state](https://user-images.githubusercontent.com/140797/49694461-8b5c2100-fbc5-11e8-993e-d97baa9f01af.png \"Evil Insert State\")\n\n![lsp_version](https://user-images.githubusercontent.com/140797/53592864-c751c180-3bc9-11e9-9914-493007c013d5.png \"Perspective, LSP, Version, VCS and Flycheck\")\n\n![perspective](https://user-images.githubusercontent.com/140797/49694481-e0983280-fbc5-11e8-8cb2-c8d2e782bcdb.png \"Perspective, LSP, Version and VCS\")\n\n![notifications](https://user-images.githubusercontent.com/140797/53592683-64602a80-3bc9-11e9-8054-91f79aa930b9.png \"Notifications\")\n\n![minions](https://user-images.githubusercontent.com/140797/50301291-de857c00-04c1-11e9-84c5-bfbc8de8295f.png \"Minions and minor modes\")\n\n![debug](https://user-images.githubusercontent.com/140797/50302008-c57dca80-04c3-11e9-8578-50154ef4f9f0.png \"Debug state\")\n\n![nyan_parrot](https://user-images.githubusercontent.com/140797/51301061-da209480-1a68-11e9-9f64-905d889df9d6.png \"Nyan and Parrot\")\n\n![irc](https://user-images.githubusercontent.com/140797/69004814-20c67000-0954-11ea-8489-f5a527a80574.png \"IRC Notifications\")\n\n![battery](https://user-images.githubusercontent.com/140797/53593622-ba35d200-3bcb-11e9-85b3-38d64d05c127.png \"Battery\")\n\n![package](https://user-images.githubusercontent.com/140797/57503916-e769d380-7324-11e9-906d-44c79f7408a3.png \"Package\")\n\n![info](https://user-images.githubusercontent.com/140797/57506248-d96c8080-732d-11e9-8167-644c8fc4e0db.png \"Info\")\n\n![helm](https://user-images.githubusercontent.com/140797/57506112-6531dd00-732d-11e9-8a5e-22166f42dd4c.png \"Helm\")\n\n## Install\n\n### Manual\n\nFrom melpa, `M-x package-install RET doom-modeline RET`.\n\nIn `init.el`,\n\n```emacs-lisp\n(require 'doom-modeline)\n(doom-modeline-mode 1)\n```\n\nor\n\n```emacs-lisp\n(add-hook 'after-init-hook #'doom-modeline-mode)\n```\n\n### Use-package\n\n```emacs-lisp\n(use-package doom-modeline\n  :ensure t\n  :init (doom-modeline-mode 1))\n```\n\nor\n\n```emacs-lisp\n(use-package doom-modeline\n  :ensure t\n  :hook (after-init . doom-modeline-mode))\n```\n\nThis package is able to display icons if `nerd-icons` package and required\nfonts are installed. Run `M-x nerd-icons-install-fonts` to install the\nnecessary fonts. Please refer to the\n[installation guide](https://github.com/rainstormstudio/nerd-icons.el#installing-fonts).\n\nStrongly recommend to use\n[doom-themes](https://github.com/hlissner/emacs-doom-themes) at the same time.\n\n## Customize\n\nRun `M-x customize-group RET doom-modeline RET` or set the variables.\n\n```emacs-lisp\n;; If non-nil, cause imenu to see `doom-modeline' declarations.\n;; This is done by adjusting `lisp-imenu-generic-expression' to\n;; include support for finding `doom-modeline-def-*' forms.\n;; Must be set before loading doom-modeline.\n(setq doom-modeline-support-imenu t)\n\n;; How tall the mode-line should be. It's only respected in GUI.\n;; If the actual char height is larger, it respects the actual height.\n(setq doom-modeline-height 25)\n\n;; How wide the mode-line bar should be. It's only respected in GUI.\n(setq doom-modeline-bar-width 4)\n\n;; Whether to use hud instead of default bar. It's only respected in GUI.\n(setq doom-modeline-hud nil)\n\n;; The limit of the window width.\n;; If `window-width' is smaller than the limit, some information won't be\n;; displayed. It can be an integer or a float number. `nil' means no limit.\"\n(setq doom-modeline-window-width-limit 85)\n\n;; Override attributes of the face used for padding.\n;; If the space character is very thin in the modeline, for example if a\n;; variable pitch font is used there, then segments may appear unusually close.\n;; To use the space character from the `fixed-pitch' font family instead, set\n;; this variable to `(list :family (face-attribute 'fixed-pitch :family))'.\n(setq doom-modeline-spc-face-overrides nil)\n\n;; How to detect the project root.\n;; nil means to use `default-directory'.\n;; The project management packages have some issues on detecting project root.\n;; e.g. `projectile' doesn't handle symlink folders well, while `project' is unable\n;; to hanle sub-projects.\n;; You can specify one if you encounter the issue.\n(setq doom-modeline-project-detection 'auto)\n\n;; Determines the style used by `doom-modeline-buffer-file-name'.\n;;\n;; Given ~/Projects/FOSS/emacs/lisp/comint.el\n;;   auto =\u003e emacs/l/comint.el (in a project) or comint.el\n;;   truncate-upto-project =\u003e ~/P/F/emacs/lisp/comint.el\n;;   truncate-from-project =\u003e ~/Projects/FOSS/emacs/l/comint.el\n;;   truncate-with-project =\u003e emacs/l/comint.el\n;;   truncate-except-project =\u003e ~/P/F/emacs/l/comint.el\n;;   truncate-upto-root =\u003e ~/P/F/e/lisp/comint.el\n;;   truncate-all =\u003e ~/P/F/e/l/comint.el\n;;   truncate-nil =\u003e ~/Projects/FOSS/emacs/lisp/comint.el\n;;   relative-from-project =\u003e emacs/lisp/comint.el\n;;   relative-to-project =\u003e lisp/comint.el\n;;   file-name =\u003e comint.el\n;;   file-name-with-project =\u003e FOSS|comint.el\n;;   buffer-name =\u003e comint.el\u003c2\u003e (uniquify buffer name)\n;;\n;; If you are experiencing the laggy issue, especially while editing remote files\n;; with tramp, please try `file-name' style.\n;; Please refer to https://github.com/bbatsov/projectile/issues/657.\n(setq doom-modeline-buffer-file-name-style 'auto)\n\n;; Whether display icons in the mode-line.\n;; While using the server mode in GUI, should set the value explicitly.\n(setq doom-modeline-icon t)\n\n;; Whether display the icon for `major-mode'. It respects option `doom-modeline-icon'.\n(setq doom-modeline-major-mode-icon t)\n\n;; Whether display the colorful icon for `major-mode'.\n;; It respects `nerd-icons-color-icons'.\n(setq doom-modeline-major-mode-color-icon t)\n\n;; Whether display the icon for the buffer state. It respects option `doom-modeline-icon'.\n(setq doom-modeline-buffer-state-icon t)\n\n;; Whether display the modification icon for the buffer.\n;; It respects option `doom-modeline-icon' and option `doom-modeline-buffer-state-icon'.\n(setq doom-modeline-buffer-modification-icon t)\n\n;; Whether display the lsp icon. It respects option `doom-modeline-icon'.\n(setq doom-modeline-lsp-icon t)\n\n;; Whether display the time icon. It respects option `doom-modeline-icon'.\n(setq doom-modeline-time-icon t)\n\n;; Whether display the live icons of time.\n;; It respects option `doom-modeline-icon' and option `doom-modeline-time-icon'.\n(setq doom-modeline-time-live-icon t)\n\n;; Whether to use an analogue clock svg as the live time icon.\n;; It respects options `doom-modeline-icon', `doom-modeline-time-icon', and `doom-modeline-time-live-icon'.\n(setq doom-modeline-time-analogue-clock t)\n\n;; The scaling factor used when drawing the analogue clock.\n(setq doom-modeline-time-clock-size 0.7)\n\n;; Whether to use unicode as a fallback (instead of ASCII) when not using icons.\n(setq doom-modeline-unicode-fallback nil)\n\n;; Whether display the buffer name.\n(setq doom-modeline-buffer-name t)\n\n;; Whether highlight the modified buffer name.\n(setq doom-modeline-highlight-modified-buffer-name t)\n\n;; When non-nil, mode line displays column numbers zero-based.\n;; See `column-number-indicator-zero-based'.\n(setq doom-modeline-column-zero-based t)\n\n;; Specification of \\\"percentage offset\\\" of window through buffer.\n;; See `mode-line-percent-position'.\n(setq doom-modeline-percent-position '(-3 \"%p\"))\n\n;; Format used to display line numbers in the mode line.\n;; See `mode-line-position-line-format'.\n(setq doom-modeline-position-line-format '(\"L%l\"))\n\n;; Format used to display column numbers in the mode line.\n;; See `mode-line-position-column-format'.\n(setq doom-modeline-position-column-format '(\"C%c\"))\n\n;; Format used to display combined line/column numbers in the mode line. See `mode-line-position-column-line-format'.\n(setq doom-modeline-position-column-line-format '(\"%l:%c\"))\n\n;; Whether display the minor modes in the mode-line.\n(setq doom-modeline-minor-modes nil)\n\n;; If non-nil, a word count will be added to the selection-info modeline segment.\n(setq doom-modeline-enable-word-count nil)\n\n;; Major modes in which to display word count continuously.\n;; Also applies to any derived modes. Respects `doom-modeline-enable-word-count'.\n;; If it brings the sluggish issue, disable `doom-modeline-enable-word-count' or\n;; remove the modes from `doom-modeline-continuous-word-count-modes'.\n(setq doom-modeline-continuous-word-count-modes '(markdown-mode gfm-mode org-mode))\n\n;; Whether display the buffer encoding.\n(setq doom-modeline-buffer-encoding t)\n\n;; Whether display the indentation information.\n(setq doom-modeline-indent-info nil)\n\n;; Whether display the total line number。\n(setq doom-modeline-total-line-number nil)\n\n;; Whether display the icon of vcs segment. It respects option `doom-modeline-icon'.\"\n(setq doom-modeline-vcs-icon t)\n\n;; The maximum displayed length of the branch name of version control.\n(setq doom-modeline-vcs-max-length 15)\n\n;; The function to display the branch name.\n(setq doom-modeline-vcs-display-function #'doom-modeline-vcs-name)\n\n;; Whether display the icon of check segment. It respects option `doom-modeline-icon'.\n(setq doom-modeline-check-icon t)\n\n;; If non-nil, only display one number for check information if applicable.\n(setq doom-modeline-check-simple-format nil)\n\n;; The maximum number displayed for notifications.\n(setq doom-modeline-number-limit 99)\n\n;; Whether display the project name. Non-nil to display in the mode-line.\n(setq doom-modeline-project-name t)\n\n;; Whether display the workspace name. Non-nil to display in the mode-line.\n(setq doom-modeline-workspace-name t)\n\n;; Whether display the perspective name. Non-nil to display in the mode-line.\n(setq doom-modeline-persp-name t)\n\n;; If non nil the default perspective name is displayed in the mode-line.\n(setq doom-modeline-display-default-persp-name nil)\n\n;; If non nil the perspective name is displayed alongside a folder icon.\n(setq doom-modeline-persp-icon t)\n\n;; Whether display the `lsp' state. Non-nil to display in the mode-line.\n(setq doom-modeline-lsp t)\n\n;; Whether display the GitHub notifications. It requires `ghub' package.\n(setq doom-modeline-github nil)\n\n;; The interval of checking GitHub.\n(setq doom-modeline-github-interval (* 30 60))\n\n;; Whether display the modal state.\n;; Including `evil', `overwrite', `god', `ryo' and `xah-fly-keys', etc.\n(setq doom-modeline-modal t)\n\n;; Whether display the modal state icon.\n;; Including `evil', `overwrite', `god', `ryo' and `xah-fly-keys', etc.\n(setq doom-modeline-modal-icon t)\n\n;; Whether display the modern icons for modals.\n(setq doom-modeline-modal-modern-icon t)\n\n;; When non-nil, always show the register name when recording an evil macro.\n(setq doom-modeline-always-show-macro-register nil)\n\n;; Whether display the mu4e notifications. It requires `mu4e-alert' package.\n(setq doom-modeline-mu4e nil)\n;; also enable the start of mu4e-alert\n(mu4e-alert-enable-mode-line-display)\n\n;; Whether display the gnus notifications.\n(setq doom-modeline-gnus t)\n\n;; Whether gnus should automatically be updated and how often (set to 0 or smaller than 0 to disable)\n(setq doom-modeline-gnus-timer 2)\n\n;; Wheter groups should be excludede when gnus automatically being updated.\n(setq doom-modeline-gnus-excluded-groups '(\"dummy.group\"))\n\n;; Whether display the IRC notifications. It requires `circe' or `erc' package.\n(setq doom-modeline-irc t)\n\n;; Function to stylize the irc buffer names.\n(setq doom-modeline-irc-stylize 'identity)\n\n;; Whether display the battery status. It respects `display-battery-mode'.\n(setq doom-modeline-battery t)\n\n;; Whether display the time. It respects `display-time-mode'.\n(setq doom-modeline-time t)\n\n;; Whether display the misc segment on all mode lines.\n;; If nil, display only if the mode line is active.\n(setq doom-modeline-display-misc-in-all-mode-lines t)\n\n;; The function to handle `buffer-file-name'.\n(setq doom-modeline-buffer-file-name-function #'identity)\n\n;; The function to handle `buffer-file-truename'.\n(setq doom-modeline-buffer-file-truename-function #'identity)\n\n;; Whether display the environment version.\n(setq doom-modeline-env-version t)\n;; Or for individual languages\n(setq doom-modeline-env-enable-python t)\n(setq doom-modeline-env-enable-ruby t)\n(setq doom-modeline-env-enable-perl t)\n(setq doom-modeline-env-enable-go t)\n(setq doom-modeline-env-enable-elixir t)\n(setq doom-modeline-env-enable-rust t)\n\n;; Change the executables to use for the language version string\n(setq doom-modeline-env-python-executable \"python\") ; or `python-shell-interpreter'\n(setq doom-modeline-env-ruby-executable \"ruby\")\n(setq doom-modeline-env-perl-executable \"perl\")\n(setq doom-modeline-env-go-executable \"go\")\n(setq doom-modeline-env-elixir-executable \"iex\")\n(setq doom-modeline-env-rust-executable \"rustc\")\n\n;; What to display as the version while a new one is being loaded\n(setq doom-modeline-env-load-string \"...\")\n\n;; By default, almost all segments are displayed only in the active window. To\n;; display such segments in all windows, specify e.g.\n(setq doom-modeline-always-visible-segments '(mu4e irc))\n\n;; Hooks that run before/after the modeline version string is updated\n(setq doom-modeline-before-update-env-hook nil)\n(setq doom-modeline-after-update-env-hook nil)\n```\n\n## FAQ\n\n1. How to display icons correctly?\n\n   [nerd-icons](https://github.com/rainstormstudio/nerd-icons.el) are necessary.\n   Then run `M-x nerd-icons-install-fonts` to install the resource fonts.\n   On Windows, the fonts should be installed manually. `nerd-icons` supports both\n   GUI and TUI.\n\n   If you don't like color icons, `(setq nerd-icons-color-icons nil)`\n   to disable it. Please refer to [nerd-icons.el](https://github.com/rainstormstudio/nerd-icons.el)\n   for details.\n\n   If you prefer [all-the-icons](https://github.com/domtronn/all-the-icons.el), please\n   use release `3.4.0`. It hasn't been supported since `4.0.0`.\n\n1. I am experiencing the laggy issue, how to resolve it?\n\n   Add this configuration into your init file:\n\n   ```emacs-lisp\n   ;; Don’t compact font caches during GC.\n   (setq inhibit-compacting-font-caches t)\n   ```\n\n1. A ridiculous path is displayed on the mode-line while visiting a symbolink.\n\n   It's the default behaviors of Vanilla Emacs. If you want to display the real\n   names, please put this into your init file.\n\n   ```emacs-lisp\n   (setq find-file-visit-truename t)\n   ```\n\n   If the file is controlled by vc, refer to the documentation of\n   `vc-follow-symlinks`.\n\n1. Why doesn't change of branch reflect in modeline?\n\n   Actually it's related to `magit` and `vc-mode`.\n\n   - Workaround:\n     - Revert the buffers manually.\n     - `(setq auto-revert-check-vc-info t)` brings the performance issue.\n   - Refer to:\n     - [The mode-line information isn’t always\n       up-to-date](https://magit.vc/manual/magit/The-mode_002dline-information-isn_0027t-always-up_002dto_002ddate.html)\n     - [Maybe provide an alternative to VC's mode-line\n       information](https://github.com/magit/magit/issues/2687)\n\n1. Can I add my mode-line segments myself? How to do that?\n   How can I define my own mode-line?\n\n   There are two methods.\n\n   - If the information is simple, just add to `mode-line-misc-info` or `global-mode-string`.\n\n   - Use `doom-modeline-def-modeline` to define your own mode-line and set it as\n     default.\n\n     For example:\n\n     ```emacs-lisp\n     ;; Define your custom doom-modeline\n     (doom-modeline-def-modeline 'my-simple-line\n       '(bar matches buffer-info remote-host buffer-position parrot selection-info)\n       '(misc-info minor-modes input-method buffer-encoding major-mode process vcs check))\n\n     ;; Set default mode-line\n     (add-hook 'doom-modeline-mode-hook\n               (lambda ()\n                 (doom-modeline-set-modeline 'my-simple-line 'default)))\n\n     ;; Configure other mode-lines based on major modes\n     (add-to-list 'doom-modeline-mode-alist '(my-mode . my-simple-line))\n\n     ;; Or disable other mode-lines\n     (setq 'doom-modeline-mode-alist nil)\n     ```\n\n1. How to specify font family and size in modeline?\n\n   For example:\n\n   ```emacs-lisp\n   (setq doom-modeline-height 1) ; optional\n   (if (facep 'mode-line-active)\n       (set-face-attribute 'mode-line-active nil :family \"Noto Sans\" :height 100) ; For 29+\n     (set-face-attribute 'mode-line nil :family \"Noto Sans\" :height 100))\n   (set-face-attribute 'mode-line-inactive nil :family \"Noto Sans\" :height 100)\n   ```\n\n   or\n\n   ```emacs-lisp\n   (setq doom-modeline-height 1) ; optional\n   (custom-set-faces\n     '(mode-line ((t (:family \"Noto Sans\" :height 0.9))))\n     '(mode-line-active ((t (:family \"Noto Sans\" :height 0.9)))) ; For 29+\n     '(mode-line-inactive ((t (:family \"Noto Sans\" :height 0.9)))))\n   ```\n\n   Please refer to\n   [#189](https://github.com/seagle0128/doom-modeline/issues/189) and\n   [#301](https://github.com/seagle0128/doom-modeline/issues/301).\n\n1. The right side of the modeline is cut off. How to fix it?\n\n   - Tweak `nerd-icons-scale-factor`. e.g. `(setq nerd-icons-scale-factor 1.1)`\n   - Use another font family or size. See above.\n\n1. How to disable symbolic links expanding in mode-line?\n\n   If you encounter the issue like this\n\n   ![Screenshot](https://user-images.githubusercontent.com/9449246/62822565-c3f93380-bb74-11e9-95f6-f9c24a6cbd14.png)\n\n   please try this:\n\n   ```emacs-lisp\n   ;; built-in `project' on 26+\n   (setq doom-modeline-project-detection 'project)\n   ;; or `find-in-project' if it's installed\n   (setq doom-modeline-project-detection 'ffip)\n   ```\n\n   For more details, refer to\n   [#209](https://github.com/seagle0128/doom-modeline/issues/209) and\n   [#224](https://github.com/seagle0128/doom-modeline/issues/224).\n\n1. Is `doom-modeline` able to show match count while search with `evil-search`?\n\n   Yes. For better experience, should enable `anzu-mode` and load `evil-anzu`.\n\n1. How to show that the R is running in inferior ess R mode?\n\n   The ess R mode modifies `mode-line-buffer-identification` directly to display the status.\n   To display the status in `doom-modeline`, you can add the status to `mode-line-process`\n   or `global-mode-string` as below.\n\n   ```emacs-lisp\n   (add-hook 'inferior-ess-mode-hook\n         (lambda ()\n           (add-to-list 'mode-line-process '(:eval (nth ess--busy-count ess-busy-strings)))))\n   ```\n\n1. How to display company mode-line information?\n\n   Enable `doom-modeline-minor-modes` or `(add-to-list 'global-mode-string company-lighter)`.\n\n1. How to display LaTeX compilation information in the mode line?\n\n   Use [process](https://github.com/haji-ali/procress) package.\n   Please refer to [#387](https://github.com/seagle0128/doom-modeline/issues/387) for more details.\n\n   ```emacs-lisp\n   (require 'procress)\n   (procress-load-default-svg-images)\n   (add-hook 'LaTeX-mode-hook #'procress-auctex-mode)\n   ```\n\n1. How to prevent mode-line aligning with fill column in `visual-fill-column-mode`?\n\n   Use `(setq mode-line-right-align-edge 'right-fringe)`.\n   Please refer to [#672](https://github.com/seagle0128/doom-modeline/issues/672) for more details.\n\n1. How to display match counts in `visual-replace`?\n\n   It respects `visual-replace-display-total`, so you should use `(setq visual-replace-display-total t)` to display.\n\n## Donate\n\nIf you think it's helpful for you, please consider paying a cup of coffee for\nme. Thank you! :smile:\n\n\u003cimg\nsrc=\"https://user-images.githubusercontent.com/140797/65818854-44204900-e248-11e9-9cc5-3e6339587cd8.png\"\nalt=\"Alipay\" width=\"120\"/\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n\u003cimg\nsrc=\"https://user-images.githubusercontent.com/140797/65818844-366ac380-e248-11e9-931c-4bd872d0566b.png\"\nalt=\"Wechat Pay\" width=\"120\"/\u003e\n\n\u003ca href=\"https://paypal.me/seagle0128\" target=\"_blank\"\u003e\n\u003cimg\nsrc=\"https://www.paypalobjects.com/digitalassets/c/website/marketing/apac/C2/logos-buttons/optimize/44_Grey_PayPal_Pill_Button.png\"\nalt=\"PayPal\" width=\"120\" /\u003e\n\u003c/a\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n\u003ca href=\"https://www.buymeacoffee.com/s9giES1\" target=\"_blank\"\u003e\n\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/default-orange.png\" alt=\"Buy Me A Coffee\"\nwidth=\"160\"/\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseagle0128%2Fdoom-modeline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseagle0128%2Fdoom-modeline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseagle0128%2Fdoom-modeline/lists"}