whatisgithub

What is dotemacs?

rougier/dotemacs — explained in plain English

Analysis updated 2026-07-18 · repo last pushed 2025-01-06

★ 260Audience · developerComplexity · 2/5StaleSetup · easy

In one sentence

A documented Emacs configuration written as a readable file where settings and explanations live side by side, then automatically extracted into a working config.

Mindmap

mindmap
  root((repo))
    What it does
      Document config inline
      Auto extract settings
      Show full example setup
    Tech stack
      Emacs Lisp
      org-babel-tangle
    Use cases
      Maintain readable config
      Remember old decisions
      Share setup with others
    Audience
      Emacs users
      Long term tinkerers
      Documentation minded devs

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Copy this repo's structure as a template for writing your own documented Emacs configuration.

USE CASE 2

Use org-babel-tangle to extract the actual config file from the readable documentation source.

USE CASE 3

Reference the explanations next to each setting to remember why a feature was enabled or disabled months later.

USE CASE 4

Share your personal Emacs setup with others as a single readable document instead of raw code.

What is it built with?

Emacs LispOrg Mode

How does it compare?

rougier/dotemacschiennv2000/orthruscws6206/ai-coding-starter-kit
Stars260261261
Language—Python—
Last pushed2025-01-06——
MaintenanceStale——
Setup difficultyeasymoderateeasy
Complexity2/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires Emacs with org-mode's babel-tangle feature to extract the config from the document.

No license information was mentioned in the explanation.

Copy-paste prompts

Prompt 1
Walk me through how org-babel-tangle turns this repo's documented file into an actual Emacs config Emacs can load.
Prompt 2
Show me how to structure my own Emacs settings the way this repo does, with explanations next to each setting.
Prompt 3
Help me copy one section of this dotemacs setup, like the theme configuration, into my own Emacs config.
Prompt 4
Explain what a specific setting in this repo's Emacs configuration does and why someone might want it.

Frequently asked questions

What is dotemacs?

A documented Emacs configuration written as a readable file where settings and explanations live side by side, then automatically extracted into a working config.

Is dotemacs actively maintained?

Stale — no commits in 1-2 years (last push 2025-01-06).

What license does dotemacs use?

No license information was mentioned in the explanation.

How hard is dotemacs to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is dotemacs for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

What are similar repos?