Skip to content

megalithic/dotfiles

Repository files navigation

   β”Œβ”¬β”β”Œβ”€β”β”Œβ”€β”β”Œβ”€β”β”¬  β”¬β”Œβ”¬β”β”¬ β”¬β”¬β”Œβ”€β”
   β”‚β”‚β”‚β”œβ”€ β”‚ β”¬β”œβ”€β”€β”‚  β”‚ β”‚ β”œβ”€β”€β”‚β”‚
   β”΄ β”΄β””β”€β”˜β””β”€β”˜β”΄ β”΄β”΄β”€β”˜β”΄ β”΄ β”΄ β”΄β”΄β””β”€β”˜
   @megalithic πŸ—Ώ

screenshot

πŸš€ Installation

If you want to kick the tires, you can simply:

git clone https://github.com/megalithic/dotfiles.git ~/.dotfiles && cd ~/.dotfiles && make install

If you want to update an existing installation:

make -C ~/.dotfiles up

For platform specific installations:

cd ~/.dotfiles && make macos # or, `linux`
# or, for easier use:
make -C ~/.dotfiles macos

Get some help:

cd ~/.dotfiles && make help
# or, for easier use:
make -C ~/.dotfiles help

NOTE: to execute a make command from anywhere, say, specifically for your dotfiles: make -C ~/.dotfiles <GOAL>


This dotfiles repo is managed by dotbot; not near as over-the-top configurable as Ansible, but way more advanced than just GNU Stow.

I have tried to be platform agnostic, but the majority of scripts that run here are for macOS (specifically macOS Ventura -- x86 and arm), with a handful of Debian/Ubuntu Linux specific platform scripts and provisions. This means that certain tools/binaries I rely on might or might not install/configure on Linux. Though, I have tested it reasonably well on Ubuntu-based Linode and DigitalOcean instances.

πŸ‰ Thar be dragons

I am pushing updates constantly, so there are NO guarantees of stability with my config!

Warning

I highly recommend you dig into the scripts and configs to see what all is going on (because it does a lot more than what I'm describing in this README) before you -- all willy-nilly, throw caution to the wind -- install a stranger's shell scripts. 🀣


✨ Accoutrements

A few of the must-have tools I roll with:

megadotfiles