mgebbe@0: # pumpbridge
mgebbe@0: 
mgebbe@0: connects pump.io to facebook and googleplus
mgebbe@0: 
mgebbe@9: THIS SOFTWARE IS A PROOF OF CONCEPT DEMONSTRATION
mgebbe@0: 
mgebbe@9: ## Features
mgebbe@9: 
mgebbe@9: ###g+ (read only)
mgebbe@0: 
mgebbe@0: * get all public posts from your circles
mgebbe@0:   and convert it to pump notes
mgebbe@0:   (text, links, pics, videos)
mgebbe@0: 
mgebbe@9: ###facebook (read / write)
mgebbe@0: 
mgebbe@9: * get facebook newsfeed including some non-public posts
mgebbe@0:   (text, links, pics, videos)
mgebbe@10:   depending on your friends privacy configuration!
mgebbe@10:   For example for those who have disabled all Platform apps 
mgebbe@10:   from accessing their data
mgebbe@10:   http://stackoverflow.com/questions/11135053/
mgebbe@0: 
mgebbe@9: * post public pump posts and public shares to facebook
mgebbe@0: 
mgebbe@0: * likes and comments to facebook related pump notes
mgebbe@0:   are synced to facebook
mgebbe@0: 
mgebbe@9: ###twitter (read / write)
mgebbe@6: 
mgebbe@9: * get all tweets and retweets of the people you're following on twitter
mgebbe@6: 
mgebbe@9: * post public pump posts and public shares to twitter
mgebbe@0: 
mgebbe@9: ###benefits
mgebbe@0: 
mgebbe@9: * share posts between networks.
mgebbe@9:   For example, you can share a post from googleplus/facebook/twitter to your followers in pump.io.
mgebbe@9: 
mgebbe@9: ##start bridging
mgebbe@9: 
mgebbe@9: * login to a remote pump.io account to get started
mgebbe@9: 
mgebbe@9: * check your pump.io id (logged in as:)
mgebbe@9: 
mgebbe@9: * login to your established social network:
mgebbe@9: 
mgebbe@9:     * Twitter:
mgebbe@9:         * click on Twitter icon
mgebbe@9:         * login
mgebbe@9:         * your account will be synced immediately
mgebbe@9:           and you got all posts within the last interval (default 15min)
mgebbe@9: 
mgebbe@9:     * Facebook:
mgebbe@9:         * click on Facebook icon
mgebbe@9:         * login
mgebbe@9:         * click save credentials
mgebbe@9:         * your account will be synced to the next interval (default 15min)
mgebbe@9:         * pumpbridge syncs your public pump.io posts you made within the last interval
mgebbe@9:         * pumpbridge syncs facebooks posts within the last interval
mgebbe@9:           (depending on timezone it differs a little bit)
mgebbe@9: 
mgebbe@9:     * Googleplus:
mgebbe@9:         * click on Google icon
mgebbe@9:         * login
mgebbe@9:         * click save credentials
mgebbe@9:         * your account will be synced to the next interval (default 15min)
mgebbe@9:         * pumpbridge syncs google posts within the last interval
mgebbe@9:           (since g+-api is read only you can not post to googleplus)
mgebbe@9: 
mgebbe@9: * click save credentials
mgebbe@9: 
mgebbe@9: * logout
mgebbe@9: 
mgebbe@9: ##stop bridging
mgebbe@9: 
mgebbe@9: * login to a remote pump.io account
mgebbe@9: 
mgebbe@9: * click on delete credentials on the specify social network
mgebbe@9:   (in certain circumstances you still see your loginname even
mgebbe@9:   if all token were deleted)
mgebbe@9: 
mgebbe@9: #Video
mgebbe@9: 
mgebbe@9: https://www.youtube.com/watch?v=SB2CGFnrnLY (older version without )
mgebbe@9: 
mgebbe@9: #SSL
mgebbe@9: 
mgebbe@9: see https://github.com/e14n/pump.io/wiki/StartSSL-Free-Certificate
mgebbe@9: 
mgebbe@9: #Bugs
mgebbe@9: 
mgebbe@9: #To-Do and wishlist
mgebbe@9: 
mgebbe@9: * sync comments from googleplus to pump.io
mgebbe@9: * sync comments from facebook to pump.io
mgebbe@9: * sync comments from pump.io to facebook
mgebbe@9: 
mgebbe@9: # License
mgebbe@0: 
mgebbe@2: Copyright (C) 2014
mgebbe@2: Intevation GmbH <intevation@intevation.de>
mgebbe@2: Neuer Graben 17, D-49074 Osnabrueck,
mgebbe@2: Germany
mgebbe@2: 
mgebbe@2: Parts from https://github.com/e14n/pump2status
mgebbe@2: Copyright 2013, E14N https://e14n.com/
mgebbe@0: 
mgebbe@0: Licensed under the Apache License, Version 2.0 (the "License");
mgebbe@0: you may not use this file except in compliance with the License.
mgebbe@0: You may obtain a copy of the License at
mgebbe@0: 
mgebbe@0: http://www.apache.org/licenses/LICENSE-2.0
mgebbe@0: 
mgebbe@0: Unless required by applicable law or agreed to in writing, software
mgebbe@0: distributed under the License is distributed on an "AS IS" BASIS,
mgebbe@0: WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mgebbe@0: See the License for the specific language governing permissions and
mgebbe@0: limitations under the License.
mgebbe@0: 
mgebbe@9: ##Authors
mgebbe@0: 
mgebbe@0: Mathias Gebbe <mgebbe@intevation.de>
mgebbe@0: 
mgebbe@9: ##Media
mgebbe@2: 
mgebbe@2: * bridge (bridge.png): http://commons.wikimedia.org/wiki/File:Bridge-stone.svg
mgebbe@2: * facebook (fb.svg): http://commons.wikimedia.org/wiki/File:F_icon.svg
mgebbe@2: * googleplus (gp.svg): http://commons.wikimedia.org/wiki/File:Google_plus.svg
mgebbe@2: * pump.io (pumpiologo.svg): https://en.wikipedia.org/wiki/Pump.io#mediaviewer/File:Pump.io.svg
mgebbe@2: * background (grey_wash_wall.png): http://subtlepatterns.com/grey-washed-wall/ (CC BY-SA 3.0)
mgebbe@2: 
mgebbe@9: ##Sources
mgebbe@0: 
mgebbe@0: The source files can be check out as follows
mgebbe@0: ```
mgebbe@0: hg clone https://hg.wald.intevation.org/pumpbridge/
mgebbe@0: ```
mgebbe@9: this software is based on https://github.com/e14n/pump2status and
mgebbe@10: uses many tools made by https://github.com/e14n/