Metadata-Version: 2.5
Name: talos-bar
Version: 0.0.1
Summary: Cross-platform desktop bar (PySide6 + QML) extended with Python glue
License-Expression: BSD-3-Clause
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: pyside6-essentials>=6.7
Description-Content-Type: text/markdown

# talos-bar

A cross-platform desktop bar (Linux, Windows, macOS) for the Talos HQ setup.
It replaces the KDE Plasma top panel defined in `~/dev/nixos`, so the same
bar follows us onto any machine.

- UI: PySide6 (Qt 6, LGPLv3) + QML, GPU-rendered by Qt Quick
- Logic: plain Python, so agents can iterate without a compile step
- Glue: drop a Python file in `glue/` to add bar items, timers and click
  handlers, with hot reload. This is the main way agents extend the bar.
- Platform docking: one small module per OS (layer-shell, AppBar, NSPanel)

Status: design phase. See:

- [docs/DESIGN.md](docs/DESIGN.md) — architecture and decisions
- [docs/MIGRATION.md](docs/MIGRATION.md) — moving the NixOS panel widgets here

## Development

```sh
uv sync
uv run talos-bar            # run the bar
uv run ruff check . && uv run ruff format --check .
uv run basedpyright         # strict mode
uv run pytest
```

Glue lives in `src/talos_bar/glue/builtin/` and `~/.config/talos-bar/glue/`.
Edit a glue file while the bar runs and it reloads.

On NixOS the PyPI PySide6 wheel needs system libraries (libstdc++, zlib,
krb5, xcb-*) on `LD_LIBRARY_PATH`; a Nix dev shell for this is still to do.
