https://github.com/bird-dancer/scame

simple "performant" GNU Emacs 30+ config/framework that uses as much built in stuff as possible and builds upon that where necessary unless you load external-packages.el only built in emacs functions will be used, leading to a very responsive but powerful experience
https://github.com/bird-dancer/scame

dotfiles emacs emacs-configuration emacs-initialization emacs-lisp

Last synced: 2 months ago
JSON representation

simple "performant" GNU Emacs 30+ config/framework that uses as much built in stuff as possible and builds upon that where necessary unless you load external-packages.el only built in emacs functions will be used, leading to a very responsive but powerful experience

• Host: GitHub
• URL: https://github.com/bird-dancer/scame
• Owner: bird-dancer
• Created: 2025-03-18T16:55:27.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2025-03-19T15:29:14.000Z (2 months ago)
• Last Synced: 2025-03-19T16:34:00.534Z (2 months ago)
• Topics: dotfiles, emacs, emacs-configuration, emacs-initialization, emacs-lisp
• Language: Emacs Lisp
• Homepage: https://codeberg.org/bird-dancer/scame
• Size: 24.4 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: Readme.org

Awesome Lists containing this project

README

        
#+TITLE: extended

#+AUTHOR: Felix Dumbeck 

#+LICENSE: LGPLv3+

* philosophy

simple "performant" GNU Emacs 30 [[https://leanpub.com/lit-config/read][literate config]] that uses as much built in stuff as possible and builds upon that where necessary

unless you load external-packages.el only built in emacs functions will be used, leading to a very responsive but powerfull experience

#+begin_example

S imple       -  easy to use and read, it’s just setting varaibles and calling functions

C onfigurable -  everything can be overwritten

A greeable    -  settings that are up to taste (e.g. font, theme) are left for the user to configure

M odular      -  functionality is split up into different files, that can be loaded separatly from each other

E macs        -  you know what it is

#+end_example

* how to use

clone the package and put this in the beginning of your init.el

all configurations in [[file:Base.org][base]] do not include external packages and are only using GNU Emacs’ 30 built in functionality.

If you want to extend Emacs' functionality even further you can include the [[file:Extended.org][extended]] configurations.

if you want the maximum functionality with all available features:

#+begin_src emacs-lisp

  (load "~/scame/base.el" nil t)

  (load "~/scame/extended.el" nil t)

#+end_src

you can also just load individual modules. They are named the same as the first level headings in the respective file. See the directories =base= and =extended=.

#+begin_src emacs-lisp

  (load "~/scame/base/keybindings.el" nil t)

  (load "~/scame/extended/buffer-completion-system.el" nil t)

#+end_src

** example config

this is what my Emacs config looks like:

#+begin_src emacs-lisp

  (load "~/scame/base.el" nil t)

  (load "~/scame/extended.el" nil t)

  (set-frame-font "Comic Shanns Mono 14" nil t)

  (load-theme 'modus-operandi-tinted)

  (setq user-full-name "Felix Dumbeck"

        user-mail-address "[email protected]")

  (setq org-agenda-files

        '("~/uni/notes/uni.org"

          "~/uni/notes/personal.org"))

  (bind-key "C-z" #'yank)

#+end_src

* external dependencies

+ [[file:Base.org][base]]: only GNU Emacs 30.1+ is required.

+ =extended/spell-check=: libenchant

+ =extended/git=: git

+ =extended/more-packages=:

  + pdf-tools: on [[https://github.com/vedang/pdf-tools?tab=readme-ov-file#installing-the-epdfinfo-server][many distros]] these will be installed automatically when calling =M-x pdf-tools-install=

    make ,automake ,autoconf ,gcc ,libpng16-devel ,libpng16-compat-devel ,zlib-devel ,libpoppler-devel,libpoppler-glib-devel ,glib2-devel ,pkgconf