{"id":22289417,"url":"https://github.com/tf/prelude","last_synced_at":"2026-02-07T11:31:17.869Z","repository":{"id":66564383,"uuid":"577912746","full_name":"tf/prelude","owner":"tf","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-15T13:25:11.000Z","size":4604,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-01-15T17:36:44.635Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":null,"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},"funding":{"github":"bbatsov","ko_fi":"bbatsov","patreon":"bbatsov","custom":"https://www.paypal.me/bbatsov"}},"created_at":"2022-12-13T20:17:10.000Z","updated_at":"2022-12-13T20:19:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"fd862717-0bd0-4955-8ca9-259685c8acc8","html_url":"https://github.com/tf/prelude","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tf/prelude","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tf%2Fprelude","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tf%2Fprelude/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tf%2Fprelude/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tf%2Fprelude/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tf","download_url":"https://codeload.github.com/tf/prelude/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tf%2Fprelude/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29193565,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T07:37:03.739Z","status":"ssl_error","status_checked_at":"2026-02-07T07:37:03.029Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-12-03T17:09:06.601Z","updated_at":"2026-02-07T11:31:17.855Z","avatar_url":"https://github.com/tf.png","language":"Emacs Lisp","funding_links":["https://github.com/sponsors/bbatsov","https://ko-fi.com/bbatsov","https://patreon.com/bbatsov","https://www.paypal.me/bbatsov","https://www.patreon.com/bbatsov"],"categories":[],"sub_categories":[],"readme":"[![License GPL 3][badge-license]](http://www.gnu.org/licenses/gpl-3.0.txt)\n[![Patreon](https://img.shields.io/badge/patreon-donate-orange.svg)](https://www.patreon.com/bbatsov)\n\nEmacs Prelude\n=============\n\nPrelude is an Emacs distribution that aims to enhance the default\nEmacs experience.  Prelude alters a lot of the default settings,\nbundles a plethora of additional packages and adds its own core\nlibrary to the mix. The final product offers an easy to use Emacs\nconfiguration for Emacs newcomers and lots of additional power for\nEmacs power users.\n\nPrelude is compatible **ONLY with GNU Emacs 25.1+**. In general you're\nadvised to always run Prelude with the latest stable Emacs release.\n\nYou can support the development of Prelude via\n[GitHub Sponsors](https://github.com/sponsors/bbatsov),\n[ko-fi](https://ko-fi.com/bbatsov),\n[PayPal](https://www.paypal.me/bbatsov) and\n[Patreon](https://www.patreon.com/bbatsov).\n\n## Features\n\n* Improved UX, that's still in line with Emacs traditions\n* Sane defaults of baseline Emacs functionality\n* Automatic installation of many major programming modes on demand\n* A curated set of 3rd party packages to enhance the base functionality\n* Simple modular architecture\n* Easy customization\n\nCheck out our [user manual](https://prelude.emacsredux.com) for more information.\n\n## Fast Forward\n\nAssuming you're using an Unix-like OS (`*BSD`, `GNU/Linux`, `macOS`, `Solaris`,\netc), you already have a recent version of Emacs installed, as well as `git` \u0026 `curl` you\ncan skip the whole manual and just type in your favorite shell the\nfollowing command:\n\n```shellsession\n$ curl -L https://git.io/epre | sh\n```\n\nYou can now power up your Emacs, sit back and enjoy Prelude.\n\nThere are two environment variables you can use to control the\nsource repository and the installation directory. To change the\ninstallation directory:\n\n```shellsession\n$ export PRELUDE_INSTALL_DIR=\"$HOME/.emacs.d\" \u0026\u0026 curl -L https://github.com/bbatsov/prelude/raw/master/utils/installer.sh | sh\n```\n\nTo change the source repository:\n\n```shellsession\n$ export PRELUDE_URL=\"https://github.com/yourname/prelude.git\" \u0026\u0026 curl -L https://github.com/bbatsov/prelude/raw/master/utils/installer.sh | sh\n```\n\nNote that the installer will back up any existing `.emacs` file or\n`.emacs.d` since it will unpack Prelude's code in `.emacs.d`. If\nyou're doing a manual install make sure you don't have a `.emacs` file\nor back up your existing `.emacs.d` directory manually.\n\n**Important:** Don't forget to adjust your `prelude-modules.el` file in your personal directory\nonce the installation is done. By default most of the modules\nthat ship with Prelude are **not** loaded.\n\n## Philosophy\n\nPrelude's philosophy is quite simple:\n\n* simple\n* easy to understand and extend\n* stable\n* a foundation for you to build upon, as opposed to some end-user product\n\nThis means that it intentionally doesn't pack all the bells and whistles that it could.\nPrelude aims to enhance the classic Emacs experience without deviating a lot from it - e.g.\nit would never enable something like `evil-mode` (vim keybindings) by default and so on.\n\nAll the third-party packages that it bundles are carefully vetted and are known to be of\ngood quality and to have reliable maintainers. That generally means that Prelude's unlikely\nto immediate adopt some shiny new package, that has established tried and true alternatives.\n\nIn practice this translates to the following:\n\n* Prelude is less opinionated than distros like Spacemacs and Doom Emacs (meaning it's closer to the standard Emacs experience)\n* Prelude installs relatively few additional packages by default\n* Most modules in Prelude are opt-in instead of opt-out (you'll notice the default config enables only a handful of modules)\n* Most modules (e.g. modules for programming languages) are pretty short and feature setup only for essential packages (in some cases that be just the major mode for the language in question)\n* You don't really need to track Prelude's upstream - you're encouraged to just fork it and use it as the basis for your own configuration.\n\nRemember that the ultimate goal of every Emacs user is to create an Emacs setup that reflects their own experience, needs, goals and ideas. Just like Lisp,\nEmacs is nothing but a raw building material for the perfect editing experience.\n\nMore installation options are discussed [here](https://prelude.emacsredux.com/en/latest/installation/).\n\n## User Manual\n\nWhile Emacs Prelude is pretty simple at its core, it does have some specifics that\nare worth learning - e.g. configuration options, load order of modules and personal settings\nand so on.\n\nCheck out our [user manual](https://prelude.emacsredux.com) for more information.\n\nYou can also find a lot of information about specific Prelude features and the rationale behind them on\nmy Emacs blog [Emacs Redux](https://emacsredux.com).\n\n## crux and super-save\n\nA lot of utility commands that used to be part of Prelude were eventually extracted to the [crux](https://github.com/bbatsov/crux) package,\nso they'd be easily available to more people.\nThese days Prelude simply depends on that package.\n\nThe [super-save](https://github.com/bbatsov/super-save) package also used to be part of Prelude in the past.\n\n## Known issues\n\nCheck out the project's\n[issue list](https://github.com/bbatsov/prelude/issues?sort=created\u0026direction=desc\u0026state=open)\na list of unresolved issues. By the way - feel free to fix any of them\nand send me a pull request. :-)\n\n## Support\n\nSupport is available via several channels:\n\n* Prelude's Google Group \u003cemacs-prelude@googlegroups.com\u003e\n* Prelude's Freenode channel (`#prelude-emacs`)\n* [Gitter](https://gitter.im/bbatsov/prelude)\n\n## Contributors\n\nHere's a [list](https://github.com/bbatsov/prelude/contributors) of all the people who have contributed to the\ndevelopment of Emacs Prelude.\n\n## Bugs \u0026 Improvements\n\nBug reports and suggestions for improvements are always\nwelcome. GitHub pull requests are even better! :-)\n\n## License\n\nCopyright © 2011-2021 Bozhidar Batsov and\n[contributors](https://github.com/bbatsov/prelude/contributors).\n\nDistributed under the GNU General Public License, version 3\n\n[badge-license]: https://img.shields.io/badge/license-GPL_3-green.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftf%2Fprelude","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftf%2Fprelude","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftf%2Fprelude/lists"}