Metadata-Version: 2.4
Name: hueman-cli
Version: 0.3.1
Summary: Centralized theme manager: one YAML palette feeds Jinja2 templates that generate each tool's config.
Author: 4DRIAN0RTIZ
License-Expression: MIT
Project-URL: Homepage, https://hueman.cuevaneander.tech
Project-URL: Source, https://github.com/NeanderTeam/hueman
Project-URL: Issues, https://github.com/NeanderTeam/hueman/issues
Keywords: theme,colors,palette,dotfiles,jinja2,terminal,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Jinja2>=3.1.6
Requires-Dist: PyYAML>=6.0.1
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

<p align="center">
  <img src="website/assets/img/logo.png" alt="hueman" width="128" />
</p>

<h1 align="center">hueman</h1>

<p align="center"><strong>One palette. Every tool.</strong></p>

<p align="center">
One theme for your terminal, editor, prompt, and the rest of your setup.<br />
You say which file each app uses, and one command paints them all.<br />
Not a dotfiles manager: output paths live in your own <code>hueman.config.yaml</code>,
outside this repo.
</p>

## Quickstart

```sh
pipx install hueman-cli                               # or: pip install hueman-cli
hueman init                                           # sample config → ~/.config/hueman/config.yaml
# point targets/outputs at your paths, then:
hueman set <palette> --dry-run
hueman set <palette>
```

From source (Python >= 3.9):

```sh
git clone https://github.com/NeanderTeam/hueman.git
cd hueman && pip install -e .
```

Upgrade: `pipx upgrade hueman-cli` (or `pip install -U hueman-cli`).  
Uninstall: `pipx uninstall hueman-cli` (or `pip uninstall hueman-cli`); your
config and generated files are left alone (details in the
[install guide](https://hueman.cuevaneander.tech/?p=install)).

Other commands: `init` (sample config), `list` (palettes), `status` (active
theme), `sync` (shared state across machines).

Quick reference on the machine: `hueman --help` and `hueman <command> --help`.

## Core ideas

- One palette, many targets; output mapping is declarative.
- Packaged templates and palettes are defaults; custom dirs win.
- `overwrite` for full generated files, `patch` for blocks inside hand-edited
  configs.
- Per-target `reload` and global `post_apply`, best-effort, with `warn` /
  `error` policy.
- Optional sync of the active palette across machines (`state_sync`).
- To support a new app, add a template and a target.

## Packaged tools

`hueman/palettes/` and `hueman/templates/` ship 25 generic palettes and
templates for common tools (kitty, tmux, polybar, nvim/nightfox, dunst, bspwm,
yazi, qutebrowser, rofi, fzf, atuin, oh-my-posh, wezterm, starship, Termux,
herdr, and more). For other tools, use `template_dirs` in your config instead of
asking for them to be packaged here.

## Docs

Full site: **[hueman.cuevaneander.tech](https://hueman.cuevaneander.tech)**  
(`/` = landing, `?p=intro` = docs). For flags and short examples on your
machine, use `hueman --help` / `hueman set --help` rather than a man page.

Local preview (sources under `website/`):

```sh
python3 -m http.server 8765 --directory website
```

then open `http://localhost:8765`.

## Support

Bug or idea? Open an issue at
[github.com/NeanderTeam/hueman/issues](https://github.com/NeanderTeam/hueman/issues).

## Repo layout

| Path | Contents |
|---|---|
| `hueman/cli.py` | CLI and orchestration (`hueman` command) |
| `hueman/engine/` | Config, palettes, targets, render, reload, shared state |
| `hueman/palettes/`, `hueman/templates/` | Packaged YAML palettes and Jinja2 templates |
| `hueman/data/hueman.config.example.yaml` | Commented external config example (`hueman init`) |
| `tests/` | Test suite |
| `website/` | Landing + documentation site |

The repo is self-contained: nothing inside imports code from outside itself,
except the external config each user provides. A dotfiles repo only needs
`hueman` installed and its own `hueman.config.yaml`.

## License

MIT, see [LICENSE](LICENSE).
