config.py

# File: config.py

"""
Centralised, typed configuration constants.
Edit just this file if you need to change locations, limits, etc.
"""

from pathlib import Path
from typing import Final

# Where raw and split recordings are stored
AUDIO_ARCHIVE_DIR: Final[Path] = Path.home() / "audio_archive"
AUDIO_ARCHIVE_DIR.mkdir(parents=True, exist_ok=True)

# Misc. paths
STATE_DIR: Final[Path] = Path.home() / ".whisper_wait"
STATE_DIR.mkdir(parents=True, exist_ok=True)
SESSION_COSTS_FILE: Final[Path] = STATE_DIR / "session_costs.json"
TRANSCRIPTIONS_FILE: Final[Path] = STATE_DIR / "last_transcriptions.txt"

# Recording / upload limits
MAX_DURATION_SEC: Final[int] = 29  # max length per Whisper call
MAX_SIZE_BYTES: Final[int] = 24 * 1024 * 1024  # 24 MB

# Model / hardware defaults
try:
    import torch  # noqa: F401

    _device = "cuda" if torch.cuda.is_available() else "cpu"
except ModuleNotFoundError:
    _device = "cpu"

DEVICE: Final[str] = _device

DEFAULT_MODEL: Final[str] = "medium.en"
AVAILABLE_MODELS: Final[list[str]] = [
    "tiny",
    "tiny.en",
    "base",
    "base.en",
    "small",
    "small.en",
    "medium",
    "medium.en",
    "large",
    "large-v2",
    "large-v3",
]

# Recording parameters
SAMPLE_RATE: Final[int] = 16_000
CHUNK_SIZE: Final[int] = 4096  # frames read from sounddevice each call

# Environment
DOTENV_PATH: Final[Path] = Path(".env")

# UI defaults
DEFAULT_AUTO_COPY: Final[bool] = True
HISTORY_PREVIEW_COUNT: Final[int] = 5