Skip to content

tee3/unobtrusive-magit-theme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

unobtrusive-magit-theme

An Emacs theme to support Magit and related modes by inheriting from standard Emacs faces such as those provided by Emacs VC and Diff. This allows Magit to blend in with the rest of the theme.

This theme does not follow the Magit advice on theming faces. It will hide the finer details of Magit and result in a loss of visual information. See magit/magit#4079 for a discussion.

NOTE: This currently only works if the theme has not defined faces for Magit.

Installation

Using Emacs package

The unobtrusive-magit-theme is available from both MELPA and MELPA Stable.

See documentation to learn more about Emacs package.

Manual

Add the path to unobtrusive-magit-theme to the custom-theme-load-path.

(add-to-list 'custom-theme-load-path "~/path/to/unobtrusive-magit-theme")

Using use-package

To install automatically using use-package, add the following to your Emacs initialization file.

(use-package unobtrusive-magit-theme
  :load-path "~/path/to/unobtrusive-magit-theme"
  :defer t)

See the documentation to learn more about use-package.

Usage

Load the desired theme, then load the unobtrusive-magit theme.

For example, to improve the Magit faces for the built-in manoj-dark theme, run the following commands within Emacs.

M-x load-theme RET manoj-dark
M-x load-theme RET unobtrusive-magit

The unobtrusive-magit theme should be disabled when the desired frame is disabled.

M-x disable-theme RET unobtrusive-magit
M-x disable-theme RET manoj-dark

Screenshots

There are screenshots showing the changes to a theme both before and after loading the unobtrusive-magit theme. Each screenshot shows several windows containing equivalent Emacs VC buffers on the left side of the screen and Magit buffers on the right side of the screen.

The screenshots were generated using the system screenshot tool.

GUI Default Theme

The default theme for the GUI Emacs has no support for Magit.

Default

GUI Default Theme

With unobtrusive-magit

GUI Default Theme with Unobtrusive Magit

GUI manoj-dark (built-in) Theme

The manoj-dark theme for the GUI Emacs has no support for Magit.

Without unobtrusive-magit

GUI manoj-dark Theme

With unobtrusive-magit

GUI manoj-dark Theme with Unobtrusive Magit

GUI mustang (via package) Theme

The mustang theme for the GUI Emacs has no support for Magit.

Without unobtrusive-magit

GUI mustang Theme

With unobtrusive-magit

GUI mustang Theme with Unobtrusive Magit

Acknowledgments

Contributing

See CONTRIBUTING

About

An unobtrusive Magit theme for Emacs.

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published