Metadata-Version: 2.4
Name: speaking-clock
Version: 1.2.0
Summary: A clock that speaks the current time using ElevenLabs API
Author-email: Marcin Orlowski <mail@marcinorlowski.com>
License: MIT
Project-URL: Homepage, https://github.com/MarcinOrlowski/speaking-clock
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: elevenlabs>=2.0
Requires-Dist: PyYAML
Requires-Dist: python-dateutil
Requires-Dist: num2words
Requires-Dist: pydub
Requires-Dist: numpy
Requires-Dist: audioop-lts; python_version >= "3.13"
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: wheel; extra == "dev"
Requires-Dist: wemake-python-styleguide; extra == "dev"

![Speaking Clock](img/logo.webp)

# Speaking Clock

A small utility that speaks (usually current) time in specified language. Uses ElevenLabs API to
generate the speech. Supports caching and reusing audio files so free ElevenLabs access is more than
enough. Handy to sit in cron jobs to periodically announce the time.

## Features

- Gets the current time and speaks it in specified language
- Uses ElevenLabs API for high-quality text-to-speech
- Caches generated audio files for quick reuse
- Supports both 12-hour and 24-hour time formats
- Optional audio chime before speaking the time
- Parallel processing - prepares audio while chime is playing
- Overlaid audio playback with configurable timing offset
- Command-line interface driven, perfect for background jobs like [Cron](https://en.wikipedia.org/wiki/Cron)

## License

- Written and copyrighted ©2025-2026 by Marcin Orlowski \<mail (#) marcinorlowski (.) com>
- This is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)
