Mediocre Loadout

This repo contains everything needed to build my loadout, which is everything which I tend to take from one linux machine to the next. This includes:

• My development environment (neovim + plugins + a lot of customization)
• My shell (zsh + plugins + a custom theme)
• My window manager (awesome + plugins + a lot of customization)

I'm calling the result the "Mediocre Loadout". It is designed to be completely agnostic to the system it is running on, and to make little to no mutations to that system.

Build/Installation/Usage options

To build the Mediocre Loadout you must have a working nix installation, as well as an x86_64 machine. That's it.

There are multiple build/installation options:

nix Derivation

To build the nix derivation of the loadout you can do:

nix-build -A loadout

This will place the result in the result symlink in the root directory. Components of the loadout can then be executed from the bin subdirectory, e.g.:

./result/bin/nvim

nix Environment

Alternatively, to install it to your nix profile do:

nix-env -i default.nix -A loadout

Assuming your nix environment is set up correctly, you should be able to execute components directly:

nvim

AppImage

An AppImage binary can be built which can run any component of the loadout individually. This binary can be copied from one machine to the next without any of them requiring nix or any other dependencry to run it.

To build the binary:

nix-build -A appimage

The resulting binary will be placed in the result symlink in the root directory.

Specific components of the loadout can be run by passing an argument to the binary:

./Mediocre_Loadout-x86_64.AppImage nvim

NOTE that the AppImage doesn't like working with files within /tmp. I don't know of a workaround for this at the moment.

Available Components

Components of the loadout can be run separate from the others, depending on what you're trying to do. The following components are available to be run:

• zsh: My terminal shell. There's some customization to it but it should be pretty self-explanatory to "just use".

• nvim: My neovim development environment, plus all plugins I use. I mostly work in golang, so it's most tuned for that, but it does fine for general dev work. Ctrl-N will open NerdTree, <backslash>tn will open a terminal tab, and <backslash>th/<backslash>tl can be used to navigate tabs. There's a lot more customization that's been done, see the nvim/init.vim file.

• alacritty: Terminal GUI which I use. Yes, I always use a light-mode theme, because I work in well lit spaces generally. There's not much else to this.

• awesome: My window manager. There's so much customization I couldn't begin to start. Meta+Enter should open a terminal, where Meta is probably the windows key on your keyboard.

Status

This configuration is still fairly new, and so expect it to be fairly broken. I'll be updating it as I go though, so it should stabalize into something functional. I don't test the AppImage build very much, it's more of a gimick, but the shell and dev environment should work well from it at least.