Metadata-Version: 2.4
Name: yek
Version: 0.0.2
Summary: 
License-File: LICENSE
Author: Gustavo
Author-email: github.dxabr@aleeas.com
Requires-Python: >=3.10
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.14
Requires-Dist: pynput (>=1.7.7,<2.0.0)
Requires-Dist: watchdog (>=5.0.3,<6.0.0)
Description-Content-Type: text/markdown

# yek

_Hotkeys for super-humans_

## Setup

1. Install [uv](https://docs.astral.sh/uv/).
2. `make install` (creates `.venv` and installs deps with uv).

## Development

- `make test` runs the unittest suite inside the env.
- Run examples with `./.venv/bin/python examples/open_window.py`.

Platform backends:
- macOS: uses a native listener and will open the Input Monitoring privacy pane so you can grant access.
- Linux: uses pynput; grant access if your desktop environment prompts.

> macOS/Linux may require granting keyboard monitoring/assistive access for global hotkey capture. On macOS, the app will open the Input Monitoring privacy panel to help you approve it.

## Notes on uv

- With a PEP 621 `[project]` table in `pyproject.toml`, `uv run ...` works without extra flags.
- Prefer `make install` / `make test`, or run ad-hoc commands with `uv run -- python your_script.py` if you want to override the interpreter.

