Dev v0.1.17

README.md

@@ -52,6 +52,8 @@ software timestamps alone.
   - `GLSystemText` (backward-compatible explicit name for `Text`).
 - Psychophysics helpers (`make_gabor`, gratings, normalization, dithering).
 - Audio playback utility (`Audio`) backed by `tachyaudio`.
+- Optional Wooting analog-keyboard integration (`tachypy[wooting]`): on-screen
+  pressure feedback and `WOOTING_ACQUISITION` straight from `tachypy`.
 - Test suite for core logic and regressions.
 
 ## Installation
@@ -79,10 +81,26 @@ Optional extras:
 
 ```bash
 pip install -e ".[test]"        # pytest
-pip install -e ".[text]"        # Pillow text fallback
-# Audio support (tachyaudio) is included in the base install
+pip install -e ".[wooting]"     # Wooting analog-keyboard integration
+# Pillow, FreeType, HarfBuzz, GLFW, and audio are included in the base install
 ```
 
+### Wooting analog-keyboard integration
+
+`pip install "tachypy[wooting]"` adds support for Wooting analog keyboards
+(pressure acquisition, logging, and on-screen visual feedback):
+
+```python
+from tachypy import Screen, WOOTING_ACQUISITION
+
+acq = WOOTING_ACQUISITION(threshold=0.8)
+acq.initialize_keyboard()
+acq.wait_light_press_visual(target_keys=["c", "z"], screen=Screen(fullscreen=False))
+```
+
+See the [Wooting docs page](https://tachypy.readthedocs.io/en/latest/wooting.html)
+for details.
+
 ### Audio dependency
 
 TachyPy audio now uses `tachyaudio>=0.2.0b1`. TachyPy no longer depends on
@@ -164,7 +182,7 @@ TACHYPY_FONT="Avenir Next, Helvetica, Arial" python example_tachypy.py
   backend-independent.
 - `GLSystemText` supports system font selection by family name, fallback list
   (e.g. `"Avenir Next, Helvetica, Arial"`), or direct font file path.
-- For production instruction text, prefer `Text` with `.[system_text]`.
+- For production instruction text, prefer `Text`.
 - The old texture-backed constructor is backbenched as `tachypy.text.LegacyText`.
 
 ## API Naming
@@ -198,6 +216,7 @@ Expanded docs live in `/docs` and include:
 - backend behavior and input routing
 - text rendering options
 - audio backend guidance
+- Wooting analog-keyboard integration
 - examples and contribution workflow
 
 Hosted docs (Read the Docs): https://tachypy.readthedocs.io/

docs/api.rst

@@ -34,3 +34,13 @@ Core modules
 
 .. automodule:: tachypy.psychophysics
    :members:
+
+Wooting pressure feedback
+-------------------------
+
+Keyboard-agnostic visual feedback toolkit (see :doc:`wooting`). These modules
+never import a keyboard package; they render feedback for any object satisfying
+:class:`tachypy.feedback.PressureSource`.
+
+.. automodule:: tachypy.feedback
+   :members:

docs/getting_started.rst

@@ -27,8 +27,10 @@ Optional extras
 .. code-block:: bash
 
    pip install -e ".[test]"        # pytest, coverage, lint tooling
-   pip install -e ".[text]"        # Pillow text fallback
-   # Audio support (tachyaudio) is included in the base install
+   pip install -e ".[wooting]"     # Wooting analog-keyboard integration
+   # Pillow, FreeType, HarfBuzz, GLFW, and audio are included in the base install
+
+See :doc:`wooting` for the Wooting analog-keyboard integration.
 
 Minimal loop
 ------------

docs/index.rst

@@ -13,6 +13,7 @@ abstractions for display/input, and helper utilities for experiment workflows.
    timing_validation
    text_rendering
    audio
+   wooting
    examples
    contributing