Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hristoast/dot-emacs

My init.el
https://github.com/hristoast/dot-emacs

dotfiles emacs emacs-configuration emacs-customizations

Last synced: 2 months ago
JSON representation

My init.el

Awesome Lists containing this project

README

        

# /home/hristos/.emacs.d/

## About

My Emacs configuration. Requires Emacs 29.1 or newer. It sports [my fork](https://git.sr.ht/~hristoast/emacs-material-theme) of the [Material Theme for Emacs](https://github.com/cpaulik/emacs-material-theme) and [Smart Mode Line](https://github.com/Malabarba/smart-mode-line) with the Dark theme. I recommend running this configuration in daemon mode - it's great for GUI Emacs or terminal Emacs.

It sets up Emacs with support for a wide variety of languages, as well as other more opinionated things like: color themes, many aspects of Emacs internals, code completion, and much much more.

## Screenshots

Check out [the screenshots page](https://man.sr.ht/%7Ehristoast/dot-emacs/screenshots.md) on [the wiki](https://man.sr.ht/~hristoast/dot-emacs/).

## Installation

Copy all `.el` files as well as the `lib` and `straight` directories from the root of this repository into your `~/.emacs.d`, start Emacs. It may be wise to `mv` your current `~/.emacs.d` out of the way and start fresh.

Two install methods are demonstrated below:

```
# Put it right in place:
mv -v ~/.emacs.d ~/$(date +%F)-emacs.d
git clone https://git.sr.ht/~hristoast/dot-emacs ~/.emacs.d

# Make symlinks
mv -v ~/.emacs.d ~/$(date +%F)-emacs.d
mkdir ~/.emacs.d
git clone https://git.sr.ht/~hristoast/dot-emacs ~/src/hristoast-dot-emacs
ln -sv ~/src/hristoast-dot-emacs/{init.el,lib,straight} ~/.emacs.d/
```

If you're an Emacs daemon user, your first run should not be in daemon mode so that you can accept the theme (if you choose to use that). After completing the first successful startup, where all packages and etc are installed, you may start the daemon.

After the first run is completed, before closing Emacs be sure to run `M-x all-the-icons-install-fonts RET` so that you get your fonts installed (unless you're not using that).

## Configuring

Large portions of the overall configuration are toggle-able. See [the config page](https://man.sr.ht/%7Ehristoast/dot-emacs/config.md) on the wiki for more information.

## Issues/Notes

* When installing, this configuration should not be ran in daemon mode for the first run (you will need to trust themes that are loaded).
* Some of my keybindings might not work well with terminal Emacs. If that's an issue, don't load them (see [the config wiki page](https://man.sr.ht/%7Ehristoast/dot-emacs/config.md)).
* You can view the startup time in the `*Messages*` buffer, look for a line starting with `[STARTUP] Loading ...`, or in the dashboard (unless you disable that).