An open API service indexing awesome lists of open source software.

https://github.com/peterhajas/dotfiles

If you see a setting, they blew it
https://github.com/peterhajas/dotfiles

Last synced: 3 months ago
JSON representation

If you see a setting, they blew it

Awesome Lists containing this project

README

          

# phajas dotfiles

## rocking since 2014

A "dotfile" is a configuration file for a computer program.

I have a bunch of these. They all live here.

## Install

1. Clone this repository into your home directory:

cd
git clone https://github.com/peterhajas/dotfiles.git

2. Go to the `dotfiles` directory:

cd dotfiles

3. Run `update.sh`. You may need to give it proper permissions:

cd dotfiles
chmod a+x update.sh
sh update.sh

## Colors

- Colors live at `colors/palette.toml` (TOML).
- Regenerate terminal/Neovim artifacts (Ghostty themes + `phajas_palette` colorscheme) with `python3 colors/build.py` (run automatically by `setup.yml` before stow).
- Per-machine stow overrides in `setup.yml` do not affect palette generation; the build step always runs so any hosts that stow Ghostty/Neovim get the fresh colors. Host-specific defaults are supported via `[hosts.]` in `colors/palette.toml`, e.g.:

[hosts.nyx]
default_variant = "modus_vivendi"

- Light/dark: both variants are always generated. Ghostty points `theme = dark:phajas_dark,light:phajas_light` (stable names, independent of the variant keys), and Neovim chooses the variant by macOS appearance; host overrides only change the default when no flavor match is found.
- Extend to other apps by adding outputs inside `colors/build.py` alongside the Ghostty and Neovim writers.
- Neovim always loads the generated `phajas_palette` (see `nvim/.config/nvim/lua/phajas/plugins/theme.lua`); macOS appearance is polled to pick light/dark.
- Licensing: palette and generated artifacts are GPL v3 via Modus; the license text lives at `colors/LICENSE`.

That's it! If you had any configuration files, `stow` should leave them alone and not stomp on them. If you'd like to uninstall specific apps, you can do so by running `stow -D APPNAME` in the `dotfiles` directory. To install them again, run `stow APPNAME`.

## Third-Party Components

This repository includes the following GPL-licensed components:

- **Modus** by Miika Nissi (adapted from Protesilaos Stavrou)
- Palette data: `colors/palette.toml` contains Modus-derived values; all generated artifacts from it (Ghostty themes, `phajas_palette` Neovim colorscheme, and any other outputs you add) inherit GPL v3 obligations.
- Location: generated Ghostty themes (`ghostty/.config/ghostty/themes/phajas_light` and `ghostty/.config/ghostty/themes/phajas_dark`) plus the Neovim colorscheme (`nvim/.config/nvim/colors/phajas_palette.lua`)
- License: GPL v3 (see `colors/LICENSE`; keep that file with any redistribution of the palette or generated artifacts)
- Source: https://github.com/miikanissi/modus-themes.nvim

## License

Third-party components retain their original licenses as indicated in their respective directories.

---

Questions? Comments? `emacs`? I'm [@peterhajas](http://twitter.com/peterhajas).