Metadata-Version: 2.5
Name: heinzel-theme
Version: 0.1.3
Summary: The Heinzelmännchen theme and its soundscapes.
Project-URL: Source, https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins/tree/main/plugins/heinzel-theme
Project-URL: Issues, https://github.com/helmut-hoffer-von-ankershoffen/heinzel-plugins/issues
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: heinzel<0.10,>=0.9.8
Description-Content-Type: text/markdown

# Heinzelmännchen theme

The standard Heinzelmännchen appearance and its three soundscapes: Claude FM, Die Heinzelmännchen and Hyper Focus.

Included in the standard app. It recommends its appearance when no available
theme has been selected. An explicit available theme choice is preserved, and the inactive built-in fallback is hidden
to avoid duplicate previews. Sound starts only after the person presses Play.

Select **Heinzelmännchen** in Settings → Appearance, or run `hz system theme use heinzelmaennchen`. With **Follow my
theme** enabled, its paired soundscape is Die Heinzelmännchen (`focus`). Choose any of its soundscapes manually with
`hz system sound use claude-fm`, `hz system sound use focus` or `hz system sound use hyper-focus`.

All theme values, logos, soundscape definitions, pairing and tests belong to this directory. The plugin uses public
`module.theme` and `module.soundscape` declarations. It imports no other plugin or core implementation. Disabling
or removing it restores core's fallback appearance and leaves unavailable sound choices silent.

From the repository root, run `make lock`, `make check`, `make build` and `make acceptance` with `NAME=heinzel-theme`
and `CORE=<compatible-core-wheel>`. Only this plugin's environment and tests are used. New content requires no core
or parent registry change.

<!-- screenshots:start -->
## Screenshots

<img src="docs/assets/screenshots/theme-light.png" alt="A fictional Launch review contract, its configuration and run commands, in the applied Heinzelmännchen light theme." width="960">

A fictional Launch review contract, its configuration and run commands, in the applied Heinzelmännchen light theme.

<img src="docs/assets/screenshots/theme-dark.png" alt="The same fictional Launch review contract in the applied Heinzelmännchen dark theme." width="960">

The same fictional Launch review contract in the applied Heinzelmännchen dark theme.

<img src="docs/assets/screenshots/theme-soundscapes.png" alt="Demo profile: browse three optional YouTube soundscapes; playback starts only after Play." width="960">

Demo profile: browse three optional YouTube soundscapes; playback starts only after Play.

<details>
<summary>Command line</summary>

<img src="docs/assets/screenshots/theme-cli.png" alt="Demo profile: list available themes and identify Heinzelmännchen from the CLI." width="960">

Demo profile: list available themes and identify Heinzelmännchen from the CLI.

<img src="docs/assets/screenshots/soundscapes-cli.png" alt="Demo profile: list Claude FM, Die Heinzelmännchen and Hyper Focus without starting playback." width="960">

Demo profile: list Claude FM, Die Heinzelmännchen and Hyper Focus without starting playback.

</details>

[Open the screenshot gallery](docs/assets/screenshots/index.html).
<!-- screenshots:end -->
