gitwtfhub

wtf is dotemacs?

rougier/dotemacs — explained in plain English

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

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

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

Emacs LispOrg Mode

How it stacks up

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 spin it up?

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane