Dotfiles

• Introduction
  • Getting Started
  • Making Changes
  • Docker Container
• Operating System
  • Nixpkgs
  • Home Manager
  • Emacs Overlay
  • NixOS Hardware
  • Nix On Droid
• Development Shells
  • Go
  • Rust
  • Node
  • Java
  • gRPC
  • C/C++
  • Python
  • Docker
  • Heroku
• Host Configurations
  • Default
    • Configuration
    • Hardware
  • Acernitro
    • Configuration
    • Hardware
  • Raspberry
    • Configuration
    • Hardware
  • Homecloud
    • Configuration
    • Hardware
  • Android
• Module Definitions
  • X11
  • SSH
  • Hugo
  • Flakes
  • Cachix
  • Docker
  • NVIDIA
  • Firefox
  • Jellyfin
  • Moonlight
  • Teamviewer
  • Home Manager
    • Git
    • Gpg
    • Vim
    • GTK
• Emacs Configuration
  • Native Comp
  • Disable UI
  • Backup Files
  • Shell Commands
  • Nix Mode
  • Evil Mode
  • EXWM
  • General
  • Which Key
  • EWW
  • ERC
  • Dired
  • Icons
  • Emojis
  • EShell
  • VTerm
  • Magit
  • Fonts
  • Elfeed
  • Org Mode
  • Org Roam
  • Org Drill
  • Org Agenda
  • Org Pomodoro
  • Writegood Mode
  • Aspell
  • TexLive
  • Http
  • Hugo
  • Passwords
  • Docker
  • MU4E
  • Projectile
  • LSP Mode
  • CCLS
  • Company Mode
  • Go Mode
  • Rustic
  • Python Mode
  • Protobuf Mode
  • PlantUML
  • Swiper
  • Transparency
  • Desktop Environment
  • Doom Themes
  • Doom Modeline
• Footnotes

Immutable NixOS dotfiles.

Built for Life, Liberty, and the Open Road.

• 100% Immutable

• 100% Declarative

• 100% Reproducible

Introduction

This is my personal configuration(s) for GNU/Linux¹ systems. It enables a consistent experience and computing environment across all of my machines. This project is written with GNU/Emacs², leveraging its capabilities for Literate Programming³, a technique where programs are written in a natural language, such as English, interspersed with snippets of code to describe a software project.

This file is controlled by /etc/dotfiles/README.org

Getting Started

1. Download the latest version of NixOS https://nixos.org/download.html

2. Partition drives and mount the file system https://nixos.org/manual/nixos/stable/#sec-installation-partitioning

3. Clone the project to /mnt/etc/dotfiles git clone git@git.chrishayward.xyz:chris/dotfiles /mnt/etc/dotfiles

4. Load the default shell environment nix-shell /mnt/etc/dotfiles

5. Install the default system sudo nixos-install --flake /mnt/etc/dotfiles#nixos

6. Reboot and login, start a graphical system with startx

Making Changes

The nixos-rebuild command updates the system so that it corresponds to the configuration specified in the module. It builds the new system in /nix/store/, runs the activation scripts, and restarts and system services (if needed). The command has one required argument, which specifies the desired operation:

Command	Description
boot	Build the new configuration and make it the boot default, without activation
test	Build and activate the new configuration, without adding it to the boot menu
switch	Build and activate the new configuration, making it the new boot default
build	Build the new configuration, without activation, nor adding it to the boot menu
build-vm	Build a script that starts a virtual machine with the desired configuration

# Build and activate a new configuration.
sudo nixos-rebuild switch --flake $FLAKE#$HOSTNAME

Instead of building a new configuration, it's possible to rollback to a previous generation using the nixos-rebuild command, by supplying the --rollback argument.

# Rollback to the previous generation.
sudo nixos-rebuild switch --rollback

Docker Container

It's possible to use parts of this configuration using a Docker⁴ container. By default, sandboxing is turned off inside of the container, even though it's enabled in new installations. This can lead to differences between derivations built inside containers, versus those built without any containerization. This is especially true if a derivation relies on sandboxing to block sideloading of dependencies.

Install from the command line: docker pull ghcr.io/chayward1/dotfiles:main

# <<file-warning>>

# Derive from the official image.
FROM nixos/nix

# Setup the default environment.
WORKDIR /etc/dotfiles
COPY . .

# Load the default system shell.
RUN nix-shell /etc/dotfiles/shell.nix

Operating System

NixOS⁵ is a purely functional Linux distribution built on top of the Nix⁶ package manager. It uses a declarative configuration language to define entire computer systems, and allows reliable system upgrades and rollbacks. NixOS⁵ also has tool dedicated to DevOps and deployment tasks, and makes it trivial to share development environments.

# <<file-warning>>
{
  description = "<<description>>";

  inputs = {
    <<os-nixpkgs>> 
    <<os-home-manager>>
    <<os-emacs-overlay>>
    <<os-nixos-hardware>>
    <<os-nix-on-droid>>
  };

  outputs = inputs @ { self, nixpkgs, nixpkgs-unstable, ... }: {
    nixosConfigurations = {
      <<host-default>>
      <<host-acernitro>>
      <<host-raspberry>>
      <<host-homecloud>>
      <<host-android>>
    };
  };
}

Nixpkgs

Nixpkgs⁷ is a collection of over 60,000 software packages that can be installed with the Nix⁶ package manager. Two main branches are offered:

1. The current stable release

2. The Unstable branch following the latest development

nixpkgs.url = "nixpkgs/nixos-unstable";
nixpkgs-unstable.url = "nixpkgs/master";

Home Manager

Home Manager⁸ provides a basic system for managing user environments using the Nix⁶ package manager together with the Nix libraries found in Nixpkgs⁷. It allows declarative configuration of user specific (non-global) packages and files.

home-manager.url = "github:nix-community/home-manager";
home-manager.inputs.nixpkgs.follows = "nixpkgs";

Emacs Overlay

Adding the Emacs Overlay⁹ extends the GNU/Emacs² package set to contain the latest versions, and daily generations from popular package sources, including the needed dependencies to run GNU/Emacs² as a Window Manager.

emacs-overlay.url = "github:nix-community/emacs-overlay";

NixOS Hardware

NixOS Hardware¹⁰ is a collection of NixOS⁵ modules covering specific hardware quirks. Unlike the channel, this will update the git repository on a rebuild. However, it's easy to pin particular revisions for more stability.

nixos-hardware.url = "github:nixos/nixos-hardware";

Nix On Droid

Nix On Droid¹¹ is a deployment of the Nix⁶ Package Manager on Android, in a single-click installable package. It does not require root, user namespace support, or disabling SELinux, but relies on proot. It has no relation to the Termux distribution.

nix-on-droid.url = "github:t184256/nix-on-droid/master";
nix-on-droid.inputs.nixpkgs.follows = "nixpkgs";

Development Shells

The command nix-shell¹² will build the dependencies of the specified derivation, but not the derivation itself. It will then start an interactive shell in which all environment variables defined by the derivation path have been set to their corresponding values.

Import this shell with nix-shell /etc/dotfiles/shell.nix.

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;

let
  nixBin = writeShellScriptBin "nix" ''
    ${nixFlakes}/bin/nix --option experimental-features "nix-command flakes" "$@"
  '';

in mkShell {
  buildInputs = [
    git
  ];
  shellHook = ''
    export FLAKE="$(pwd)"
    export PATH="$FLAKE/bin:${nixBin}/bin:$PATH"
  '';
}

Go

Go¹³ is an open-source programming language that makes it easy to build simple, reliable, and efficient software. It's statically typed and compiled programming language. It's syntactically similar to C, but with memory safety, garbage collection, structural typing, and CSP-style concurrency.

Import this shell with nix-shell /etc/dotfiles/shells/go.nix

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;
mkShell {
  buildInputs = [
    go
    gopls

    # FIXME: Broken on nixpkgs/unstable.
    # protoc-gen-go
    # protoc-gen-go-grpc
  ];
  shellHook = ''
    export GO111MODULE=on
    export GOPATH=$XDG_DATA_HOME/go
    export PATH=$GOPATH/bin:$PATH
  '';
}

Rust

Rust¹⁴ is a multi-paradigm programming language designed for performance and safety, especially safe concurrency. It is syntactically similar to C++, but can garantee memory safety by using a borrow checker to validate references. Rust¹⁴ achieves memory safety without garbage collection, and reference counting is optional.

Import this shell with nix-shell /etc/dotfiles/shells/rust.nix.

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;
mkShell {
  buildInputs = [
    rustup
  ];
  shellHook = ''
    export RUSTUP_HOME="$XDG_DATA_HOME/rustup"
    export CARGO_HOME="$XDG_DATA_HOME/cargo"
    export PATH="$CARGO_HOME/bin:$PATH"
  '';
}

Node

Node.js¹⁵ is an open-source, cross-platform, back-end JavaScript runtime environment that runs on the V8 engine, and executes JavaScript code outside of a web browser. Node.js¹⁵ lets developers user JavaScript to write command line tools, and for server-side scripting to produce dynamic web page content.

Import this shell with nix-shell /etc/dotfiles/shells/node.nix.

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;
mkShell {
  buildInputs = [
    nodejs
    yarn
  ];
  shellHook = ''
    export NPM_CONFIG_TMP="$XDG_RUNTIME_DIR/npm"
    export NPM_CONFIG_CACHE="$XDG_CACHE_HOME/npm"
    export NPM_CACHE_PREFIX="$XDG_CACHE_HOME/npm"
    export PATH="$(yarn global bin):$PATH"
  '';
}

Java

OpenJDK¹⁶ is a free and open-source implementation of the Java Platform, Standard Edition. It is the result of an effort Sun Microsystems began in 2006. The implementation is licensed under the GNU General Public License Version 2 with a linking exception.

Import this shell with nix-shell /etc/dotfiles/shells/java.nix.

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;
mkShell {
  buildInputs = [
    # openjdk8  # Legacy Java 8 VM.
    # openjdk11 # Current LTS version of OpenJDK.
    openjdk14   # Current version of OpenJDK.
  ];
  shellHook = ''
  '';
}

gRPC

gRPC¹⁷ is a modern open-source, high-performance Remote Procedure Call (RPC) framework that can run in any environment. It can efficiently connect services in and across data centres with pluggable support for load balancing, tracing, health checking, and authentication.

Import this shell with nix-shell /etc/dotfiles/shells/grpc.nix.

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;
mkShell {
  buildInputs = [
    grpc
    grpcui
    grpcurl

    # FIXME: Broken on nixpkgs/unstable.
    # grpc-tools
  ];
  shellHook = ''
  '';
}

C/C++

C¹⁸ is a general-purpose, procedural computer programming language support structured programming, lexical variable scope, and recursion. It has a static type system, and by design provides constructs that map efficiently to typical machine instructions. C++¹⁹ is a general-purpose programming language created as an extension of the C¹⁸ programming language.

Import this shell with nix-shell /etc/dotfiles/shells/cc.nix.

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;
mkShell {
  buildInputs = [
    gdb
    ccls
    cmake
    gnumake
    gcc-unwrapped
  ];
  shellHook = ''
  '';
}

Python

Python²⁰ is an interpreted high-level, general-purpose programming language. Its design philosophy emphasizes code readability, with its notable use of significant indentation. Its language constructs, as well as its object-oriented approach aim to help programmers write clear, logical, code for small and large projects.

Import this shell with nix-shell /etc/dotfiles/shells/python.nix

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;
mkShell {
  buildInputs = [
    python38Packages.pip
    python38Packages.pip-tools
    python38Packages.pyls-mypy
    python38Packages.pyls-isort
    python38Packages.pyls-black
  ];
  shellHook = ''
  '';
}

Docker

Compose²¹ is a tool for defining and running multi-container Docker⁴ applications. With Compose²¹, you use a YAML file to configure your application services. Then, with a single command, you create and start all of the services from your configuration.

Machine²² is a tool that lets you install Docker Engine on virtual hosts, and manage the hosts with docker-machine commands. You can use Machine²² to create hosts on your local box, company network, data center, or on any cloud provider.

Import this shell with nix-shell /etc/dotfiles/shells/docker.nix

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;
mkShell {
  buildInputs = [
    docker-compose
    docker-machine
  ];
  shellHook = ''
  '';
}

Heroku

Heroku²³ is a cloud platform as a service supporting several programming languages. One of the first cloud platforms, Heroku²³ has been in development since June 2007, when it supported only the Ruby programming language. It now supports Java, Node.js, Scala, Clojure, Python, PHP, and Go.

Import this shell with nix-shell /etc/dotfiles/shells/heroku.nix

# <<file-warning>>
{ pkgs ? import <nixpkgs> { } }:

with pkgs;
mkShell {
  buildInputs = [
    heroku
  ];
  shellHook = ''
  '';
}

Host Configurations

NixOS⁵ typically stores the current machine configuration in /etc/nixos/configuration.nix. In this project, this file is stored in /etc/dotfiles/hosts/$HOSTNAME/..., and imported, along with the generated hardware configurations. This ensures that multiple host machines can share the same modules, and generating new host definitions is trivial. It also makes it easier to share common configurations amongst all of the hosts, such as with pre-configured wireless networking:

networking.wireless.networks = {
  MyWiFi_5C1870 = {
    priority = 3;
    pskRaw = "409b3c85fef1c5737f284d2f82f20dc6023e41804e862d4fa26265ef8193b326";
  };
  BELL182 = {
    priority = 2;
    pskRaw = "8b3c114c695c5013bbcf5fc0af781c7872f95c34e2cceb31afa7bfc1adf66245";
  };
  SM-G975W3034 = {
    priority = 1;
    pskRaw = "74835d96a98ca2c56ffe4eaf92223f8a555168b59ec2bb22b1e46b2a333adc80";
  };
};

It's helpful to add the machine hostnames to the networking configuration, so I can refer to another host across the network by name. Some devices that can have more than one IP (WIFI / Ethernet) will have the wireless hostname suffixed:

networking.hosts = {
  "192.168.3.105" = [ "gamingpc" ];
  "192.168.3.163" = [ "acernitro" ];
  "192.168.3.182" = [ "raspberry" ];
  "192.168.3.183" = [ "homecloud" ];
};

Setting up new machines, especially headless ones like the Raspberry Pi Zero, can be difficult with NixOS. I find it easier to setup automatic network configuration, and wait for the machine to appear on the network. This is complimented with a pre-authorized SSH key, making it simple to connect and complete the installation headlessly.

users.users.chris.openssh.authorizedKeys.keys = [
  "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIO4wka/LfG3pto15DIm9LIRbb6rWr7/ipCRiCdAKSlY4 chris@chrishayward.xyz"
];

Default

The default host, built using QEMU²⁴, a free and open-source emulator that can perform hardware virtualization. It features a lightweight system optimized for development, running GNU/Emacs² + EXWM²⁵ as the graphical environment.

nixos = nixpkgs.lib.nixosSystem {
  system = "x86_64-linux";
  specialArgs = { inherit inputs; };
  modules = [
    ./hosts/nixos
    <<module-x11>>
    <<module-ssh>>
    <<module-flakes>>
    <<module-cachix>>
    <<module-home-manager>>
  ];
};

Deploy this configuration with nixos-rebuild switch --flake /etc/dotfiles/#nixos.

# <<file-warning>>
{ ... }:

{
  imports = [
    ./configuration.nix
    ./hardware.nix
  ];
}

Configuration

This is a basic default configuration that specified the indended default configuration of the system. Because NixOS⁵ has a declarative configuration model, you can create or edit a description of the desired configuration, and update it from one file.

# <<file-warning>>
{ config, pkgs, inputs, ... }:

{
  time.timeZone = "America/Toronto";

  networking.hostName = "nixos";
  networking.useDHCP = false;
  networking.firewall.enable = false;
  networking.interfaces.ens3.useDHCP = true;

  <<host-config-home>>
  <<host-config-ssh>>

  programs.mtr.enable = true;
  programs.fish.enable = true;
  programs.gnupg.agent.enable = true;

  users.users.chris = {
    shell = pkgs.fish;
    isNormalUser = true;
    extraGroups = [ "wheel" ];
  };
}

Hardware

The file system for this host is a single 24GB QCOW file, a format for disk images used by QEMU²⁴. The file can be recreated easily by following the steps listed in the NixOS⁵ installation manual, specifically the section on disk formatting.

# <<file-warning>>
{ config, lib, pkgs, modulesPath, ... }:

{
  imports =
    [ (modulesPath + "/profiles/qemu-guest.nix")
    ];

  boot.initrd.availableKernelModules = [ "ata_piix" "floppy" "sd_mod" "sr_mod" ];
  boot.initrd.kernelModules = [ ];
  boot.kernelModules = [ ];
  boot.extraModulePackages = [ ];

  boot.loader.grub.enable = true;
  boot.loader.grub.version = 2;
  boot.loader.grub.device = "/dev/sda";

  fileSystems."/" =
    { device = "/dev/disk/by-uuid/fddc37ff-a442-41fa-afc4-abf878be7c5a";
      fsType = "ext4";
    };

  swapDevices =
    [ { device = "/dev/disk/by-uuid/5fc0e3df-e796-4fe2-8482-c6acaed9d36f"; }
    ];
}

Acernitro

My gaming laptop, the model is an Acer Nitro AN-515-53²⁶. The Nitro 5 has more in common with the mid-range notebooks rather than the gaming models due to its cooling design, chassis, and overall construction.

Here are the specs:

Slot	Component
CPU	Intel Core i5-8300H
GPU	NVIDIA GeForce GTX 1050Ti (4GB GDDR5)
RAM	16GB DDR4
Display	15.6" Full HD (1920 x 1080), IPS
Storage	1000GB HDD
Weight	2.48kg (5.5 lbs)

acernitro = nixpkgs.lib.nixosSystem {
  system = "x86_64-linux";
  specialArgs = { inherit inputs; };
  modules = [
    ./hosts/acernitro
    <<module-x11>>
    <<module-ssh>>
    <<module-hugo>>
    <<module-docker>>
    <<module-flakes>>
    <<module-cachix>>
    <<module-nvidia>>
    <<module-firefox>>
    <<module-moonlight>>
    <<module-teamviewer>>
    <<module-home-manager>>
  ];
};

Deploy this configuration with nixos-rebuild switch --flake /etc/dotfiles/#acernitro.

# <<file-warning>>
{ ... }:

{
  imports = [
    ./configuration.nix
    ./hardware.nix
  ];
}

Configuration

This configuration is nearly identical to the default, except for a few key differences:

• Enables sound

• Applies the desired hostname

• Enables power management daemon

• It adds support for UEFI systems

• Enables support for wireless networking

# <<file-warning>>
{ config, pkgs, inputs, ... }:

{
  time.timeZone = "America/Toronto";

  networking.hostName = "acernitro";
  networking.firewall.enable = false;
  networking.wireless.enable = true;
  networking.wireless.userControlled.enable = true;
  networking.useDHCP = false;
  networking.interfaces.enp6s0f1.useDHCP = true;
  networking.interfaces.wlp0s20f3.useDHCP = true;

  <<host-config-wifi>>
  <<host-config-home>>
  <<host-config-ssh>>

  services.tlp.enable = true;
  services.xserver.dpi = 96;
  services.xserver.libinput.touchpad.tapping = false;
  services.printing.enable = true;

  programs.mtr.enable = true;
  programs.fish.enable = true;
  programs.gnupg.agent.enable = true;

  users.users.chris = {
    shell = pkgs.fish;
    isNormalUser = true;
    extraGroups = [ "wheel" ];
  };
}

Hardware

• Enables sound via PulseAudio

• Enables powertop via power management

• Adds support for the NVIDIA Hybrid GPU

# <<file-warning>>
{ config, lib, pkgs, modulesPath, ... }:

{
  imports =
    [ (modulesPath + "/installer/scan/not-detected.nix")
    ];

  boot.initrd.availableKernelModules = [ "xhci_pci" "ahci" "usb_storage" "sd_mod" "rtsx_pci_sdmmc" ];
  boot.initrd.kernelModules = [ ];
  boot.kernelModules = [ "kvm-intel" ];
  boot.extraModulePackages = [ ];

  boot.loader.systemd-boot.enable = true;
  boot.loader.efi.canTouchEfiVariables = true;

  sound.enable = true;
  hardware.pulseaudio.enable = true;
  hardware.pulseaudio.support32Bit = true;

  fileSystems."/" =
    { device = "/dev/disk/by-uuid/2f548eb9-47ce-4280-950f-9c6d1d162852";
      fsType = "ext4"; 
    };

  fileSystems."/boot" =
    { device = "/dev/disk/by-uuid/5BC3-73F3";
      fsType = "vfat";
    };

  swapDevices =
    [ { device = "/dev/disk/by-uuid/bef7bf62-d26f-45b1-a1f8-1227c2f8b26a"; }
    ];

  powerManagement.powertop.enable = true;
  powerManagement.cpuFreqGovernor = lib.mkDefault "powersave";
}

Raspberry

The Raspberry Pi 400²⁷ is your complete personal computer, built into a compact keyboard. It features a quad-core, 64-bit processor, 4GB of RAM, wireless networking, dual-display output, 4k video playback, as well as a 40-pin GPIO header. It's the most powerful Raspberry Pi computer yet.

raspberry = nixpkgs.lib.nixosSystem {
  system = "aarch64-linux";
  specialArgs = { inherit inputs; };
  modules = [
    ./hosts/raspberry
    <<module-x11>>
    <<module-ssh>>
    <<module-flakes>>
    <<module-cachix>>
    <<module-home-manager>>
  ];
};

Deploy this configuration with sudo nixos-rebuild switch --flake /etc/dotfiles/#raspberry.

# <<file-warning>>
{ ... }:

{
  imports = [
    ./configuration.nix
    ./hardware.nix
  ];
}

Configuration

# <<file-warning>>
{ config, pkgs, ... }:

{
  time.timeZone = "America/Toronto";

  networking.hostName = "raspberry";
  networking.firewall.enable = false;
  networking.networkmanager.enable = true;
  networking.interfaces.eth0.useDHCP = true;
  networking.interfaces.wlan0.useDHCP = true;

  <<host-config-home>>
  <<host-config-ssh>>

  environment.systemPackages = [
    pkgs.libraspberrypi
    pkgs.raspberrypi-eeprom
  ];

  programs.fish.enable = true;
  programs.gnupg.agent.enable = true;

  users.users.chris = {
    shell = pkgs.fish;
    isNormalUser = true;
    extraGroups = [ "wheel" "networkmanager" ];
  };
}

Hardware

This section is very much a work in progress. I have struggled to get this device to boot according to the NixOS documentation / wiki on the subject. It seems that when running with the vendored kernel there's an issue booting from the SD card. Nevertheless, the issue is avoided by using the standard kernel.

# <<file-warning>>
{ config, pkgs, lib, inputs, ... }:

{
  # imports = [
  #   inputs.nixos-hardware.nixosModules.raspberry-pi-4
  # ];

  # boot.kernelPackages = pkgs.linuxPackages_rpi4;
  boot.tmpOnTmpfs = true;
  boot.initrd.availableKernelModules = [ "usbhid" "usb_storage" ];
  boot.kernelParams = [
    "8250.nr_uarts=1"
    "console=ttyAMA0,115200"
    "console=tty1"
    "cma=128M"
  ];

  boot.loader.grub.enable = false;
  boot.loader.generic-extlinux-compatible.enable = true;
  boot.loader.raspberryPi = {
    enable = true;
    version = 4;
    firmwareConfig = ''
      hdmi_drive=2
      hdmi_force_hotplug=1
      dtparam=sd_poll_once=on
      dtparam=audio=on
    '';
  };

  # FIXME: Requires GPU support.
  services.xserver.videoDrivers = [ "fbdev" ];

  sound.enable = true;
  hardware.pulseaudio.enable = true;
  hardware.enableRedistributableFirmware = true;
  # hardware.raspberry-pi."4".fkms-3d.enable = true;

  fileSystems = {
    "/" = {
      device = "/dev/disk/by-uuid/44444444-4444-4444-8888-888888888888";
      fsType = "ext4";
      options = [ "noatime" ];
    };
  };

  powerManagement.cpuFreqGovernor = "ondemand";
}

Homecloud

The Raspberry Pi Model B-8GB²⁸ is the latest product in the popular Raspberry Pi range of computers. It offers groundbreaking increases in processor speed, multimedia performance, memory, and connectivity compared to the prior generation. On NixOS⁵, the Raspberry Pi family is only supported on the AArch64 platform, although there is community support for armv6l and armv7l.

homecloud = nixpkgs.lib.nixosSystem {
  system = "aarch64-linux";
  specialArgs = { inherit inputs; };
  modules = [
    ./hosts/homecloud
    <<module-ssh>>
    <<module-flakes>>
    <<module-cachix>>
  ];
};

Deploy this configuration with sudo nixos-rebuild switch --flake /etc/dotfiles/#homecloud.

# <<file-warning>
{ ... }:

{
  imports = [
    ./configuration.nix
    ./hardware.nix
  ];
}

Configuration

# <<file-warning>>
{ config, pkgs, ... }:

{
  time.timeZone = "America/Toronto";

  networking.hostName = "homecloud";
  networking.firewall.enable = false;
  networking.networkmanager.enable = true;
  networking.interfaces.eth0.useDHCP = true;
  networking.interfaces.wlan0.useDHCP = true;

  <<host-config-wifi>>
  <<host-config-home>>
  <<host-config-ssh>>

  environment.systemPackages = [
    pkgs.libraspberrypi
    pkgs.raspberrypi-eeprom
  ];

  programs.fish.enable = true;
  programs.mtr.enable = true;

  users.users.chris = {
    shell = pkgs.fish;
    isNormalUser = true;
    extraGroups = [ "wheel" "networkmanager" ];
  };
}

Hardware

# <<file-warning>>
{ config, pkgs, lib, inputs, ... }:

{
  # imports = [
  #   inputs.nixos-hardware.nixosModules.raspberry-pi-4
  # ];

  # boot.kernelPackages = pkgs.linuxPackages_rpi4;
  boot.tmpOnTmpfs = true;
  boot.initrd.availableKernelModules = [ "usbhid" "usb_storage" ];
  boot.kernelParams = [
    "8250.nr_uarts=1"
    "console=ttyAMA0,115200"
    "console=tty1"
    "cma=128M"
  ];

  boot.loader.grub.enable = false;
  boot.loader.generic-extlinux-compatible.enable = true;
  boot.loader.raspberryPi = {
    enable = true;
    version = 4;
    firmwareConfig = ''
      hdmi_drive=2
      hdmi_force_hotplug=1
      dtparam=sd_poll_once=on
      dtparam=audio=on
    '';
  };

  # hardware.raspberry-pi."4".fkms-3d.enable = true;

  fileSystems = {
    "/" = {
      device = "/dev/disk/by-uuid/44444444-4444-4444-8888-888888888888";
      fsType = "ext4";
      options = [ "noatime" ];
    };
  };

  powerManagement.cpuFreqGovernor = "ondemand";
}

Android

This is my Samsung Galaxy S10+²⁹ running Nix On Droid¹¹ with the experimental support for Flakes being used to manage the configuration.

android = (inputs.nix-on-droid.lib.aarch64-linux.nix-on-droid {
  config = ./hosts/android/nix-on-droid.nix;
}).activationPackage;

Build the activation package with nix build .#android --impure, and activate it with result/activate.

# <<file-warning>>
{ pkgs, ... }:

{
  environment.packages = [
    pkgs.git
    pkgs.vim
    pkgs.pass
    pkgs.gnupg
    pkgs.openssh
  ];
}

Module Definitions

Modules are files combined by NixOS⁵ to produce the full system configuration. Modules wre introduced to allow extending NixOS⁵ without modifying its source code. They also allow splitting up configuration.nix, making the system configuration easier to maintain and use.

X11

./modules/x11.nix

X11, or X³⁰ is the generic name for the X Window System Display Server. All graphical GNU/Linux¹ applications connect to an X-Window³⁰ (or Wayland³¹) to display graphical data on the monitor of a computer. Its a program that acts as the interface between graphical applications and the graphics subsystem of the computer.

# <<file-warning>>
{ config, pkgs, ... }:

{
  services.xserver.enable = true;
  services.xserver.layout = "us";
  services.xserver.libinput.enable = true;
  services.xserver.displayManager.startx.enable = true;

  environment = {
    variables = {
      XDG_DESKTOP_DIR = "$HOME/";
      XDG_CACHE_HOME = "$HOME/.cache";
      XDG_CONFIG_HOME = "$HOME/.config";
      XDG_DATA_HOME = "$HOME/.local/share";
      XDG_BIN_HOME = "$HOME/.local/bin";
    };
    systemPackages = with pkgs; [
      pkgs.sqlite
      pkgs.pfetch
      pkgs.cmatrix
      pkgs.asciiquarium
    ];
    extraInit = ''
      export XAUTHORITY=/tmp/Xauthority
      export xserverauthfile=/tmp/xserverauth
      [ -e ~/.Xauthority ] && mv -f ~/.Xauthority "$XAUTHORITY"
      [ -e ~/.serverauth.* ] && mv -f ~/.serverauth.* "$xserverauthfile"
    '';
  };

  services.picom.enable = true;
  services.printing.enable = true;

  fonts.fonts = with pkgs; [
    iosevka-bin
    emacs-all-the-icons-fonts
  ];
}

SSH

./modules/ssh.nix

OpenSSH³² is a suite of secure networking utilities based on the Secure Shell Protocol, which provides a secure channel over an unsecured network in a client-server architecture. OpenSSH³² started as a fork of the free SSH program; later versions were proprietary software.

Apply some configuration to the default settings:

• Disable logging in as root

• Disable password authentication

# <<file-warning>>
{ config, pkgs, ... }:

{
  services.openssh = {
    enable = true;
    permitRootLogin = "no";
    passwordAuthentication = false;
  };
}

Hugo

./modules/hugo.nix

Hugo³³ is one of the most popular open-source static site generators.

# <<file-warning>>
{ config, pkgs, ... }:

let
  myUpdateSite = pkgs.writeShellScriptBin "update-site" ''
    rsync -aP /etc/dotfiles/docs/public/ ubuntu@chrishayward.xyz:/var/www/chrishayward
  '';

in {
  environment.systemPackages = [
    pkgs.hugo
    myUpdateSite
  ];
}

Flakes

./modules/flakes.nix

Nix Flakes³⁴ are an upcoming feature of the Nix package manager⁶. They allow you to specify your codes dependencies in a declarative way, simply by listing them inside of a flake.nix file. Each dependency is then pinned to a specific git-hash. Flakes³⁴ replace the nix-channels command and things like builtins.fetchGit, keeping dependencies at the top of the tree, and channels always in sync. Currently, Flakes³⁴ are not available unless explicitly enabled.

# <<file-warning>>
{ config, pkgs, inputs, ... }:

{
  nix = {
    package = pkgs.nixUnstable;
    extraOptions = ''
      experimental-features = nix-command flakes
    '';
  };

  nixpkgs = {
    config = { allowUnfree = true; };
    overlays = [ inputs.emacs-overlay.overlay ];
  };
}

Cachix

./modules/cachix.nix

Cachix³⁵ is a Command line client for Nix⁶ binary cache hosting. This allows downloading and usage of pre-compiled binaries for applications on nearly every available system architecture. This speeds up the time it takes to rebuild configurations.

# <<file-warning>>
{ config, ... }:

{
  nix = {
    binaryCaches = [
      "https://nix-community.cachix.org"
    ];
    binaryCachePublicKeys = [
      "nix-community.cachix.org-1:mB9FSh9qf2dCimDSUo8Zy7bkq5CX+/rkCWyvRCYg3Fs="
    ];
  };
}

Docker

./modules/docker.nix

Docker ⁴ is a set of platform as a service that uses OS level virtualization to deliver software in packages called containers. Containers are isolated from one another and bundle their own software, libraries, and configuration files; they can communicate with each other through well-defined channels.

{ config, pkgs, ... }:

{
  # Enable the docker virutalization platform.
  virtualisation.docker = {
    enable = true;
    enableOnBoot = true;
    autoPrune.enable = true;
  };

  # Required for the `docker' command.
  users.users.chris.extraGroups = [ "docker" ];
}

NVIDIA

./modules/nvidia.nix

Use the lspci command to determine the type of graphics card you have, following the guide on NVIDIA at the NixOS Wiki³⁶.

• MXM / output-providing card (shows as VGA Controller in lspci), i.e. graphics card in desktop computer or in some laptops

• muxless/non-MXM Optimus cards have no display outputs and show as 3D Controller in lspci output, seen in most modern consumer laptops

MXM cards allow you to use the Nvidia card standalone, in Non-Optimus mode. Non-MXM cards require Optimus, Nvidia's integrated-vs-discrete GPU switching technology.

Your output should look something like this:

...

00:02.0 VGA compatible controller: Intel Corporation UHD Graphics 630 (Mobile)
        Subsystem: Acer Incorporated [ALI] Device 1264
        Kernel driver in use: i915
        Kernel modules: i915
...
        
01:00.0 VGA compatible controller: NVIDIA Corporation GP107M [GeForce GTX 1050 Mobile] (rev a1)
        Subsystem: Acer Incorporated [ALI] Device 1265
        Kernel driver in use: nouveau
        Kernel modules: nvidiafb, nouveau
01:00.1 Audio device: NVIDIA Corporation GP107GL High Definition Audio Controller (rev a1)
        Kernel driver in use: snd_hda_intel
        Kernel modules: snd_hda_intel
...

This reveals the information needed, which is the information about the two display cards in the laptop:

Intel UHD

This is the dedicated graphics on the CPU

NVIDIA GP107M

This is the mobile version of the GTX 1050ti

{ config, pkgs, ... }:

let
  myIntelBusId = "PCI:0:2:0";
  myNvidiaBusId = "PCI:1:0:0";
  myNvidiaOffload = pkgs.writeShellScriptBin "nvidia-offload" ''
    export __NV_PRIME_RENDER_OFFLOAD=1
    export __NV_PRIME_RENDER_OFFLOAD_PROVIDER=NVIDIA-G0
    export __GLX_VENDOR_LIBRARY_NAME=nvidia
    export __VK_LAYER_NV_optimus=NVIDIA_only
    exec -a "$0" "$@"
  '';

in {
  # Add the offload script to the $PATH.
  environment.systemPackages = [ myNvidiaOffload ];

  # Configure XDG compliance.
  environment.variables = {
    __GL_SHADER_DISK_CACHE_PATH = "$XDG_CACHE_HOME/nv";
    CUDA_CACHE_PATH = "$XDG_CACHE_HOME/nv";
  };

  # Enable the NVIDIA drivers.
  services.xserver.videoDrivers = [ "nvidia" ];

  # Fix screen tearing.
  services.xserver.screenSection = ''
    Option "metamodes" "nvidia-auto-select +0+0 {ForceFullCompositionPipeline=On}"
    Option "AllowIndirectGLXProtocol" "off"
    Option "TripleBuffer" "on"
  '';

  # Configure `offload-mode'.
  hardware.nvidia.prime = {
    offload.enable = true;
    intelBusId = myIntelBusId;
    nvidiaBusId = myNvidiaBusId;
  };

  # Add OpenGL support.
  hardware.opengl = {
    enable = true;
    driSupport32Bit = true;
    extraPackages32 = with pkgs; [
      pkgsi686Linux.libva
    ];
  };

  # Add user to video group.
  users.users.chris = {
    extraGroups = [ "video" ];
  };
}

Firefox

./modules/firefox.nix

Firefox Browser³⁷, also known as Mozilla Firefox or simply Firefox, is a free and open-source web browser developed by the Mozilla Foundation and its subsidiary, the Mozilla Corporation. Firefox uses the Gecko layout engine to render web pages, which implements current and anticipated web standards. In 2017, Firefox began incorporating new technology under the code name Quantum to promote parallelism and a more intuitive user interface.

# <<file-warning>>
{ pkgs, ... }:

{
  # NOTE: Use the binary until module is developed.
  environment.systemPackages = [
    pkgs.firefox-bin 
  ];
}

Jellyfin

./modules/jellyfin.nix

Jellyfin³⁸ is a suite of multimedia applications designed to organize, manage, and share digital media files to networked devices. It consists of a server application installed on a machine, and another application running as a client on devices such as Smartphones, Tablets, SmartTVs, Streaming Media Players, Game Consoles, or in a Web Browser. It can also serve media to DLNA and Chromecast enabled devices. It's free and open-source software fork of Emby.

# <<file-warning>>
{ config, pkgs, ... }:

{
  services.jellyfin = {
    enable = true;
  };
}

Moonlight

./modules/moonlight.nix

Moonlight³⁹ is an open-source implementation of NVIDIA's GameStream Protocol. You can stream your collection of PC games from your GameStream-compatible PC to any supported device and play them remotely. Moonlight³⁹ is perfect for gaming on the go (or on GNU/Linux¹) without sacrificing the graphics and game selection available for the PC.

# <<file-warning>>
{ pkgs, ... }:

{
  environment.systemPackages = [
    pkgs.moonlight-qt
  ];
}

Teamviewer

./modules/teamviewer.nix

The Teamviewer⁴⁰ remote connectivity cloud platform enables secure remote access to any device, across platforms, from anywhere, anytime. Teamviewer⁴⁰ connects computers, smartphones, servers, IoT devices, robots – anything – with fast, high performance connections through their global access network. It has been used in outer-space low-bandwidth environments.

# <<file-warning>>
{ pkgs, ... }:

{
  # NOTE: Neither of these are working!
  # services.teamviewer.enable = true;

  # environment.systemPackages = [
  #   pkgs.teamviewer
  # ];
}

Home Manager

Home Manager⁸ includes a flake.nix file for compatibility with Nix Flakes, a feature utilized heavily in this project. When using flakes, switching to a new configuration is done only for the entire system, using the command nixos-rebuild switch --flake <path>, instead of nixos-rebuild, and home-manager seperately.

inputs.home-manager.nixosModules.home-manager {
  home-manager.useGlobalPkgs = true;
  home-manager.useUserPackages = true;
  home-manager.users.chris = {
    imports = [
      <<module-git>>
      <<module-gpg>>
      <<module-vim>>
      <<module-gtk>>
      <<module-emacs>>
    ];
  };
}

Git

./modules/git.nix

Git⁴¹ is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency. Git is easy to learn, has a tiny footprint, and lighting fast performance. It outclasses every other version control tool such as: SCM, Subversion, CVS, ClearCase, with features like cheap local branching, convinient staging areas, and multiple workflows.

# <<file-warning>>
{ pkgs, ... }:

let
  # Fix any corruptions in the local copy.
  myGitFix = pkgs.writeShellScriptBin "git-fix" ''
    if [ -d .git/objects/ ]; then
      find .git/objects/ -type f -empty | xargs rm -f
      git fetch -p
      git fsck --full
    fi
    exit 1
  '';

in {
  home.packages = [ myGitFix ];

  programs.git = {
    enable = true;
    userName = "Christopher James Hayward";
    userEmail = "chris@chrishayward.xyz";

    signing = {
      key = "37AB1CB72B741E478CA026D43025DCBD46F81C0F";
      signByDefault = true;
    };
  };
}

Gpg

./modules/gpg.nix

GNU Privacy Guard⁴² is a free-software replacement for Symantec's PGP cryptographic software suite. It is compliant with RFC 4880, the IETF standards-track specification of OpenPGP. Modern versions of PGP are interoperable with GnuPG and other OpenPGP-compliant systems.

# <<file-warning>>
{ pkgs, ... }:

{
  services.gpg-agent = {
    enable = true;
    defaultCacheTtl = 1800;
    enableSshSupport = true;
    pinentryFlavor = "gtk2";
  };
}

Vim

./modules/vim.nix

Neovim⁴³ is a project that seeks to aggressively refactor Vim in order to:

• Simplify maintenance and encourage contributions

• Split the work between multiple developers

• Enable advanced UIs without core modification

• Maximize extensibility

# <<file-warning>>
{ pkgs, ... }:

{
  programs.neovim = {
    enable = true;
    viAlias = true;
    vimAlias = true;
    vimdiffAlias = true;
    extraConfig = ''
      set number relativenumber
      set nobackup
    '';
    extraPackages = [
      pkgs.nixfmt
    ];
    plugins = with pkgs.vimPlugins; [
      vim-nix
      vim-airline
      vim-polyglot
    ];
  };
}

GTK

./modules/gtk.nix

GTK⁴⁴ is a free and open-source, cross-platform widget toolkit for graphical user interfaces. It's one of the most popular toolkits for the Wayland³¹ and X11³⁰ windowing systems.

# <<file-warning>>
{ pkgs, ... }:

{
  home.packages = [
    pkgs.nordic
    pkgs.arc-icon-theme
    pkgs.lxappearance
  ];

  home.file.".gtkrc-2.0" = {
    text = ''
      # gtk-theme-name="Nordic-Polar"
      gtk-theme-name="Nordic-darker"
      gtk-icon-theme-name="Arc"
      gtk-font-name="Sans 10"
      gtk-cursor-theme-size=0
      gtk-toolbar-style=GTK_TOOLBAR_BOTH_HORIZ
      gtk-toolbar-icon-size=GTK_ICON_SIZE_LARGE_TOOLBAR
      gtk-button-images=0
      gtk-menu-images=0
      gtk-enable-event-sounds=1
      gtk-enable-input-feedback-sounds=1
      gtk-xft-antialias=1
      gtk-xft-hinting=1
      gtk-xft-hintstyle="hintmedium"
    '';
  };
}

Emacs Configuration

./modules/emacs.nix

GNU/Emacs² is an extensible, customizable, free/libre text editor – and more. At its core is an interpreter for Emacs Lisp⁴², a dialect of the Lisp programming language with extensions to support text editing. Other features include:

• Highly customizable

• Full Unicopde support

• Content-aware editing modes

• Complete built-in documentation

• Wide range of functionality beyond text editing

# <<file-warning>>
{ pkgs, ... }:

let
  myEmacs = pkgs.emacsWithPackagesFromUsePackage {
    config = ../README.org;
    package = <<emacs-native-comp-package>>
    alwaysEnsure = true;
    alwaysTangle = true;
    extraEmacsPackages = epkgs: [
      # Required packages...
      <<emacs-exwm-package>>
      <<emacs-evil-package>>
      <<emacs-general-package>>
      <<emacs-which-key-package>>

      # Optional packages.
      <<emacs-org-package>>
      <<emacs-org-roam-package>>
      <<emacs-org-drill-package>>
      <<emacs-pomodoro-package>>
      <<emacs-writegood-package>>
      <<emacs-http-package>>
      <<emacs-hugo-package>>
      <<emacs-reveal-package>>
      <<emacs-pass-package>>
      <<emacs-docker-package>>
      <<emacs-mu4e-package>>
      <<emacs-dired-package>>
      <<emacs-icons-package>>
      <<emacs-emoji-package>>
      <<emacs-eshell-package>>
      <<emacs-vterm-package>>
      <<emacs-magit-package>>
      <<emacs-fonts-package>>
      <<emacs-elfeed-package>>
      <<emacs-nix-mode-package>>
      <<emacs-projectile-package>>
      <<emacs-lsp-package>>
      <<emacs-company-package>>
      <<emacs-ccls-package>>
      <<emacs-golang-package>>
      <<emacs-python-package>>
      <<emacs-rustic-package>>
      <<emacs-plantuml-package>>
      <<emacs-protobuf-package>>
      <<emacs-swiper-package>>
      <<emacs-desktop-package>>
      <<emacs-doom-themes-package>>
      <<emacs-doom-modeline-package>>
    ];
  };

in {
  home.packages = [
    <<emacs-exwm-extras>>
    <<emacs-pass-extras>>
    <<emacs-mu4e-extras>>
    <<emacs-aspell-extras>>
    <<emacs-texlive-extras>>
    <<emacs-desktop-extras>>
    <<emacs-plantuml-extras>>
    <<emacs-nix-mode-extras>>
  ];

  programs.emacs = {
    enable = true;
    package = myEmacs;
  };

  <<emacs-exwm-config>>
  <<emacs-exwm-xinitrc>>
  <<emacs-mu4e-config>>
}

When Emacs is started, it normally tries to load a Lisp program from an ititialization file, or init file. This file, if it exists, specifies how to initialize and configure Emacs.

;; <<file-warning>>

;; Required inputs.
<<emacs-exwm-elisp>>
<<emacs-evil-elisp>>
<<emacs-general-elisp>>
<<emacs-which-key-elisp>>

;; Optional inputs.
<<emacs-org-elisp>>
<<emacs-org-roam-elisp>>
<<emacs-org-drill-elisp>>
<<emacs-org-agenda-elisp>>
<<emacs-pomodoro-elisp>>
<<emacs-writegood-elisp>>
<<emacs-aspell-elisp>>
<<emacs-eww-elisp>>
<<emacs-http-elisp>>
<<emacs-hugo-elisp>>
<<emacs-reveal-elisp>>
<<emacs-pass-elisp>>
<<emacs-docker-elisp>>
<<emacs-erc-elisp>>
<<emacs-mu4e-elisp>>
<<emacs-dired-elisp>>
<<emacs-icons-elisp>>
<<emacs-emoji-elisp>>
<<emacs-eshell-elisp>>
<<emacs-vterm-elisp>>
<<emacs-magit-elisp>>
<<emacs-fonts-elisp>>
<<emacs-elfeed-elisp>>
<<emacs-projectile-elisp>>
<<emacs-lsp-elisp>>
<<emacs-company-elisp>>
<<emacs-golang-elisp>>
<<emacs-python-elisp>>
<<emacs-rustic-elisp>>
<<emacs-plantuml-elisp>>
<<emacs-desktop-elisp>>

;; User interface.
<<emacs-swiper-elisp>>
<<emacs-transparency-elisp>>
<<emacs-doom-themes-elisp>>
<<emacs-doom-modeline-elisp>>

It's somtimes desirable to have customization that takes effect during Emacs startup earlier than the normal init file. Place these configurations in ~/.emacs.d/early-init.el. Most customizations should be put in the normal init file ~/.emacs.d/init.el.

;; <<file-warning>>
<<emacs-disable-ui-elisp>>
<<emacs-native-comp-elisp>>
<<emacs-backup-files-elisp>>
<<emacs-shell-commands-elisp>>

Native Comp

pkgs.emacsGcc;

Native Comp, also known as GccEmacs, refers to the --with-native-compilation configuration option when building GNU/Emacs². It adds support for compiling Emacs Lisp to native code using libgccjit. All of the Emacs Lisp packages shipped with Emacs are native-compiled, providing a noticable performance iomprovement out-of-the-box.

;; Silence warnings from packages that don't support `native-comp'.
(setq comp-async-report-warnings-errors nil         ;; Emacs 27.2 ...
      native-comp-async-report-warnings-errors nil) ;; Emacs 28+  ...

Disable UI

Emacs² has been around since the 1980s, and it's painfully obvious when you're greeted with the default user interface. Disable some unwanted features to clean it up, and bring the appearance to something closer to a modern editor.

;; Disable unwanted UI elements.
(tooltip-mode -1)
(menu-bar-mode -1)
(tool-bar-mode -1)
(scroll-bar-mode -1)

;; Fix the scrolling behaviour.
(setq scroll-conservatively 101)

