speaking-clock 1.0.0__tar.gz

speaking_clock-1.0.0/PKG-INFO

@@ -0,0 +1,248 @@
+Metadata-Version: 2.4
+Name: speaking-clock
+Version: 1.0.0
+Summary: A clock that speaks the current time using ElevenLabs API
+Home-page: https://github.com/example/speaking-clock
+Author: Marcin Orlowski
+Author-email: Marcin Orlowski <mail@marcinorlowski.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: elevenlabs
+Requires-Dist: PyYAML
+Requires-Dist: python-dateutil
+Requires-Dist: num2words
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+```
+ ▄▀▀▄                █     ▀                ▄▀▀▄ ▀█            █
+ ▀▄▄  █▀▀▄ ▄▀▀▄ ▄▀▀▄ █ ▄▀ ▀█  █▀▀▄ ▄▀▀█     █     █  ▄▀▀▄ ▄▀▀▄ █ ▄▀
+    █ █  █ █▀▀   ▄▄█ █▀▄   █  █  █ █  █     █     █  █  █ █    █▀▄
+ ▀▄▄▀ █▄▄▀ ▀▄▄▀ ▀▄▄▀ █  █ ▄█▄ █  █ ▀▄▄█     ▀▄▄▀ ▄█▄ ▀▄▄▀ ▀▄▄▀ █  █
+      █                             ▄▄▀
+
+ @project   Speaking Clock - time announcer using ElevenLabs TTS API
+ @author    Marcin Orlowski <mail (#) marcinOrlowski (.) com>
+ @copyright 2025 Marcin Orlowski
+ @license   https://www.opensource.org/licenses/mit-license.php MIT
+ @link      https://github.com/MarcinOrlowski/speaking-clock
+```
+
+# 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
+- Converts numbers to their Polish word representation (e.g., "13:05" → "trzynasta pięć")
+- 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
+
+## Installation
+
+This app is regular Python package and is also hosted
+on [PyPi](https://pypi.org/project/speaking-clock/) so
+you can install it as usual. But because this one is supposed to rather act as the application, I
+strongly recommend to use [pipx](https://pipx.pypa.io/) to install this tool in isolated
+environment be it on Linux, Windows or MacOS machines. Once you got `pipx` up
+and running, install the package:
+
+```bash
+$ pipx install speaking-clock
+```
+
+Of course, you can also use plain `pip` to do that:
+
+```bash
+$ pip install speaking-clock
+```
+
+But that might be a problem as some distributions no longer allow system-wide installations,
+therefore use of `pipx` is strongly recommended as the all-in-one solution.
+
+Once installed `speaking-clock` executable (and it's alias `speak-time`) should be available in
+your system ready to be used. Please use `--help` to see all available options.
+
+## Usage
+
+### As a command-line tool
+
+Once installed, you can use the command-line interface:
+
+```
+speak-time
+```
+
+You can specify a custom config file:
+
+```
+speak-time --config /path/to/your/config.yml
+```
+
+### Configuration
+
+The speaking-clock looks for configuration in the following places:
+
+1. Command-line specified config (if provided)
+1. User config file at `~/.config/speaking-clock/config.yml`
+1. Default configuration built into the package
+
+You can create a config file at `~/.config/speaking-clock/config.yml` with the following structure:
+
+```yaml
+language:
+  code: "pl"              # Language code matching a file in 'languages/' directory
+  use_24h_clock: true     # Use 24-hour (true) or 12-hour (false) format
+
+elevenlabs:
+  api_key: "your-api-key-here"  # Your ElevenLabs API key
+  voice_id: "voice-id-here"     # ElevenLabs voice ID
+  model_id: "eleven_multilingual_v2"  # TTS model to use
+
+audio:
+  play_chime: true        # Play a chime before speaking the time
+  chime_file: "clock-chime.mp3"  # Path to the chime audio file
+  overlay_speech: true    # Overlay speech over the chime sound
+  speech_offset_ms: 1000  # Milliseconds to wait before starting speech
+
+cache:
+  directory: ".cache"     # Directory for caching audio files
+```
+
+You can also set your ElevenLabs API key as an environment variable:
+
+```
+export ELEVENLABS_API_KEY="your-api-key-here"
+```
+
+## Language Support
+
+The application supports multiple languages through YAML language definition files. These files are stored in the `languages/` directory with filenames matching their language code (e.g., `pl.yml` for Polish).
+
+To add support for a new language:
+
+1. Create a new YAML file in the `languages/` directory (e.g., `en.yml` for English)
+1. Define the language elements following the structure in the existing language files
+1. Update the `language.code` value in `config.yml` to match your new language file
+
+Example language file structure:
+
+```yaml
+days_of_week:
+  - poniedziałek  # Monday
+  - wtorek        # Tuesday
+  # ...
+
+hours:
+  0: dwudziesta czwarta
+  1: pierwsza
+  # ...
+
+special_minutes:
+  0: ""
+  15: piętnaście
+  # ...
+
+special_times:
+  midnight: północ, nastał {day_name}
+```
+
+## Cache Files
+
+Audio files are automatically cached in the `.cache` directory using the following naming convention:
+
+```
+LANG-VOICE-HH-MM.mp3
+```
+
+For example:
+
+```
+pl-voice_id-13-05.mp3  # Polish, voice_id, 13:05
+```
+
+This caching system ensures that each unique time announcement is only generated once, reducing API calls to ElevenLabs and improving response time for frequently requested times.
+
+# Audio Support for Cron Jobs in KDE 5
+
+## Problem
+
+When running Python applications from cron jobs in KDE 5, audio playback doesn't work automatically. This is because cron jobs run in a separate environment without access to your desktop session's audio system.
+
+## Solution
+
+Configure the cron job with specific environment variables to access your KDE desktop session's audio services.
+
+### Required Environment Variables
+
+For audio playback in KDE 5, your cron job needs these key environment variables:
+
+- `DISPLAY`: Points to your X server display
+- `DBUS_SESSION_BUS_ADDRESS`: Connects to your D-Bus session
+- `XDG_RUNTIME_DIR`: Required for PulseAudio/PipeWire access
+
+### Setting Up the Cron Job
+
+Edit your crontab:
+
+```bash
+crontab -e
+```
+
+Add your job using this template:
+
+```bash
+# Run every hour at minute 0
+0 * * * * DISPLAY=:0 DBUS_SESSION_BUS_ADDRESS=$(grep -z DBUS_SESSION_BUS_ADDRESS /proc/$(pgrep -u $LOGNAME plasma-session)/environ | cut -d= -f2-) XDG_RUNTIME_DIR=/run/user/$(id -u) python /path/to/your/script.py
+```
+
+### Testing Your Configuration
+
+To test without waiting for the scheduled time:
+
+```bash
+# Test the exact command that cron will run
+DISPLAY=:0 DBUS_SESSION_BUS_ADDRESS=$(grep -z DBUS_SESSION_BUS_ADDRESS /proc/$(pgrep -u $LOGNAME plasma-session)/environ | cut -d= -f2-) XDG_RUNTIME_DIR=/run/user/$(id -u) python /path/to/your/script.py
+```
+
+## Troubleshooting
+
+### Common Issues and Solutions
+
+1. **No audio despite correct configuration**:
+
+   - Ensure PulseAudio is running: `pulseaudio --check`
+   - Try adding `PULSE_SERVER=unix:${XDG_RUNTIME_DIR}/pulse/native` to your environment variables
+
+1. **D-Bus address not found**:
+
+   - If plasma-session isn't found, try: `pgrep -u $LOGNAME plasmashell` instead
+
+1. **Permission issues**:
+
+   - Check audio group membership: `groups | grep audio`
+   - Add yourself if needed: `sudo usermod -a -G audio $USER`
+
+1. **Application-specific audio servers**:
+
+   - For PipeWire: Add `PIPEWIRE_RUNTIME_DIR=${XDG_RUNTIME_DIR}/pipewire-0`
+
+## Limitations
+
+This solution only works when:
+
+- You are logged into your KDE session
+- You are using the same user account for both KDE and the cron job

speaking_clock-1.0.0/README.md

@@ -0,0 +1,227 @@
+```
+ ▄▀▀▄                █     ▀                ▄▀▀▄ ▀█            █
+ ▀▄▄  █▀▀▄ ▄▀▀▄ ▄▀▀▄ █ ▄▀ ▀█  █▀▀▄ ▄▀▀█     █     █  ▄▀▀▄ ▄▀▀▄ █ ▄▀
+    █ █  █ █▀▀   ▄▄█ █▀▄   █  █  █ █  █     █     █  █  █ █    █▀▄
+ ▀▄▄▀ █▄▄▀ ▀▄▄▀ ▀▄▄▀ █  █ ▄█▄ █  █ ▀▄▄█     ▀▄▄▀ ▄█▄ ▀▄▄▀ ▀▄▄▀ █  █
+      █                             ▄▄▀
+
+ @project   Speaking Clock - time announcer using ElevenLabs TTS API
+ @author    Marcin Orlowski <mail (#) marcinOrlowski (.) com>
+ @copyright 2025 Marcin Orlowski
+ @license   https://www.opensource.org/licenses/mit-license.php MIT
+ @link      https://github.com/MarcinOrlowski/speaking-clock
+```
+
+# 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
+- Converts numbers to their Polish word representation (e.g., "13:05" → "trzynasta pięć")
+- 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
+
+## Installation
+
+This app is regular Python package and is also hosted
+on [PyPi](https://pypi.org/project/speaking-clock/) so
+you can install it as usual. But because this one is supposed to rather act as the application, I
+strongly recommend to use [pipx](https://pipx.pypa.io/) to install this tool in isolated
+environment be it on Linux, Windows or MacOS machines. Once you got `pipx` up
+and running, install the package:
+
+```bash
+$ pipx install speaking-clock
+```
+
+Of course, you can also use plain `pip` to do that:
+
+```bash
+$ pip install speaking-clock
+```
+
+But that might be a problem as some distributions no longer allow system-wide installations,
+therefore use of `pipx` is strongly recommended as the all-in-one solution.
+
+Once installed `speaking-clock` executable (and it's alias `speak-time`) should be available in
+your system ready to be used. Please use `--help` to see all available options.
+
+## Usage
+
+### As a command-line tool
+
+Once installed, you can use the command-line interface:
+
+```
+speak-time
+```
+
+You can specify a custom config file:
+
+```
+speak-time --config /path/to/your/config.yml
+```
+
+### Configuration
+
+The speaking-clock looks for configuration in the following places:
+
+1. Command-line specified config (if provided)
+1. User config file at `~/.config/speaking-clock/config.yml`
+1. Default configuration built into the package
+
+You can create a config file at `~/.config/speaking-clock/config.yml` with the following structure:
+
+```yaml
+language:
+  code: "pl"              # Language code matching a file in 'languages/' directory
+  use_24h_clock: true     # Use 24-hour (true) or 12-hour (false) format
+
+elevenlabs:
+  api_key: "your-api-key-here"  # Your ElevenLabs API key
+  voice_id: "voice-id-here"     # ElevenLabs voice ID
+  model_id: "eleven_multilingual_v2"  # TTS model to use
+
+audio:
+  play_chime: true        # Play a chime before speaking the time
+  chime_file: "clock-chime.mp3"  # Path to the chime audio file
+  overlay_speech: true    # Overlay speech over the chime sound
+  speech_offset_ms: 1000  # Milliseconds to wait before starting speech
+
+cache:
+  directory: ".cache"     # Directory for caching audio files
+```
+
+You can also set your ElevenLabs API key as an environment variable:
+
+```
+export ELEVENLABS_API_KEY="your-api-key-here"
+```
+
+## Language Support
+
+The application supports multiple languages through YAML language definition files. These files are stored in the `languages/` directory with filenames matching their language code (e.g., `pl.yml` for Polish).
+
+To add support for a new language:
+
+1. Create a new YAML file in the `languages/` directory (e.g., `en.yml` for English)
+1. Define the language elements following the structure in the existing language files
+1. Update the `language.code` value in `config.yml` to match your new language file
+
+Example language file structure:
+
+```yaml
+days_of_week:
+  - poniedziałek  # Monday
+  - wtorek        # Tuesday
+  # ...
+
+hours:
+  0: dwudziesta czwarta
+  1: pierwsza
+  # ...
+
+special_minutes:
+  0: ""
+  15: piętnaście
+  # ...
+
+special_times:
+  midnight: północ, nastał {day_name}
+```
+
+## Cache Files
+
+Audio files are automatically cached in the `.cache` directory using the following naming convention:
+
+```
+LANG-VOICE-HH-MM.mp3
+```
+
+For example:
+
+```
+pl-voice_id-13-05.mp3  # Polish, voice_id, 13:05
+```
+
+This caching system ensures that each unique time announcement is only generated once, reducing API calls to ElevenLabs and improving response time for frequently requested times.
+
+# Audio Support for Cron Jobs in KDE 5
+
+## Problem
+
+When running Python applications from cron jobs in KDE 5, audio playback doesn't work automatically. This is because cron jobs run in a separate environment without access to your desktop session's audio system.
+
+## Solution
+
+Configure the cron job with specific environment variables to access your KDE desktop session's audio services.
+
+### Required Environment Variables
+
+For audio playback in KDE 5, your cron job needs these key environment variables:
+
+- `DISPLAY`: Points to your X server display
+- `DBUS_SESSION_BUS_ADDRESS`: Connects to your D-Bus session
+- `XDG_RUNTIME_DIR`: Required for PulseAudio/PipeWire access
+
+### Setting Up the Cron Job
+
+Edit your crontab:
+
+```bash
+crontab -e
+```
+
+Add your job using this template:
+
+```bash
+# Run every hour at minute 0
+0 * * * * DISPLAY=:0 DBUS_SESSION_BUS_ADDRESS=$(grep -z DBUS_SESSION_BUS_ADDRESS /proc/$(pgrep -u $LOGNAME plasma-session)/environ | cut -d= -f2-) XDG_RUNTIME_DIR=/run/user/$(id -u) python /path/to/your/script.py
+```
+
+### Testing Your Configuration
+
+To test without waiting for the scheduled time:
+
+```bash
+# Test the exact command that cron will run
+DISPLAY=:0 DBUS_SESSION_BUS_ADDRESS=$(grep -z DBUS_SESSION_BUS_ADDRESS /proc/$(pgrep -u $LOGNAME plasma-session)/environ | cut -d= -f2-) XDG_RUNTIME_DIR=/run/user/$(id -u) python /path/to/your/script.py
+```
+
+## Troubleshooting
+
+### Common Issues and Solutions
+
+1. **No audio despite correct configuration**:
+
+   - Ensure PulseAudio is running: `pulseaudio --check`
+   - Try adding `PULSE_SERVER=unix:${XDG_RUNTIME_DIR}/pulse/native` to your environment variables
+
+1. **D-Bus address not found**:
+
+   - If plasma-session isn't found, try: `pgrep -u $LOGNAME plasmashell` instead
+
+1. **Permission issues**:
+
+   - Check audio group membership: `groups | grep audio`
+   - Add yourself if needed: `sudo usermod -a -G audio $USER`
+
+1. **Application-specific audio servers**:
+
+   - For PipeWire: Add `PIPEWIRE_RUNTIME_DIR=${XDG_RUNTIME_DIR}/pipewire-0`
+
+## Limitations
+
+This solution only works when:
+
+- You are logged into your KDE session
+- You are using the same user account for both KDE and the cron job

speaking_clock-1.0.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "speaking-clock"
+version = "1.0.0"
+description = "A clock that speaks the current time using ElevenLabs API"
+readme = "README.md"
+requires-python = ">=3.7"
+license = {text = "MIT"}
+authors = [
+    {name = "Marcin Orlowski", email = "mail@marcinorlowski.com"}
+]
+dependencies = [
+    "elevenlabs",
+    "PyYAML",
+    "python-dateutil",
+    "num2words",
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.scripts]
+speaking-clock = "speaking_clock.cli:main"
+speak-time = "speaking_clock.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["speaking_clock", "speaking_clock.*"]
+
+[tool.setuptools.package-data]
+speaking_clock = ["data/*.mp3", "data/defaults/*.yml", "languages/*.yml"]

speaking_clock-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

speaking_clock-1.0.0/setup.py

@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+"""
+##################################################################################
+#
+# ▄▀▀▄                █     ▀                ▄▀▀▄ ▀█            █
+# ▀▄▄  █▀▀▄ ▄▀▀▄ ▄▀▀▄ █ ▄▀ ▀█  █▀▀▄ ▄▀▀█     █     █  ▄▀▀▄ ▄▀▀▄ █ ▄▀
+#    █ █  █ █▀▀   ▄▄█ █▀▄   █  █  █ █  █     █     █  █  █ █    █▀▄
+# ▀▄▄▀ █▄▄▀ ▀▄▄▀ ▀▄▄▀ █  █ ▄█▄ █  █ ▀▄▄█     ▀▄▄▀ ▄█▄ ▀▄▄▀ ▀▄▄▀ █  █
+#      █                             ▄▄▀
+#
+# @project   Speaking Clock - time announcer using ElevenLabs TTS API
+# @author    Marcin Orlowski <mail (#) marcinOrlowski (.) com>
+# @copyright 2025 Marcin Orlowski
+# @license   https://www.opensource.org/licenses/mit-license.php MIT
+# @link      https://github.com/MarcinOrlowski/speaking-clock
+#
+##################################################################################
+#
+# python -m venv venv
+# source venv/bin/activate
+# pip install -r requirements-dev.txt
+# python -m build
+# # Reinstall the app (do not do "install --upgrade" as cached bytecode can not be updated)
+# pip uninstall --yes dist/speaking_clock-1.0.0-py3-none-any.whl
+# # intentionally no --upgrade for install to enforce conflict if not uninstalled fully first.
+# pip install dist/spaking_clock-1.0.0-py3-none-any.whl
+# twine upload dist/*
+#
+"""
+
+import os
+from setuptools import setup, find_packages
+
+# Read the contents of README.md
+with open('README.md', 'r', encoding='utf-8') as fh:
+    long_description = fh.read()
+
+setup(
+    name="speaking-clock",
+    version="1.0.0",
+    author="Marcin Orlowski",
+    author_email="info@marcinorlowski.com",
+    description="A clock that speaks the current time using ElevenLabs API",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/example/speaking-clock",
+    packages=find_packages(),
+    install_requires=[
+        'elevenlabs',
+        'PyYAML',
+        'python-dateutil',
+        'num2words',
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.7',
+    entry_points={
+        'console_scripts': [
+            'speak-time=speaking_clock.cli:main',
+        ],
+    },
+    package_data={
+        'speaking_clock': [
+            'data/*.mp3',
+            'data/defaults/config.yml',
+            'languages/*.yml',
+        ],
+    },
+    include_package_data=True,
+)

speaking_clock-1.0.0/speaking_clock/__init__.py

@@ -0,0 +1,18 @@
+"""
+Speaking Clock - A Python package that speaks the current time
+using ElevenLabs API and caches audio for reuse
+"""
+
+from .clock import SpeakingClock
+from .config import ConfigManager
+from .audio import AudioCache
+from .utils.number_converter import PolishTimeFormatter, PolishNumberConverter
+
+__version__ = "0.1.0"
+__author__ = "Carlos"
+__email__ = "carlos@example.com"
+
+# Expose main function for easy imports
+def speak_time():
+    """Main entry point to speak the current time"""
+    SpeakingClock().speak_time()

speaking_clock-1.0.0/speaking_clock/audio.py

@@ -0,0 +1,84 @@
+"""
+##################################################################################
+#
+# ▄▀▀▄                █     ▀                ▄▀▀▄ ▀█            █
+# ▀▄▄  █▀▀▄ ▄▀▀▄ ▄▀▀▄ █ ▄▀ ▀█  █▀▀▄ ▄▀▀█     █     █  ▄▀▀▄ ▄▀▀▄ █ ▄▀
+#    █ █  █ █▀▀   ▄▄█ █▀▄   █  █  █ █  █     █     █  █  █ █    █▀▄
+# ▀▄▄▀ █▄▄▀ ▀▄▄▀ ▀▄▄▀ █  █ ▄█▄ █  █ ▀▄▄█     ▀▄▄▀ ▄█▄ ▀▄▄▀ ▀▄▄▀ █  █
+#      █                             ▄▄▀
+#
+# @project   Speaking Clock - time announcer using ElevenLabs TTS API
+# @author    Marcin Orlowski <mail (#) marcinOrlowski (.) com>
+# @copyright 2025 Marcin Orlowski
+# @license   https://www.opensource.org/licenses/mit-license.php MIT
+# @link      https://github.com/MarcinOrlowski/speaking-clock
+#
+##################################################################################
+
+Audio caching functionality for the speaking clock
+"""
+
+import os
+from pathlib import Path
+from typing import Optional
+
+
+class AudioCache:
+    """Audio cache manager for speaking clock"""
+    def __init__(self, cache_dir: str, language: str):
+        self.base_dir = Path(os.path.expanduser(cache_dir))
+        self.base_dir.mkdir(parents=True, exist_ok=True)
+        self.language = language
+
+    def get_cache_filename(self, voice_id: str, hour: int, minute: int) -> str:
+        """
+        Get cache filename using the format: LANG-VOICE-HH-MM.mp3 (lowercased)
+
+        Args:
+            voice_id: ElevenLabs voice ID or name
+            hour: Hour (00-23)
+            minute: Minute (00-59)
+
+        Returns:
+            Cache filename
+        """
+        return f"{self.language}-{voice_id}-{hour:02d}-{minute:02d}.mp3".lower()
+
+    def get_cached_file_path(self, voice_id: str, hour: int, minute: int) -> Path:
+        """Get full path for a cached audio file"""
+        filename = self.get_cache_filename(voice_id, hour, minute)
+        return self.base_dir / filename
+
+    def get_cached_audio(self, voice_id: str, hour: int, minute: int) -> Optional[Path]:
+        """
+        Get cached audio file if it exists
+
+        Args:
+            voice_id: ElevenLabs voice ID
+            hour: Hour (0-23)
+            minute: Minute (0-59)
+
+        Returns:
+            Path to cached file or None if not found
+        """
+        cache_path = self.get_cached_file_path(voice_id, hour, minute)
+        return cache_path if cache_path.exists() else None
+
+    def save_audio(self, audio_data: bytes, voice_id: str, hour: int, minute: int) -> Path:
+        """
+        Save audio data to cache
+
+        Args:
+            audio_data: Audio data bytes
+            voice_id: ElevenLabs voice ID
+            hour: Hour (0-23)
+            minute: Minute (0-59)
+
+        Returns:
+            Path to cached file
+        """
+        cache_path = self.get_cached_file_path(voice_id, hour, minute)
+        with open(cache_path, 'wb') as file:
+            file.write(audio_data)
+
+        return cache_path