takouhai/dotfiles

taco's super awesome frosted flake configuration

taco's super awesome frosted flake(s)

it's grrrreat! ¹

this whole repository is a work in progress and may change at any time. be ye warned!

overview

hey what's up mtv welcome to my crib

i made a nix configuration to manage my life. nix is pretty crazy, you should check it out! declarative stuff is definitely the future.

it's way easier to throw these up on GitHub and just pull them down whenever i need them, so have them for free! you're welcome. i know. i'm too kind.

all of these directories (and some of these files) are self-documented (hopefully). read the READMEs and you should have a good time. if you're not having a good time, want me to explain something better, or have feedback in general, let me know in the issues. your thoughts and opinions are welcome!

table of contents

here's what this repository currently holds:

home

home configuration, powered by home-manager.

flake.nix

what makes this all happen, powered by nix flakes!

archive

the graveyard, powered by the neverending approach of time.

don't get me wrong, i like you checking out my stuff. but these instructions are mainly for me to install on my own machines. these aren't guaranteed to work on your machine at all. you can use then for reference, but don't expect them to work out of the box on your laptop/desktop/toaster.

install

you should probably install nix or have nixos installed already.

linux

sh <(curl -L https://nixos.org/nix/install) --daemon

we install it as a daemon because daemons never stop.²

macOS

sh <(curl -L https://nixos.org/nix/install)

from there, i clone this repository into my ~/.dotfiles directory.

git clone git@github.com:takouhai/dotfiles.git ~/.dotfiles

after that, i run the update commands below in a shell with those commands available. usually i'm on a host with nix, so popping open a nix shell with the appropriate flake i need (usually just home-manager) is enough to get me off the ground, home/shell-wise. you can find out how to enable flakes on your system/nix configuration here.

nix shell nixpkgs#home-manager

update

once you start, you can't stop! seriously, help me.

home

home-manager switch --flake .#taco

that should get you to the mountain, rock and roll.³

the zsh shell has some provided shortcuts to update the current setup as you're using it. you can use updateHome and updateNix to automatically reload based on the config. you're really just running the above commands through these shortcuts, though.

updateHome
updateChannel
updateAll

take a look at the source code to see what's happening.

license

don't worry, i got you. this'll be simple.

all of this is under the wtfpl. feel free to do wtf you want with them. if you want, you can mention that i made these and link back to this repository to help others learn nix, but that's entirely optional!

Footnotes

1. cereal isn't that great for you, actually. ↩

2. 'Daemons,' they call them. They perform action without user interaction. Monitoring, logging, notifications, primal urges, repressed memories, unconscious habits. They're always there, always active. You can try to be right, you can try to be good, you can try to make a difference. But it's all bullshit. 'Cause intentions are irrelevant. They don't drive us, daemons do. And me? I've got more than most.⁴

   ↩

3. rock and roll! ↩

4. 1.3_5-da3monsneverstop.caf ↩