;; Fix mouse-wheel scrolling behaviour.
(setq mouse-wheel-follow-mouse t
      mouse-wheel-progressive-speed t
      mouse-wheel-scroll-amount '(3 ((shift) . 3)))

;; Start in fullscreen/maximized.
(add-to-list 'default-frame-alist '(fullscreen . maximized))

Backup Files

Emacs² makes a backup for a file only the first time the file is saved from a buffer. No matter how many times the file is subsequently written to, the backup remains unchanged. For files managed by a version control system, backup files are redundant since the previous versions are already stored.

;; Disable unwanted features.
(setq make-backup-files nil
      create-lockfiles nil)

Shell Commands

Define some methods for interaction between GNU/Emacs², and the systems underyling shell:

1. Method to run an external process, launching any application on a new process without interferring with Emacs²

2. Method to apply commands to the curren call process, effecting the running instance of Emacs²

;; Define a method to run an external process.
(defun dotfiles/run (cmd)
  "Run an external process."
  (interactive (list (read-shell-command "λ ")))
  (start-process-shell-command cmd nil cmd))

;; Define a method to run a background process.
(defun dotfiles/run-in-background (cmd)
  (let ((command-parts (split-string cmd "[ ]+")))
    (apply #'call-process `(,(car command-parts) nil 0 nil ,@(cdr command-parts)))))

Nix Mode

pkgs.nixfmt

Nix-mode⁴⁵ is an Emacs² major mode for editing Nix⁶ expressions. This provides basic handling of .nix files. Syntax highlighting and indentation support using SMIE are provided.

epkgs.nix-mode

Evil Mode

Evil⁴⁶ is an extensible VI layer for GNU/Emacs². It emulates the main features of Vim⁴³, turning GNU/Emacs² into a modal editor.

epkgs.evil
epkgs.evil-collection
epkgs.evil-surround
epkgs.evil-nerd-commenter

The next time Emacs² is started, it will come up in normal state, denoted by <N> in the modeline. This is where the main vi bindings are defined. Like Emacs² in general, Evil⁴⁶ is extensible in Emacs Lisp⁴².

;; Enable the Extensible VI Layer for Emacs.
(setq evil-want-integration t   ;; Required for `evil-collection.'
      evil-want-keybinding nil) ;; Same as above.
(evil-mode +1)

;; Configure `evil-collection'.
(evil-collection-init)

;; Configure `evil-surround'.
(global-evil-surround-mode +1)

;; Configure `evil-nerd-commenter'.
(global-set-key (kbd "M-;") 'evilnc-comment-or-uncomment-lines)

EXWM

epkgs.exwm

EXWM (Emacs X Window Manager)²⁵ is a full-featured tiling X window manager for GNU/Emacs² built on-top of XELB. It features:

• Fully keyboard-driven operations

• Hybrid layout modes (tiling & stacking)

• Dynamic workspace support

• ICCM/EWMH compliance

pkgs.nitrogen
pkgs.autorandr

I wanted to leave (exwm-enable) out of my Emacs configuration (which does no harm anyways). This can be called when using the daemon to start EXWM²⁵.

xsession = {
  enable = true;
  windowManager.command = ''
    ${pkgs.nitrogen}/bin/nitrogen --restore
    ${myEmacs}/bin/emacs --daemon -f exwm-enable
    ${myEmacs}/bin/emacsclient -c
  '';
};

EXWM²⁵ cannot make an X window manager by itself, this is by design; You must tell X to do it. Override the ~/.xinitrc file to start the xsession.

home.file.".xinitrc" = {
  text = ''
    exec ./.xsession
  '';
};

;; Configure `exwm'.
(setq exwm-layout-show-all-buffers t
      exwm-worspace-show-all-buffers t)

;; Configure input keys.
(setq exwm-input-prefix-keys
  '(?\M-x
  ?\C-g
  ?\C-\ ))
(setq exwm-input-global-keys
  `(([?\s-r] . exwm-reset)
    ,@(mapcar (lambda (i)
                `(,(kbd (format "s-%d" i)) .
                (lambda ()
                (interactive)
                (exwm-workspace-switch-create ,i))))
                (number-sequence 0 9))))

;; Configure `exwm-randr'.
(require 'exwm-randr)
(exwm-randr-enable)

;; Configure custom hooks.
(setq display-time-day-and-date t)
(add-hook 'exwm-init-hook
  (lambda ()
    (display-battery-mode +1) ;; Display battery info (if available).
    (display-time-mode +1)))  ;; Display the time in the modeline.

;; Setup buffer display names.
(add-hook 'exwm-update-class-hook
  (lambda ()
    (exwm-workspace-rename-buffer exwm-class-name))) ;; Use the system class name.

;; Configure monitor hot-swapping.
(add-hook 'exwm-randr-screen-change-hook
  (lambda ()
    (dotfiles/run-in-background "autorandr --change --force"))) ;; Swap to the next screen config.

General

epkgs.general

General⁴⁷ provides a more convenient method for binding keys in Emacs², providing a unified interface for key definitions. Its primary purpose is to build on existing functionality to make key definitions more clear and concise.

;; Use <SPC> as a leader key via `general.el'.
(general-create-definer dotfiles/leader
  :keymaps '(normal insert visual emacs)
  :prefix "SPC"
  :global-prefix "C-SPC")

;; Setup general to work with `evil-mode'.
(setq general-evil-setup t)

;; Find files with <SPC> <period> ...
;; Switch buffers with <SPC> <comma> ...
(dotfiles/leader
  "." '(find-file :which-key "File")
  "," '(switch-to-buffer :which-key "Buffer")
  "k" '(kill-buffer :which-key "Kill")
  "c" '(kill-buffer-and-window :which-key "Close"))

;; Add keybindings for executing shell commands.
(dotfiles/leader
  "r" '(:ignore t :which-key "Run")
  "rr" '(dotfiles/run :which-key "Run")
  "ra" '(async-shell-command :which-key "Async"))

;; Add keybindings for quitting Emacs.
(dotfiles/leader
  "q" '(:ignore t :which-key "Quit")
  "qq" '(save-buffers-kill-emacs :which-key "Save")
  "qw" '(kill-emacs :which-key "Now")
  "qf" '(delete-frame :which-key "Frame"))

;; Add keybindings for toggles / tweaks.
(dotfiles/leader
  "t" '(:ignore t :which-key "Toggle / Tweak"))

;; Add keybindings for working with frames to replace
;; the C-x <num> <num> method of bindings, which is awful.
(dotfiles/leader
  "w" '(:ignore t :which-key "Windows")
  "ww" '(window-swap-states :which-key "Swap")
  "wc" '(delete-window :which-key "Close")
  "wh" '(windmove-left :which-key "Left")
  "wj" '(windmove-down :which-key "Down")
  "wk" '(windmove-up :which-key "Up")
  "wl" '(windmove-right :which-key "Right")
  "ws" '(:ignore t :which-key "Split")
  "wsj" '(split-window-below :which-key "Below")
  "wsl" '(split-window-right :which-key "Right"))

Which Key

Which-key⁴⁸ is a minor mode for Emacs² that displays the key bindings following your currently entered incomplete command (prefix) in a popup or mini-buffer.

epkgs.which-key

;; Configure `which-key' to see keyboard bindings in the
;; mini-buffer and when using M-x.
(setq which-key-idle-delay 0.0)
(which-key-mode +1)

EWW

The Emacs Web Wowser⁴⁹ is a Web browser written in Emacs Lisp⁴² based on the shr.el library. It's my primary browser when it comes to text-based browsing.

• Use eww as the default browser

• Don't use any special fonts or colours

;; Set `eww' as the default browser.
(setq browse-url-browser-function 'eww-browse-url)

;; Configure the `shr' rendering engine.
(setq shr-use-fonts nil
      shr-use-colors nil)

ERC

ERC⁵⁰ is a powerful, modular, and extensible IRC client for GNU/Emacs². It's part of the GNU project, and included in Emacs.

;; Configure `erc'.
(setq erc-autojoin-channels-alist '(("irc.libera.chat" "#emacs" "#nixos" "#org-mode" "#systemcrafters"))
      erc-track-exclude-types '("JOIN" "NICK" "QUIT" "MODE")
      erc-lurker-hide-list '("JOIN" "PART" "QUIT"))

;; Configure `erc-fill-column'.
(add-hook 'window-configuration-change-hook
  '(lambda ()
     (setq erc-fill-column (- (window-width) 12))))

;; Connect to IRC via `erc'.
(defun dotfiles/erc-connect ()
  "Connected to IRC via `erc'."
  (interactive)
  (erc-tls :server "irc.libera.chat"
           :port 6697
           :nick "megaphone"
           :password (password-store-get "megaphone@libera.chat")
           :full-name "Chris Hayward"))

;; Configure keybindings.
(dotfiles/leader
  "i" '(dotfiles/erc-connect :which-key "Chat"))

Dired

epkgs.dired-single

Dired⁵¹ shows a directory listing inside of an Emacs² buffer that can be used to perform various file operations on files and subdirectories. THe operations you can perform are numerous, from creating subdirectories, byte-compiling files, searching, and editing files. Dired-Extra⁵² provides extra functionality for Dired⁵¹.

;; Include `dired-x' for the `jump' method.
(require 'dired-x)

;; Configure `dired-single' to support `evil' keys.
(evil-collection-define-key 'normal 'dired-mode-map
  "h" 'dired-single-up-directory
  "l" 'dired-single-buffer)

;; Setup `all-the-icons' and the `dired' extension.

;; Configure keybindings for `dired'.
(dotfiles/leader
  "d" '(dired-jump :which-key "Dired"))

Icons

epkgs.all-the-icons
epkgs.all-the-icons-dired

All The Icons⁵³ is a utility package to collect various Icon Fonts and prioritize them within GNU/Emacs².

;; Setup `all-the-icons-dired'.
(add-hook 'dired-mode-hook 'all-the-icons-dired-mode)

;; Disable monochrome icons.
(setq all-the-icons-dired-monochrome nil)

;; Display default font ligatures.
(global-prettify-symbols-mode +1)

Emojis

epkgs.emojify

Emojify⁵⁴ is an Emacs² extension to display Emojis. It can display GitHub style Emojis like 😄 or plain ascii ones such as :). It tries to be as efficient as possible, while also providing flexibility.

;; Setup `emojify'.
(add-hook 'after-init-hook 'global-emojify-mode)

EShell

epkgs.eshell-prompt-extras

EShell ⁵⁵ is a shell-like command interpreter for GNU/Emacs² implemented in Emacs Lisp⁴². It invokes no external processes except for those requested by the user. It's intended to be an alternative for IELM, and a full REPL envionment for Emacs².

;; Configure `eshell'.
(setq eshell-highlight-prompt nil
      eshell-prefer-lisp-functions nil)

;; Configure the lambda prompt.
(autoload 'epe-theme-lambda "eshell-prompt-extras")
(setq eshell-prompt-function 'epe-theme-lambda)

;; Configure keybindings for `eshell'.
(dotfiles/leader
  "e" '(eshell :which-key "EShell"))

VTerm

Emacs Libvterm (VTerm)⁵⁶ is a fully-fledged terminal emulator inside GNU/Emacs² based on Libvterm⁵⁷, a blazing fast C library used in Neovim⁴³. As a result of using compiled code (instead of Emacs Lisp⁴²), VTerm⁵⁶ is capable, fast, and it can seamlessly handle large outputs.

epkgs.vterm

;; Add keybindings for interacting with the shell(s).
(dotfiles/leader
  "v" '(vterm :which-key "VTerm"))

Magit

Magit⁵⁸ is an interface to the Git⁴¹ version control system, implemented as a GNU/Emacs² package written in Elisp⁴². It fills the glaring gap between the Git⁴¹ command line interface and various GUIs, letting you perform trivial as well as elaborate version control tasks within a few mnemonic key presses.

epkgs.magit

;; Add keybindings for working with `magit'.
(dotfiles/leader
  "g" '(:ignore t :which-key "Git")
  "gg" '(magit-status :which-key "Status")
  "gc" '(magit-clone :which-key "Clone")
  "gf" '(magit-fetch :which-key "Fetch")
  "gp" '(magit-pull :which-key "Pull"))

Fonts

epkgs.hydra

;; Configure the font when running as `emacs-server'.
(custom-set-faces
  '(default ((t (:inherit nil :height 120 :family "Iosevka")))))

;; Set all three of Emacs' font faces.
;; NOTE: This only works without `emacs-server'.
;; (set-face-attribute 'default nil :font "Iosevka" :height 96)
;; (set-face-attribute 'fixed-pitch nil :font "Iosevka" :height 96)
;; (set-face-attribute 'variable-pitch nil :font "Iosevka" :height 96)

;; Define a `hydra' function for scaling the text interactively.
(defhydra hydra-text-scale (:timeout 4)
  "Scale text"
  ("j" text-scale-decrease "Decrease")
  ("k" text-scale-increase "Increase")
  ("f" nil "Finished" :exit t))

;; Create keybinding for calling the function.
(dotfiles/leader
  "tf" '(hydra-text-scale/body :which-key "Font"))

Elfeed

epkgs.elfeed

Elfeed⁵⁹ is an extensible web feed reader for GNU/Emacs², support both Atom and RSS. It requires Emacs 24.3+ and is available for download from the standard repositories.

;; Configure `elfeed'.
(setq elfeed-db-directory (expand-file-name "~/.cache/elfeed"))

;; Add custom feeds for `elfeed' to fetch.
(setq elfeed-feeds (quote
                     (("https://hexdsl.co.uk/rss.xml")
                      ("https://lukesmith.xyz/rss.xml")
                      ("https://friendo.monster/rss.xml")
                      ("https://chrishayward.xyz/index.xml")
                      ("https://protesilaos.com/master.xml"))))

;; Add custom keybindings for `elfeed'.
(dotfiles/leader
  "l" '(:ignore t :which-key "Elfeed")
  "ll" '(elfeed :which-key "Open")
  "lu" '(elfeed-update :which-key "Update"))

Org Mode

epkgs.org

Org-mode⁶⁰ is a document editing and organizing mode, designed for notes, planning, and authoring within the free software text editor GNU/Emacs². The name is used to encompass plain text files (such as this one) that include simple marks to indicate levels of a hierarchy, and an editor with functions that can read the markup and manipulate the hierarchy elements.

;; Configure `org-mode' source blocks.
(setq org-src-fontify-natively t      ;; Make source blocks prettier.
      org-src-tab-acts-natively t     ;; Use TAB indents within source blocks.
      org-src-preserve-indentation t  ;; Stop `org-mode' from formatting blocks.
      org-confirm-babel-evaluate nil) ;; Don't ask for confirmation to evaluate blocks.

;; Add an `org-mode-hook'.
(add-hook 'org-mode-hook
  (lambda ()
    (org-indent-mode)
    (visual-line-mode)))

;; Remove the `Validate XHTML 1.0' message from HTML export.
(setq org-export-html-validation-link nil
      org-html-validation-link nil)

;; Configure the keywords in the TODO -> DONE sequence.
(setq org-todo-keywords '((sequence "TODO" "START" "WAIT" "DONE")))

;; Track ids globally.
(setq org-id-track-globally t)

;; Configure `org-babel' languages.
(org-babel-do-load-languages
  'org-babel-load-languages
  '((C . t)))

;; Log / Clock into property drawers.
(setq org-log-into-drawer t
      org-clock-into-drawer t)

;; Encrypt files with the public key.
(setq epa-file-select-keys 2
      epa-file-encrypt-to "37AB1CB72B741E478CA026D43025DCBD46F81C0F"
      epa-cache-passphrase-for-symmetric-encryption t)

;; TODO: Configure default structure templates.
;; (require 'org-tempo)

;; Apply custom keybindings.
(dotfiles/leader
  "o" '(:ignore t :which-key "Org")
  "oe" '(org-export-dispatch :which-key "Export")
  "ot" '(org-babel-tangle :which-key "Tangle")
  "oi" '(org-toggle-inline-images :which-key "Images")
  "of" '(:ignore t :which-key "Footnotes")
  "ofn" '(org-footnote-normalize :which-key "Normalize"))

Org Roam

epkgs.org-roam
# epkgs.org-roam-ui # TODO: Provide from Github
epkgs.websocket
epkgs.simple-httpd

Org Roam⁶¹ is a plain-text knowledge management system. It borrows principles from the Zettelkasten method⁶², providing a solution for non-hierarchical note-taking. It should also work as a plug-and-play solution for anyone already using Org Mode⁶⁰ for their personal wiki (me).

;; Setup `org-roam'.
(require 'org-roam)

;; HACK: Set up `org-roam-ui'.
(add-to-list 'load-path "~/.local/source/org-roam-ui")
(load-library "org-roam-ui")
(setq org-roam-ui-follow t
      org-roam-ui-sync-theme t
      org-roam-ui-open-on-start t
      org-roam-ui-update-on-save t
      org-roam-ui-browser-function #'browse-url-firefox)

;; Silence the migration warnings.
(setq org-roam-v2-ack t)

;; Enable completion everywhere.
(setq org-roam-completion-everywhere t)

;; Set the roam directories.
(setq org-roam-directory (expand-file-name "/etc/dotfiles")
      org-roam-dailies-directory (concat org-roam-directory "/docs/daily"))

;; Clear the deafult capture templates.
(setq org-roam-capture-templates '()
      org-roam-dailies-capture-templates '())

;; Override the default slug method.
(cl-defmethod org-roam-node-slug ((node org-roam-node))
  (let ((title (org-roam-node-title node))
        (slug-trim-chars '(768 ; U+0300 COMBINING GRAVE ACCENT
                           769 ; U+0301 COMBINING ACUTE ACCENT
                           770 ; U+0302 COMBINING CIRCUMFLEX ACCENT
                           771 ; U+0303 COMBINING TILDE
                           772 ; U+0304 COMBINING MACRON
                           774 ; U+0306 COMBINING BREVE
                           775 ; U+0307 COMBINING DOT ABOVE
                           776 ; U+0308 COMBINING DIAERESIS
                           777 ; U+0309 COMBINING HOOK ABOVE
                           778 ; U+030A COMBINING RING ABOVE
                           780 ; U+030C COMBINING CARON
                           795 ; U+031B COMBINING HORN
                           803 ; U+0323 COMBINING DOT BELOW
                           804 ; U+0324 COMBINING DIAERESIS BELOW
                           805 ; U+0325 COMBINING RING BELOW
                           807 ; U+0327 COMBINING CEDILLA
                           813 ; U+032D COMBINING CIRCUMFLEX ACCENT BELOW
                           814 ; U+032E COMBINING BREVE BELOW
                           816 ; U+0330 COMBINING TILDE BELOW
                           817 ; U+0331 COMBINING MACRON BELOW
                           )))
    (cl-flet* ((nonspacing-mark-p (char)
				  (memq char slug-trim-chars))
	       (strip-nonspacing-marks (s)
				       (ucs-normalize-NFC-string
					(apply #'string (seq-remove #'nonspacing-mark-p
								    (ucs-normalize-NFD-string s)))))
	       (cl-replace (title pair)
			   (replace-regexp-in-string (car pair) (cdr pair) title)))
      (let* ((pairs `(("[^[:alnum:][:digit:]]" . "-")  
		      ("--*" . "-")  
		      ("^-" . "")  
		      ("-$" . "")))
	     (slug (-reduce-from #'cl-replace (strip-nonspacing-marks title) pairs)))
	(downcase slug)))))

;; Configure capture templates.
;; Standard document.
(add-to-list 'org-roam-capture-templates
  '("d" "Default" plain "%?"
    :target (file+head "docs/%<%Y%m%d%H%M%S>-${slug}.org.gpg"
"
,#+TITLE: ${title}
,#+AUTHOR: Christopher James Hayward
,#+EMAIL: chris@chrishayward.xyz
"
)
    :unnarrowed t))

;; Daily notes.
(add-to-list 'org-roam-dailies-capture-templates
  '("d" "Default" entry "* %?"
    :target (file+head "%<%Y-%m-%d>.org.gpg"
"
,#+TITLE: %<%Y-%m-%d>
,#+AUTHOR: Christopher James Hayward
,#+EMAIL: chris@chrishayward.xyz
")))

;; Run the setup command.
(org-roam-setup)

;; Apply custom keybindings.
(dotfiles/leader
  "or"  '(:ignore t :which-key "Roam")
  "ori" '(org-roam-node-insert :which-key "Insert")
  "orf" '(org-roam-node-find :which-key "Find")
  "orc" '(org-roam-capture :which-key "Capture")
  "orb" '(org-roam-buffer-toggle :which-key "Buffer"))

;; Apply custom keybindings for dailies.
(dotfiles/leader
  "ord" '(:ignore t :which-key "Dailies")
  "ordd" '(org-roam-dailies-goto-date :which-key "Date")
  "ordt" '(org-roam-dailies-goto-today :which-key "Today")
  "ordm" '(org-roam-dailies-goto-tomorrow :which-key "Tomorrow")
  "ordy" '(org-roam-dailies-goto-yesterday :which-key "Yesterday"))

Org Drill

epkgs.org-drill

Org Drill⁶³ is an extension for Org Mode⁶⁰ that uses a spaced repition algorithm to conduct interactive Drill Sessions using Org files as sources of facts to be memorized.

;; Exclude :drill: items from `org-roam'.
(setq org-roam-db-node-include-function
  (defun dotfiles/org-roam-include ()
    (not (member "drill" (org-get-tags)))))

;; Configure keybindings for `org-drill'.
(dotfiles/leader
  "od" '(:ignore t :which-key "Drill")
  "odd" '(org-drill :which-key "Drill")
  "odc" '(org-drill-cram :which-key "Cram")
  "odr" '(org-drill-resume :which-key "Resume"))

Org Agenda

The way Org Mode⁶⁰ works, TODO items, time-stamped items, and tagged headlines can be scattered throughout a file, or even a number of files. To get an overview of open action items, or of events that are important for a particular date, this information must be collected, sorted, and displayed in an organized way.

;; Configure `org-agenda' to use the project files.
(setq org-agenda-files '("/etc/dotfiles/"
                         "/etc/dotfiles/docs/"
                         "/etc/dotfiles/docs/daily/"))

;; Include files encrypted with `gpg'.
(require 'org)
(unless (string-match-p "\\.gpg" org-agenda-file-regexp)
  (setq org-agenda-file-regexp
    (replace-regexp-in-string "\\\\\\.org" "\\\\.org\\\\(\\\\.gpg\\\\)?"
                              org-agenda-file-regexp)))

;; Open an agenda buffer with SPC o a.
(dotfiles/leader
  "oa" '(org-agenda :which-key "Agenda"))

Org Pomodoro

epkgs.org-pomodoro

Org Pomodoro⁶⁴ adds basic support for the Pomodoro Technique⁶⁵ in GNU/Emacs². It can be started for the task at point, or the last task time was clocked for. Each session starts a timer of 25 minutes, finishing with a break of 5 minutes. After 4 sessions, ther will be a break of 20 minutes. All values are customizable.

;; Configure `org-pomodor' with the overtime workflow.
(setq org-pomodoro-manual-break t
      org-pomodoro-keep-killed-time t)

;; Configure keybindings.
(dotfiles/leader
  "op" '(org-pomodoro :which-key "Pomodoro"))

Writegood Mode

epkgs.writegood-mode

Writegood Mode⁶⁶ is an Emacs² minor mode to aid in finding common writing problems. It highlights the text based on the following criteria:

• Weasel Words

• Passive Voice

• Duplicate Words

;; Configure `writegood-mode'.
(dotfiles/leader
  "tg" '(writegood-mode :which-key "Grammar"))

Aspell

pkgs.aspell
pkgs.aspellDicts.en
pkgs.aspellDicts.en-science
pkgs.aspellDicts.en-computers

GNU Aspell⁶⁷ is a Free and Open Source spell checker designed to replace ISpell. It can be used as a library, or an independent spell checker. Its main feature is that it does a superior job of suggesting possible replacements for mis-spelled words than any other spell checker for the English language.

;; Use `aspell' as a drop-in replacement for `ispell'.
(setq ispell-program-name "aspell"
      ispell-eextra-args '("--sug-mode=fast"))

;; Configure the built-in `flyspell-mode'.
(dotfiles/leader
  "ts" '(flyspell-mode :which-key "Spelling"))

TexLive

TeX Live⁶⁸ is a free software distributution for the TeX typesetting system that includes major TeX-related programs, macro packages, and fonts. Since TeX Live consists of thousands of packages, to make managing it easier, NixOS replicates the organization of Tex Live into schemes and collections⁶⁹:

Name	Derivation	Comment
Full	texlive.combined.scheme-full	Contains every TeX Live package
Medium	texlive.combined.scheme-medium	Contains everything in small + more packages and languages
Small	texlive.combined.scheme-small	Contains everything in basic + xetex + metapost
Basic	texlive.combined.scheme-basic	Contains everything in the plain scheme but includes latex
Minimal	texlive.combined.scheme-minimal	Contains plain only

pkgs.texlive.combined.scheme-full

Http

epkgs.ob-http

It's possible to make HTTP requests from Org Mode buffers using ob-http⁷⁰, this relies on Org Babel being present and configured properly.

;; Required to setup `ob-http'.
(org-babel-do-load-languages
  'org-babel-load-languages
  '((http . t)))

Hugo

epkgs.ox-hugo

Ox-Hugo⁷¹ is an Org-Mode⁶⁰ exporter for Hugo³³ compabile markdown. My dotfiles are a result of this, and are available to view here https://chrishayward.xyz/dotfiles/.

;; Configure `ox-hugo' as an `org-mode-export' backend.
(require 'ox-hugo)

;; Set up the base directory.
(setq org-hugo-base-dir (expand-file-name "/etc/dotfiles/docs"))

;; Capture templates.
;; Shared content
;; (add-to-list 'org-roam-capture-templates
;;   '("p" "Post" plain "%?"
;;     :target (file+head "docs/posts/${slug}.org.gpg"
;; "
;; ,#+TITLE: ${title}
;; ,#+AUTHOR: Christopher James Hayward
;; ,#+DATE: %<%Y-%m-%d>

;; ,#+EXPORT_FILE_NAME: ${slug}
;; ,#+OPTIONS: num:nil todo:nil tasks:nil

;; ,#+ROAM_KEY: https://chrishayward.xyz/posts/${slug}/

;; ,#+HUGO_BASE_DIR: ../
;; ,#+HUGO_AUTO_SET_LASTMOD: t
;; ,#+HUGO_SECTION: posts
;; ,#+HUGO_DRAFT: true
;; "
;; )
;;     :unnarrowed t))

Passwords

pkgs.pass

With Pass⁷², each password lives inside of an encrypted gpg file, whose name is the title of the website or resource that requires the password. These encrypted files may be organized into meaningful folder hierarchies, compies from computer to computer, and in general, manipulated using standard command line tools.

epkgs.password-store

Configure keybindings for passwords behind SPC p:

;; Set the path to the password store.
(setq password-store-dir (expand-file-name "~/.password-store"))

;; Apply custom keybindings.
(dotfiles/leader
  "p" '(:ignore t :which-key "Passwords")
  "pp" '(password-store-copy :which-key "Copy")
  "pe" '(password-store-edit :which-key "Edit")
  "pi" '(password-store-insert :which-key "Insert")
  "pr" '(password-store-rename :which-key "Rename")
  "pg" '(password-store-generate :which-key "Generate"))

Docker

epkgs.docker
epkgs.dockerfile-mode

Manage Docker from inside of Emacs using Docker.el⁷³. This is a full docker porcelain similar to Magit, allowing complete control of a Docker system. Add syntax highlighting to Dockerfiles using dockerfile-mode⁷⁴ from Spotify.

;; Apply custom keybindings.
(dotfiles/leader
  "n" '(:ignore t :which-key "Containers")
  "nd" '(docker :which-key "Docker"))

MU4E

pkgs.mu
pkgs.isync

epkgs.mu4e-alert

# Deploy the authinfo file.
home.file.".authinfo.gpg".source = ../config/authinfo.gpg;

# Deploy the isync configuration file.
home.file.".mbsyncrc" = {
  text = ''
    IMAPStore xyz-remote
    Host mail.chrishayward.xyz
    User chris@chrishayward.xyz
    PassCmd "pass chrishayward.xyz/chris"
    SSLType IMAPS
    
    MaildirStore xyz-local
    Path ~/.cache/mail/
    Inbox ~/.cache/mail/inbox
    SubFolders Verbatim
    
    Channel xyz
    Far :xyz-remote:
    Near :xyz-local:
    Patterns * !Archives
    Create Both
    Expunge Both
    SyncState *
  '';
};

mbsync -a
mu init --maildir="~/.cache/mail" --my-address="chris@chrishayward.xyz"
mu index

;; Add the `mu4e' shipped with `mu' to the load path.
(add-to-list 'load-path "/etc/profiles/per-user/chris/share/emacs/site-lisp/mu4e/")
(require 'mu4e)

;; Confiugure `mu4e'.
(setq mu4e-maildir "~/.cache/mail"
      mu4e-update-interval (* 5 60)
      mu4e-get-mail-command "mbsync -a"
      mu4e-compose-format-flowed t
      mu4e-change-filenames-when-moving t
      mu4e-compose-signature (concat "Chris Hayward\n"
                                     "chris@chrishayward.xyz"))

;; Sign all outbound email with GPG.
(add-hook 'message-send-hook 'mml-secure-message-sign-pgpmime)
(setq message-send-mail-function 'smtpmail-send-it
      mml-secure-openpgp-signers '("37AB1CB72B741E478CA026D43025DCBD46F81C0F"))

;; Setup `mu4e' accounts.
(setq mu4e-contexts
  (list
    ;; Main
    ;; chris@chrishayward.xyz
    (make-mu4e-context
      :name "Main"
      :match-func
        (lambda (msg)
          (when msg
            (string-prefix-p "/Main" (mu4e-message-field msg :maildir))))
      :vars
        '((user-full-name . "Christopher James Hayward")
          (user-mail-address . "chris@chrishayward.xyz")
          (smtpmail-smtp-server . "mail.chrishayward.xyz")
          (smtpmail-smtp-service . 587)
          (smtpmail-stream-type . starttls)))))

;; Setup `mu4e-alert'.
(setq mu4e-alert-set-default-style 'libnotify)
(mu4e-alert-enable-notifications)
(mu4e-alert-enable-mode-line-display)

;; Open the `mu4e' dashboard.
(dotfiles/leader
  "m" '(mu4e :which-key "Mail"))

Projectile

epkgs.projectile

Projectile⁷⁵ is a project interaction library for GNU/Emacs². Its goal is to provide a nice set of features operating on a project level, without introducing external dependencies.

;; Configure the `projectile-project-search-path'.
(setq projectile-project-search-path '("~/.local/source"))
(projectile-mode +1)

LSP Mode

epkgs.lsp-mode
epkgs.lsp-ui

The Language Server Protocol (LSP)⁷⁶ defines the protocol used between an Editor or IDE, and a language server that provides features like:

• Auto Complete

• Go To Defintion

• Find All References

;; Configure `lsp-mode'.
(setq lsp-idle-delay 0.5
      lsp-prefer-flymake t)

;; Configure `lsp-ui'.
(setq lsp-ui-doc-position 'at-point
      lsp-ui-doc-delay 0.5)

CCLS

epkgs.ccls

Emacs CCLS⁷⁷ is a client for CCLS, a C/C++/Objective-C language server supporting multi-million line C++ code bases, powered by libclang.

;; Configure `ccls' to work with `lsp-mode'.
(defun dotfiles/ccls-hook ()
  (require 'ccls)
  (lsp))

;; Configure `ccls' mode hooks.
(add-hook 'c-mode-hook 'dotfiles/ccls-hook)
(add-hook 'c++-mode-hook 'dotfiles/ccls-hook)
(add-hook 'objc-mode-hook 'dotfiles/ccls-hook)
(add-hook 'cuda-mode-hook 'dotfiles/ccls-hook)

Company Mode

epkgs.company

Company⁷⁸ is a text completion framework for GNU/Emacs². The name stands for Complete Anything. It uses pluggable back-ends and front-ends to retieve and display completion candidates.

;; Configure `company-mode'.
(setq company-backend 'company-capf
      lsp-completion-provider :capf)

;; Enable it globally.
(global-company-mode +1)

Go Mode

epkgs.go-mode

Go Mode⁷⁹ is a major mode for editing Golang¹³ source code in GNU/Emacs².

;; Configure `go-mode' to work with `lsp-mode'.
(defun dotfiles/go-hook ()
  (add-hook 'before-save-hook #'lsp-format-buffer t t)
  (add-hook 'before-save-hook #'lsp-organize-imports t t))

;; Configure a custom `before-save-hook'.
(add-hook 'go-mode-hook #'dotfiles/go-hook)

Rustic

epkgs.rustic

Rustic⁷⁸ is a fork of rust-mode that integrates well with the Language Server Protocol⁷². Include the rust shell before launching GNU/Emacs² to use this!

;; Configure `rustic' with `lsp-mode'.
(setq rustic-format-on-save t
      rustic-lsp-server 'rls)

Python Mode

epkgs.pretty-mode

The built in Python Mode⁸⁰ has a nice feature set for working with Python²⁰ code in GNU/Emacs². It is complimented with the addition of an LSP⁷⁶ server. These tools are included in the Development Shell¹² for Python²⁰.

;; Configure `pretty-mode' to work with `python-mode'.
(add-hook 'python-mode-hook
  (lambda ()
    (turn-on-pretty-mode)))

Protobuf Mode

epkgs.protobuf-mode

PlantUML

pkgs.plantuml

PlantUML⁸¹ is an open-source tool allowing users to create diagrams from a plain-text language. Besides various UML diagrams, PlantUML⁸¹ has support for various other software developmented related formats, as well as visualizations of JSON and YAML files.

epkgs.plantuml-mode

PlantUML Mode⁸² is a major mode for editing PlantUML⁸¹ sources in GNU/Emacs².

;; Configure `plantuml-mode'.
(add-to-list 'org-src-lang-modes '("plantuml" . plantuml))
(org-babel-do-load-languages 'org-babel-load-languages '((plantuml . t)))
(setq plantuml-default-exec-mode 'executable
      org-plantuml-exec-mode 'plantuml)

Swiper

epkgs.ivy
epkgs.counsel
epkgs.ivy-rich
epkgs.ivy-posframe
epkgs.ivy-prescient

Ivy (Swiper)⁸³ is a generic completion mechanism for GNU/Emacs². While operating similarily to other completion schemes like icomplete-mode, it aims to be more efficient, smaller, simpler, and smoother to use, while remaining highly customizable.

;; Configure `ivy'.
(setq counsel-linux-app-format-function
  #'counsel-linux-app-format-function-name-only)
(ivy-mode +1)
(counsel-mode +1)

;; Configure `ivy-rich'.
(ivy-rich-mode +1)

;; Configure `ivy-posframe'.
(setq ivy-posframe-parameters '((parent-frame nil))
      ivy-posframe-display-functions-alist '((t . ivy-posframe-display)))
(ivy-posframe-mode +1)

;; Configure `ivy-prescient'.
(setq ivy-prescient-enable-filtering nil)
(ivy-prescient-mode +1)

Transparency

It's possible to control the frame opacity in GNU/Emacs². Unlike other transparency hacks, it's not merely showing the desktop background image, but is true transparency – you can se other windows behind the Emacs² window.

;; Configure the default frame transparency.
(set-frame-parameter (selected-frame) 'alpha '(95 . 95))
(add-to-list 'default-frame-alist '(alpha . (95 . 95)))

Desktop Environment

pkgs.brightnessctl

The Desktop Environment⁸⁴ package provides commands and a global minor mode for controlling your GNU/Linux¹ desktop from within GNU/Emacs².

epkgs.desktop-environment

You can control the brightness, volume, take screenshots, and lock / unlock the screen. The package depends on the availability of shell commands to do the heavy lifting. They can be changed by customizing the appropriate variables.

;; Configure `desktop-environment'.
(require 'desktop-environment)
(desktop-environment-mode +1)

Doom Themes

epkgs.doom-themes

Doom Themes⁸⁵ is a theme megapack for GNU/Emacs², inspired by community favourites.

;; Include modern themes from `doom-themes'.
(setq doom-themes-enable-bold t
      doom-themes-enable-italic t)

;; Load the `doom-nord' and `doom-nord-light' themes.
;; (load-theme 'doom-nord-light t)
(load-theme 'doom-nord t)
(doom-modeline-mode +1)

;; Load a new theme with <SPC> t t.
(dotfiles/leader
  "tt" '(counsel-load-theme :which-key "Theme"))

Doom Modeline

epkgs.doom-modeline

Doom Modeline⁸⁵ is a fancy and fast modeline inspired by minimalism design. It's integrated into Centaur Emacs, Doom Emacs, and Spacemacs.

;; Add the `doom-modeline' after initialization.
(add-hook 'after-init-hook 'doom-modeline-mode)
(setq doom-modeline-height 16
      doom-modeline-icon t)

Footnotes

---

¹

https://gnu.org

²

https://gnu.org/software/emacs/

³

https://literateprogramming.com/knuthweb.pdf

⁴

https://docker.org

⁵

https://nixos.org/manual/nixos/stable

⁶

https://nixos.org/manual/nix/stable

⁷

https://nixos.org/manual/nixpkgs/stable

⁸

https://github.com/nix-community/home-manager

⁹

https://github.com/nix-community/emacs-overlay

¹⁰

https://github.com/nixos/nixos-hardware

¹¹

https://github.com/t184256/nix-on-droid

¹²

https://nixos.org/manual/nix/unstable/command-ref/nix-shell.html

¹³

https://golang.org

¹⁴

https://rust-lang.org

¹⁵

https://nodejs.org

¹⁶

https://openjdk.java.net

¹⁷

https://grpc.io

¹⁸

https://iso.org/standard/74528.html

¹⁹

https://en.wikipedia.org/wiki/C++/

²⁰

https://python.org

²¹

https://docs.docker.com/compose/

²²

https://docs.docker.com/machine/

²³

https://heroku.com

²⁴

https://qemu.org

²⁵

https://github.com/ch11ng/exwm

²⁶

https://laptopmedia.com/laptop-specs/acer-nitro-5-an515-53-2

²⁷

https://raspberrypi.org/products/raspberry-pi-400/

²⁸

https://www.raspberrypi.org/products/raspberry-pi-4-model-b/

²⁹

https://samsung.com/us/mobile/galaxy-s10/buy/

³⁰

https://x.org/wiki/

³¹

https://wayland.freedesktop.org

³²

https://openssh.com

³³

https://gohugo.io

³⁴

https://nixos.wiki/wiki/Flakes

³⁵

https://nix-community.cachix.org

³⁶

https://nixos.wiki/wiki/Nvidia

³⁷

https://en.wikipedia.org/wiki/Firefox

³⁸

https://jellyfin.org

³⁹

https://moonlight-stream.org

⁴⁰

https://teamviewer.com

⁴¹

https://git-scm.com

⁴²

https://emacswiki.org/emacs/LearnEmacsLisp

⁴³

https://neovim.io

⁴⁴

https://gtk.org

⁴⁵

https://github.com/nixos/nix-mode

⁴⁶

https://evil.readthedocs.io/en/latest/overview.html

⁴⁷

https://github.com/noctuid/general.el

⁴⁸

https://github.com/justbur/emacs-which-key

⁴⁹

https://emacswiki.org/emacs/eww

⁵⁰

https://gnu.org/software/emacs/erc.html

⁵¹

https://emacswiki.org/emacs/DiredMode

⁵²

https://emacswiki.org/emacs/DiredExtra#Dired_X

⁵³

https://github.com/domtronn/all-the-icons.el

⁵⁴

https://github.com/iqbalansari/emacs-emojify

⁵⁵

https://gnu.org/software/emacs/manual/html_mono/eshell.html

⁵⁶

https://github.com/akermu/emacs-libvterm

⁵⁷

https://github.com/neovim/libvterm

⁵⁸

https://magit.vc

⁵⁹

https://github.com/skeeto/elfeed

⁶⁰

https://orgmode.org

⁶¹

https://github.com/org-roam/org-roam

⁶²

https://zettelkasten.de

⁶³

https://orgmode.org/worg/org-contrib/org-drill.html

⁶⁴

https://github.com/marcinkoziej/org-pomodoro

⁶⁵

https://en.wikipedia.org/wiki/Pomodoro_Technique

⁶⁶

https://github.com/bnbeckwith/writegood-mode

⁶⁷

https://aspell.net

⁶⁸

https://wikipedia.org/wiki/Tex_Live

⁶⁹

https://nixos.wiki/wiki/TexLive

⁷⁰

https://github.com/zweifisch/ob-http

⁷¹

https://oxhugo.scripter.co

⁷²

https://password-store.org

⁷³

https://github.com/Silex/docker.el

⁷⁴

https://github.com/spotify/dockerfile-mode

⁷⁵

https://projectile.mx

⁷⁶

https://microsoft.github.io/language-server-protocol

⁷⁷

https://github.com/MaskRay/emacs-ccls

⁷⁸

https://company-mode.github.io

⁷⁹

https://emacswiki.org/emacs/GoMode

⁸⁰

https://plantuml.com

⁸¹

https://github.com/skuro/plantuml-mode

⁸²

https://github.com/abo-abo/swiper

⁸³

https://github.com/DamienCassou/desktop-environment

⁸⁴

https://github.com/hlissner/emacs-doom-themes

⁸⁵

https://github.com/seagle0128/doom-modeline