Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Simple program to back up Instapaper favorites in plaintext and html form.

Project Description

Python script to back up clean text and full html versions of Instapaper bookmarks. Tested on ArchLinux, should work on other distros/OSX.

## Requirements

## Installation

The recommended method of installation is via pip:

pip install instacache

This will place in your bin folder for easy access.

## Usage To use Instacache, you need an Instapaper subscription, which gives access to the full developer API as well as a consumer key and secret for OAuth. While I could conceivably ship mine with Instacache as this is an “app”, I don’t know how to keep that information secret in an open python script.

Create the file ~/.instacache/.credentials with the following contents:

[keys] consumer_key = <your consumer key> consumer_secret = <your consumer secret>

Then you can use the application as follows. After running login once, you should be fine to run backup in a crontab.

usage: instacache [-h] [-f FILE] {login,user,backup} …

Cache Instapaper articles

optional arguments:
-h, --help show this help message and exit
-f FILE, --file FILE
 File in which to store instacache information
{login,user,backup} command to issue
login login and create an oauth token user show the currently authed user backup back up instapaper articles


Instacache was a pretty quick hack job. There’s a lot of things that could be better about it: * make code cleaner, follow Python naming conventions * (test and) handle error cases * allow backup of entire instapaper list in addition to single folder * remove wget dependency * migrate to Python 3

These are all “do them if they cause problems” TODOs for me, so if they are causing you problems, create an issue or shoot me an [email](

Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
instacache-0.2.3.tar.gz (18.3 kB) Copy SHA256 Checksum SHA256 Source Sep 23, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting