https://github.com/spinda/instapaper-sender

📰 Basic HTTP gateway to save articles to Instapaper
https://github.com/spinda/instapaper-sender

email instapaper web

Last synced: 11 months ago
JSON representation

📰 Basic HTTP gateway to save articles to Instapaper

• Host: GitHub
• URL: https://github.com/spinda/instapaper-sender
• Owner: spinda
• License: agpl-3.0
• Created: 2017-02-03T22:57:00.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-02-03T23:14:26.000Z (over 9 years ago)
• Last Synced: 2024-11-28T12:52:08.469Z (over 1 year ago)
• Topics: email, instapaper, web
• Language: Haskell
• Homepage:
• Size: 25.4 KB
• Stars: 3
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

          
# instapaper-sender

*Basic HTTP gateway to save articles to Instapaper*

[![Hackage](https://img.shields.io/hackage/v/instapaper-sender.svg)](https://hackage.haskell.org/package/instapaper-sender)

[![Hackage-Deps](https://img.shields.io/hackage-deps/v/instapaper-sender.svg)](http://packdeps.haskellers.com/feed?needle=instapaper-sender)

## Intro

`instapaper-sender` provides an web server that will take URLs and send them to

Instapaper via email. This makes it easier to add articles to your reading list

from devices that lack an Instapaper app, for example, the Kindle.

Note that the web service runs ***unauthenticated***: if someone finds your

server address, they can add whatever they want to your reading list!

## Build

Install [Stack](http://haskellstack.org/) and run `stack build`.

## Usage

Obtain an email account on a service that supports SMTP with SSL (for example,

[Yandex Mail](https://mail.yandex.com)).

Copy the included `config.example.json` and fill out the settings:

```

{

  "http": {

    "port": 

  },

  "smtp": {

    "host": "",

    "port": ,

    "username": "",

    "password": "",

    "from": ""

  },

  "instapaper": {

    "email": ""

  }

}

```

All fields are mandatory. The Instapaper email address for your account can be

found on [this page](https://www.instapaper.com/save/email).

Start the server, via `stack exec -- instapaper-sender` or by setting up the

compiled executable as a daemon (see the sample

[systemd unit file](/instapaper-sender.service)).

`instapaper-sender` expects to

be forwarded requests from a reverse proxy setup like

[Nginx](http://nginx.org/) (see the sample

[Nginx configuration](/instapaper-sender.nginx)). It will look for the forwarded

IP address in the HTTP headers when producing log output.

Once you're all set up, navigate to

`http:///` to send `` to your reading

list.

## License

Copyright (C) 2017 Michael Smith <michael@spinda.net>

This program is free software: you can redistribute it and/or modify

it under the terms of the GNU Affero General Public License as

published by the Free Software Foundation, either version 3 of the

License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License

along with this program. If not, see .