An emacs starterkit for scientists and engineers
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
examples updated the qualifer example Jul 13, 2016
ipython-inline-images update manual for async ipython May 23, 2017
issues add issues that I have worked on Nov 13, 2017
ob-ipython @ c632871 sync with upstream Jun 13, 2017
ob-ipython-upstream @ 7147455 vb Feb 27, 2018
obipy-resources add figure May 11, 2018
org-mime @ bc61d4d vb Mar 9, 2018
org-ref @ 87b97bf vb Aug 3, 2018
org-show add org-show-help Dec 31, 2016
ov-highlight @ 36c375c vb Jan 9, 2018
ox-clip @ 594c909 vb Mar 6, 2018
ox-cmu updated the qualifer example Jul 13, 2016
ox-ipynb @ 06611ba vb Aug 2, 2018
ox-manuscript fix the org-archive-and-zip functionality Feb 27, 2018
scimax-lob add scimax-lob library and templates May 17, 2018
scimax-md new build Mar 1, 2018
snippets make tlmgr only use locally installed packages. Jun 18, 2018
test add a placeholder test file Jun 2, 2017
user add user.example file Jul 28, 2016
.gitignore fix packages to have the right path for scimax-ob and rm a keybinding. Feb 11, 2018
.gitmodules remove techela submodule Aug 21, 2018 add cask to osx build. Jun 2, 2017
.travis.yml allow emacs 26.1 to fail Jun 3, 2018
Cask add cask and travis Jul 1, 2016
Makefile add nouser target Jun 19, 2017 add better description. Jun 3, 2018
appveyor.yml add update and init to make sure it is there to checkout Feb 17, 2018
bibtex-hotkeys.el add helm-bibtex hot key Mar 3, 2018
bootstrap.el Update bootstrap.el May 5, 2018
cm-mods.el fix symbol quoting. Feb 15, 2018
contacts.el Mostly checkdoc fixes Jun 3, 2018 new contacts help Dec 22, 2016
debug-windows.el This mostly undoes a series of things I tried today to fix the Window… Feb 13, 2018
dir Add a scimax info manual. Dec 31, 2017
emacs-keybinding-command-tooltip-mode.el add autoload Jun 13, 2016
help-fns+.el Address issue #156 Jan 26, 2018
init.el add back no-ssl instructions for windows. Feb 13, 2018 update minimal required emacs in linux script Apr 12, 2017 run cask install Jun 2, 2017 undo hunspell addition. Feb 16, 2018
kitchingroup.el add kitchingroup email Jan 9, 2018
ore.el add a minor note on general help. Mar 6, 2017
org-db.el add missing (require 's) to define s-trim Jul 7, 2018
org-editmarks.el Add latex escape function to fix issue #54 Apr 10, 2017
ox-rtf.el some additions to ox-rtf to use pygmentize instead of highlight Jun 22, 2016
ox-word.el add some notes, hopefully improve numbering of tables and figures. May 29, 2018
packages.el remove techela dependency Aug 21, 2018
pianobar.el initial commit of pianobar. Dec 31, 2016
scimax-autoformat-abbrev.el fix symbols in groups Feb 6, 2018
scimax-dashboard.el add dashboard require. Fixes issue #188. Mar 23, 2018
scimax-elfeed.el fix typo in scimax-elfeed and make it a proper library. Jan 10, 2018
scimax-email.el update for sending emails with bibtex entries. Mar 12, 2017
scimax-evil.el add evil mode Apr 9, 2018
scimax-functional-text.el modify macro help-echo. Mar 7, 2018
scimax-hydra.el add url saver to hydra Jun 5, 2018
scimax-inkscape.el fix name bug, and add export afterall. Mar 3, 2018 replace host Apr 11, 2018
scimax-ivy.el fix some issues in ivy-colors May 22, 2017
scimax-journal.el namespace change to scimax-journal Jan 10, 2018
scimax-latex.el initial commit of scimax-latex Jan 6, 2017
scimax-ldap.el put scimax-ldap in scimax Jun 10, 2016
scimax-link-thumbnails.el Add two files for inkscape and thumbnails on links Feb 20, 2018
scimax-lob.el add scimax-lob library and templates May 17, 2018
scimax-macros.el initial commit of macros Mar 22, 2017
scimax-md.el only change links to org files Mar 9, 2018
scimax-mode.el fix error reported in issue #187 Mar 23, 2018
scimax-notebook.el add some packages that the projectile hydra uses, new functions Jun 4, 2018
scimax-ob.el add src block header editing functions Mar 5, 2018
scimax-org-babel-ipython-upstream.el Resolve issue #199 Aug 3, 2018
scimax-org-babel-ipython.el fix for issue #152 Dec 19, 2017
scimax-org-babel-python.el Fix 3 for issue #112 Jul 25, 2017
scimax-org-eldoc.el add my org-eldoc module May 16, 2017
scimax-org.el fix for issue #217 Jul 10, 2018
scimax-statistics.el typo correction scimax-statistics.el Mar 20, 2018
scimax-twitter.el add message Mar 31, 2018
scimax-utils.el modify f-string to also allow expressions. May 29, 2018
scimax-yas.el fix typo and remove binding. May 14, 2018
scimax.el only load custom file if it exists. Mar 28, 2018 update note about info version. Jan 1, 2018 minor cleanup May 11, 2018
scimax.png This is significant change in ipython for scimax Feb 9, 2018
words.el Add a swiper function for words and improve hydra menu. Jan 1, 2018

scimax - Awesome editing for scientists and engineers

Scimax is an Emacs starterkit for scientists and engineers. It provides a comprehensive configuration of Emacs for scientific programming and publishing.

See the manual for more details.

Coverage Status


<2018-02-28 Wed> scimax 2.0

It is an update of scimax, and the main new features are:

  1. Major overhaul on ipython. See ./
  2. A dashboard feature: ./scimax-dashboard.el
  3. A new inkscape link: ./scimax-inkscape.el
  4. You can put images on links with images in the description: ./scimax-link-thumbnails.el
  5. Functional text: ./scimax-functional-text.el

And probably more.


Windows users

Install git ( Open a git bash terminal. Run this command.

bash -c "$(curl -fsSL"

There is an emacs 25.2 binary in this repository for Windows. You should be able to run the command to launch scimax now.

Mac users

Run the next command in your terminal in the location you want to install scimax. The command will make sure you have homebrew, git, and emacs installed, and then will clone scimax and tell you how to use it. It will take some time to install. You need to install your own Python and LaTeX. These days I am using Python3 from Continuum IO and MacTeX from

bash -c "$(curl -fsSL"

Alternative manual installation of scimax for Mac users

Alternatively, you can install homebrew yourself, install git from, build your emacs like this:

brew install emacs --with-gnutls --with-imagemagick --with-librsvg --with-x11 --use-git-head --HEAD --with-cocoa

Alternatively, lately I have been using emacs-plus which claims to be faster for magit and has all those options enabled by default.

brew install emacs-plus

This got me:


After that, I clone scimax like this:

git clone

and launch emacs with:

emacs -q -l scimax/init.el

Linux users

Run this command. It checks for a git and emacs, but does not install them. You will have to use your package manager for that. You also need to install your own LaTeX and Python (and other languages you might want).

bash -c "$(curl -fsSL"

Manual installation

You can use your own emacs if you have one (version 25 or more is recommended). You still have to install Python and LaTeX if you will be using those.

Clone the scimax repo where you want it.

git clone

and launch emacs with:

emacs -q -l path/to/scimax/init.el

Alternatively, add scimax to your load path in your init file and just require what you want.

(setq scimax-dir "path/to/scimax")
(add-to-list 'load-path "path/to/scimax")

It is not uncommon to have to restart emacs a few times while all the packages from MELPA are installed. Windows seems to be like that.