#+title: Installing Emacs on Ubuntu #+author: Howard X. Abrams #+email: howard.abrams@gmail.com #+date: 2022-09-02 September #+tags: emacs macos These instructions originally came from [[https://practical.li/blog/posts/build-emacs-from-source-on-ubuntu-linux/][this essay]]. To get the native compilation for Emacs working, first install all the pre-reqs, and we seem to need a lot of them: #+begin_src sh sudo apt update sudo apt upgrade # Instead of this: sudo apt install -y build-essential autoconf # We can not just call this: sudo apt build-dep -y emacs # We will build using the GTK and related libraries, # instead of good ol' X11: sudo apt install -y libc6-dev libgtk-3-dev xaw3dg-dev \ zlib1g-dev libice-dev libsm-dev libx11-dev libxext-dev # Nifty new stuff supported in Emacs needs libraries: sudo apt install -y libjansson4 libjansson-dev \ gnutls-bin libtree-sitter-dev # I am not sure if/why we need these guys, but ... sudo apt install -y libxi-dev libxmu-dev libxmuu-dev \ libxrandr-dev libxt-dev libxtst-dev libxv-dev \ libattr1-dev # And install all the image libraries (otherwise, we need # the venerable imagemagick library): sudo apt install -y libtiff5-dev libgif-dev \ libpng-dev libxpm-dev libncurses-dev libtiff-dev \ libwebkit2gtk-4.0-dev libjpeg-dev # Or do we want the specific: libjpeg62-dev #+end_src Oh, and if we are still building with [[https://imagemagick.org/][ImageMagick]], install that too: #+begin_src sh sudo apt-get install texinfo imagemagick #+end_src We need libgccjit that matches the GCC installed, e.g. =12=: #+begin_src sh GCC_VERSION=$(gcc --version | head -1 | cut -d' ' -f4 | cut -d. -f1) sudo apt install libgccjit-${GCC_VERSION}-dev #+end_src Clone the Emacs repo, and jump on the latest, /almost-released/ branch: #+begin_src sh mkdir -p ~/other ; cd ~/other git clone git://git.sv.gnu.org/emacs emacs cd emacs git checkout -b emacs29 #+end_src Then let’s build it: #+begin_src sh ./autogen.sh ./configure --with-native-compilation --with-cairo --with-json \ --with-xml2 --with-mailutils --with-tree-sitter --with-pgtk \ --with-gnutls=ifavailable --with-tiff=ifavailable \ --program-suffix=30 \ CFLAGS="-O3 -mtune=native -march=native -fomit-frame-pointer" make -j$(nproc) && sudo make install #+end_src * Supporting Packages Now install all the extras: #+begin_src sh brew install git-delta brew install libvterm brew install mu brew install isync brew install gpg #+end_src ** Mu4a See [[file:ha-email.org][ha-email]] for better instructions. #+begin_src sh mkdir -p ~/.mail/work ~/.mail/gmail mu init --maildir=~/.mail --my-address=howard.abrams@gmail.com --my-address=howard@howardabrams.com mu index mbsync -Va mu index #+end_src ** Mbsync config See [[file:ha-email.org][ha-email]] for better instructions. #+begin_src sh cat ~/.mbsyncrc #+end_src Basic configuration, that I actually supersede. #+begin_src conf # ========== Gmail ========== IMAPAccount gmail Host imap.gmail.com User username@gmail.com PassCmd "/opt/homebrew/bin/gpg --quiet --for-your-eyes-only --no-tty --decrypt ~/.password-store/mbsync/gmail.gpg" AuthMechs LOGIN SSLType IMAPS IMAPStore gmail-remote Account gmail MaildirStore gmail-local Subfolders Verbatim Path ~/.mail/gmail/ Inbox ~/.mail/gmail/Inbox Channel gmail Far :gmail-remote: Near :gmail-local: Patterns * ![Gmail]* "[Gmail]/Sent Mail" "[Gmail]/Starred" "[Gmail]/All Mail" Expunge None CopyArrivalDate yes Sync All Create Near SyncState * # ========== Gmail ========== #+end_src * Dæmon Processes On the Mac, =cron= has been removed and replaced with =LaunchAgent=. I find my [[file:ha-capturing-notes.org::*Push MacOS-Specific Content][ICanHazShortcut]] process pretty simple to start Emacs, so I’m not sure about this dæmon, but … ** Emacs dæmon via LaunchAgent Notice that =UserName= section should be your =$USER= value. #+begin_src xml :tangle ~/Library/LaunchAgents/gnu.emacs.plist KeepAlive Label gnu.emacs ProgramArguments /opt/homebrew/bin/emacs --fg-dæmon RunAtLoad StandardErrorPath /tmp/gnu-emacs-dæmon.log StandardOutPath /tmp/gnu-emacs-dæmon.log UserName howard #+end_src Verify that the plist file is correct. #+begin_src sh plutil -lint ~/Library/LaunchAgents/gnu.emacs.plist #+end_src Start, stop and list service. #+begin_src sh launchctl load -w /Users/USERNAME/Library/LaunchAgents/gnu.emacs.plist launchctl unload /Users/USERNAME/Library/LaunchAgents/gnu.emacs.plist launchctl list #+end_src ** Fetch mails periodically Let’s make another dæmon for fetching mail. Again, replace =UserName= with your user account name. #+begin_src xml :tangle ~/Library/LaunchAgents/periodic.mbsync.plist KeepAlive Label periodic.mbsync ProgramArguments /Users/USERNAME/.bin/mbsync-task StandardOutPath /tmp/mbsync-task.log StandardErrorPath /tmp/mbsync-task.log ThrottleInterval 180 RunAtLoad UserName howard #+end_src Verify that the plist file is correct. #+begin_src sh plutil -lint ~/Library/LaunchAgents/periodic.mbsync.plist #+end_src Start, stop and list service. #+begin_src sh launchctl load -w /Users/USERNAME/Library/LaunchAgents/periodic.mbsync.plist launchctl unload /Users/USERNAME/Library/LaunchAgents/periodic.mbsync.plist launchctl list #+end_src Script that fetches mails and updates the mail index. #+begin_src sh :tangle ~/.bin/mbsync-task :shebang #!/bin/bash echo "" echo "Running $(date +"%Y-%m-%d %H:%M")" /opt/homebrew/bin/mbsync -Va echo "Exit code:" echo $? /opt/homebrew/bin/emacsclient -e '(mu4e-update-index)' echo "Exit code:" echo $? #+end_src * Emacsclient Simple /Automator/ script that's wrapped into an application and placed in the =Applications= folder. Select *New Document*, then select *Application*. Open the *Library*, and drag the *Run Shell Script* to the /workflow/. In the box, add this: #+begin_src sh /usr/local/bin/emacsclient -nc --socket-name work $* #+end_src Change the *Pass Input* to =as arguments=. Select to *Save* as =Emacsclient= into the *Applications* folder. ** Utils Convert a plist XML file into a JSON file. Not sure why this is important to know… #+begin_src sh plutil -convert json -r ~/Library/LaunchAgents/gnu.emacs.plist #+end_src Which should look a bit like: #+begin_src js { "KeepAlive" : true, "Label" : "gnu.emacs", "ProgramArguments" : [ "\/opt\/homebrew\/bin\/emacs", "--fg-dæmon" ], "RunAtLoad" : true, "StandardErrorPath" : "\/tmp\/gnu-emacs-dæmon.log", "StandardOutPath" : "\/tmp\/gnu-emacs-dæmon.log", "UserName" : "USERNAME" } #+end_src Convert it back to XML #+begin_src sh plutil -convert xml1 ~/Library/LaunchAgents/gnu.emacs.plist #+end_src ** Resources #+begin_src sh man launchd man launchctl man launchd.plist man plutil man plist #+end_src #+DESCRIPTION: A literate programming file for installing a dæmon version of Emacs on MacOS. #+PROPERTY: header-args:sh :tangle no #+PROPERTY: header-args:emacs-lisp :tangle no #+PROPERTY: header-args :results none :eval no-export :comments no #+OPTIONS: num:nil toc:nil todo:nil tasks:nil tags:nil date:nil #+OPTIONS: skip:nil author:nil email:nil creator:nil timestamp:nil #+INFOJS_OPT: view:nil toc:nil ltoc:t mouse:underline buttons:0 path:http://orgmode.org/org-info.js