Skip to main content

Medium posts as Markdown to Speech.

Project description


Build Status Python GitHub PyPI PyPI - Downloads saythanks

Medium posts to Speech.

A Python library for lazy people (like myself), who never finds time to read daily Medium posts and prefer to listen to them instead. It convert medium post to markdown using a Docker container/image then uses gTTs to interface with Google Translate's text-to-speech API which converts text to spoken MP3 files, thereafter plays the generated mp3 files with cvlc assuming it is installed.

Apt Requirements

You will need to install a few dependencies before you continue:

sudo apt install -y docker-ce mpg123 python3.6 python3.6-dev vlc


To install run:

python3 -m pip install -U medium-speech


Available arguments: -h

usage: [-h] [--play] [--cleanup] [--speed N_SPEED]
                           [--loglevel LOG_LEVEL] [--url-post MEDIUM_URL]
                           [--file MARKDOWN_FILE]

optional arguments:
  -h, --help            show this help message and exit
  --play, -p            Play generated MP3 files.
  --cleanup, -c         Cleanup generated MP3 files.
  --speed N_SPEED, -s N_SPEED
                        Play every n'th frame only ie Play speed.
  --loglevel LOG_LEVEL  log level to use, default [INFO], options [INFO,
                        DEBUG, ERROR]
  --url-post MEDIUM_URL, -u MEDIUM_URL
                        Medium post URL.
  --file MARKDOWN_FILE  Specify a Markdown file.

Listen to a Medium post: -ps 1 -u

Listen to Markdown file: -ps 1 --file

Oh, Thanks!

By the way... thank you! And if you'd like to say thanks... :)



Feel free to fork it or send me PR to improve it.

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

medium-speech-0.1.3.tar.gz (8.2 kB view hashes)

Uploaded Source

Built Distribution

medium_speech-0.1.3-py2.py3-none-any.whl (7.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page