Instaloud

Read your Instapaper saved articles aloud with Instaloud.

What is Instaloud?

Instaloud is a small program written entirely in the Hy Programming Language. It downloads your saved bookmarks from Instapaper and converts them into mp3 files using Google’s Text-to-Speech API.

Installation

Follow the instructions in the Hy documentation to install Hy.

All the code is in the file instaloud.hy. Download the dependencies specified in the Pipfile by running pipenv install (you may need to install pipenv) to get started.

Python and Hy are picky about virtual environments, so make sure it’s set up correctly.

Instaloud needs some information before it can do anything—you’ll need to get API keys/credentials from Instapaper and Google Cloud.

Create a directory called resources in the project root and then create a file called credentials.json in that directory.

Here’s what the file should look like:

{
  "client-id": "<instapaper api client id>",
  "client-secret": "<instapaper api client secret>",
  "username": "<instapaper username>",
  "password": "<instapaper password>",
  "google-auth-path": "<full path to Google Cloud authentiction credentials json file>"
}

After that, you should be good to go. You can run the program by making it executable with chmod +x, just like a Python program.

Built With

This program was built with

• Hy
• Instapaper
• Google Cloud Text to Speech
• pyinstapaper
• Google Cloud Text-to-Speech API Python client
• html2text
• pydub

Contributing

I’m new to Hy and Lisps in general so any tips to optimize the code, fix bugs, or improve this project are welcome!

License

This project is licensed under the MIT License.