Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/megalithic/dotfiles
🗿 dotfilery, configuration, environment settings, automation, etc. 🛖
https://github.com/megalithic/dotfiles
asdf cli dotfiles elixir hammerspoon homebrew kitty lua macos neovim pde qmk surfingkeys tmux weechat zk zmk zsh
Last synced: about 2 months ago
JSON representation
🗿 dotfilery, configuration, environment settings, automation, etc. 🛖
- Host: GitHub
- URL: https://github.com/megalithic/dotfiles
- Owner: megalithic
- Created: 2018-05-25T02:07:41.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-11-08T19:46:10.000Z (2 months ago)
- Last Synced: 2024-11-08T20:30:08.933Z (2 months ago)
- Topics: asdf, cli, dotfiles, elixir, hammerspoon, homebrew, kitty, lua, macos, neovim, pde, qmk, surfingkeys, tmux, weechat, zk, zmk, zsh
- Language: Lua
- Homepage: https://megalithic.io
- Size: 43.7 MB
- Stars: 171
- Watchers: 7
- Forks: 8
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
```sh
┌┬┐┌─┐┌─┐┌─┐┬ ┬┌┬┐┬ ┬┬┌─┐
│││├┤ │ ┬├─┤│ │ │ ├─┤││
┴ ┴└─┘└─┘┴ ┴┴─┘┴ ┴ ┴ ┴┴└─┘
@megalithic 🗿
```
## 🚀 Installation
_If you want to kick the tires, you can simply:_
```bash
git clone https://github.com/megalithic/dotfiles.git ~/.dotfiles && cd ~/.dotfiles && make install
```
_If you want to update an existing installation:_
```bash
make -C ~/.dotfiles up
```
_For platform specific installations:_
```bash
cd ~/.dotfiles && make macos # or, `linux`
# or, for easier use:
make -C ~/.dotfiles macos
```
_Get some help:_
```bash
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 `
---
This dotfiles repo is managed by
[dotbot](https://github.com/anishathalye/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:
- [ghostty](https://github.com/ghostty-org/ghostty)
- [homebrew](https://brew.sh/)
- [mise](https://github.com/jdx/mise)
- [tmux](https://github.com/tmux/tmux/wiki)
- [zsh](https://www.zsh.org/)
- [neovim](https://github.com/neovim/neovim)
- [weechat](https://www.weechat.org/)
- `megaforest` for all the colours/themes
- [jetbrains mono](https://www.jetbrains.com/lp/mono/) font
([nerd-fonts](https://github.com/ryanoasis/nerd-fonts#font-patcher) patched)
- [hammerspoon](https://github.com/megalithic/dotfiles/tree/main/config/hs)
- [karabiner-elements](https://github.com/tekezo/Karabiner-Elements)
([leeloo ZMK](https://github.com/megalithic/zmk-config))
- [gpg/yubikey/encryption](https://github.com/drduh/YubiKey-Guide)
- `vim`-esque control
- [surfingkeys (in-browser)](https://github.com/brookhong/Surfingkeys)
- [homerow (macos-wide)](https://homerow.app)
