Batch-add multiple URLs to your Instapaper account
Switch branches/tags
Nothing to show
Latest commit dfaa77d Nov 4, 2013 @robmiller Tidy up requires
Failed to load latest commit information.
bin Tidy up requires Nov 4, 2013
lib Tidy up requires Nov 4, 2013
.gitignore Refactoring Oct 30, 2013
Gemfile Refactoring Oct 30, 2013
LICENSE Add MIT license Apr 20, 2013 Configure as a RubyGem Mar 19, 2013
batchtapaper.gemspec Explicitly state license in Gemspec Nov 3, 2013


Got a long list of URLs that you need to get into your Instapaper account? Batchtapaper is probably what you're looking for.

You'll often encounter things like Byliner's wonderful curated end-of-year lists of articles. I want to read all of them, but I don't want to have to add each one of them to my Instapaper account manually; so, I use Batchtapaper.


You can install batchtapaper using RubyGems:

% gem install batchtapaper


The simplest way to use batchtapaper is to point it at a file containing some URLs:

% batchtapaper /path/to/urls.txt

Enter your Instapaper username and password when prompted, and it should fly away and add them one-by-one to your account.

The text file you pass to batchtapaper should have one URL on each line, like so:

However, you can also specify titles if you wish by separating them from the URLs with a tab:	An Article	A blog post

Advanced usage

Storing authentication details

If you use batchtapaper quite a lot, one of the first things you'll want to do is to create an ~/.instapaperrc file containing your authentication details. All you need to do is put your username/email address on the first line and your password — if you have one — on the second, like so:

It's worth setting this file's permissions to 400 if you share your computer with anyone else.

Integration with other services

batchtapaper will also accept input from STDIN, which means that you can use it in an ordinary chain of commands. If you've got something that spits out URLs, then simply pipe that output into batchtapaper and it will process them all:

cat urls.txt | batchtapaper