CLI tool for converting articles to podcasts
Project description
Article to Podcast
CLI tool for converting articles to podcasts using OpenAI's Text-to-Speech API.
Development
If you're using Nix you can start running the tool by entering:
nix develop
Usage
python -m article_to_podcast --help
Usage: python -m article_to_podcast [OPTIONS]
Options:
--url TEXT URL of the article to be fetched.
[required]
--directory DIRECTORY Directory where the output audio file will
be saved. The filename will be derived from
the article title. [required]
--audio-format [mp3|opus|aac|flac|pcm]
The audio format for the output file.
Default is mp3.
--model [tts-1|tts-1-hd] The model to be used for text-to-speech
conversion.
--voice [alloy|echo|fable|onyx|nova|shimmer]
The voice to be used for the text-to-speech
conversion. Voice options: alloy: A
balanced and neutral voice. echo: A more
dynamic and engaging voice. fable: A
narrative and storytelling voice. onyx: A
deep and resonant voice. nova: A bright
and energetic voice. shimmer: A soft and
soothing voice. Experiment with different
voices to find one that matches your desired
tone and audience. The current voices are
optimized for English.
--help Show this message and exit.
export OPENAI_API_KEY="your-api-key"
python \
-m article_to_podcast \
--directory . \
--url 'https://blog.kubetools.io/kopylot-an-ai-powered-kubernetes-assistant-for-devops-developers'
python \
-m article_to_podcast \
--model tts-1-hd \
--voice nova \
--directory . \
--url 'https://blog.kubetools.io/kopylot-an-ai-powered-kubernetes-assistant-for-devops-developers'
Testing
If you used nix develop
all necessary dependencies should have already
been installed, so you can just run:
pytest
TODO
- Automatically fetch filename to save article from the article name
- Remove redundant warnings in pytest
- Make sure pytest shows quota errors
Inspired by
- Long frustration of unread articles
- https://github.com/simonw/ospeak
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
article_to_podcast-0.1.tar.gz
(5.6 kB
view hashes)
Built Distribution
Close
Hashes for article_to_podcast-0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 23222777bb55329065cc275c246e8150b73c38cefacb45bbc18ede30de316bc3 |
|
MD5 | cf5fde755aabfd530658b2a44c65d46b |
|
BLAKE2b-256 | 9ceed801df6ea0cff4e669e94562e5f291e0893afc4ce126ff6e11517bb1ec09 |