Got an IndieWeb site? Want to interact with federated social networks like Mastodon, Hubzilla, and more? Bridgy Fed is for you.
 
 
 
 
Go to file
Ryan Barrett dbc009b3ce minor test fixes: MagicKey id is back to domain w/o username 2017-09-12 09:29:24 -07:00
static add ostatus and activitypub logos to right of header 2017-09-03 22:50:14 -07:00
templates update host-meta templates to return webfinger/LRDD links 2017-09-12 06:39:30 -07:00
test minor test fixes: MagicKey id is back to domain w/o username 2017-09-12 09:29:24 -07:00
.gitignore minor config changes for let's encrypt certbot, stub index.html 2017-08-16 18:55:14 -07:00
README.md readme: add activitypub details for kroeg, mastodon, hubzilla 2017-09-04 18:09:15 -07:00
activitypub.py mastodon interop: salmon + activitypub + webfinger cleanup, tests 2017-09-03 13:03:31 -07:00
add_webmention.py add ?endpoint query param to /wm/ proxy 2017-08-15 12:04:38 -07:00
app.yaml minor test fixes: MagicKey id is back to domain w/o username 2017-09-12 09:29:24 -07:00
appengine_config.py mastodon interop: got webmention => salmon slap to mastodon working! 2017-09-03 12:20:37 -07:00
circle.yml start running tests on circleci 2017-08-18 16:44:35 -07:00
common.py webfinger: settle on 'me' username, just domain in paths 2017-09-12 09:07:37 -07:00
models.py use future unicode string literals, drop u qualifier 2017-09-12 07:31:18 -07:00
requirements.txt mastodon interop: got webmention => salmon slap to mastodon working! 2017-09-03 12:20:37 -07:00
salmon.py mastodon interop: salmon + activitypub + webfinger cleanup, tests 2017-09-03 13:03:31 -07:00
webfinger.py webfinger: settle on 'me' username, just domain in paths 2017-09-12 09:07:37 -07:00
webmention.py minor test fixes: MagicKey id is back to domain w/o username 2017-09-12 09:29:24 -07:00

README.md

Bridgy Fed Circle CI Coverage Status

Got an IndieWeb site? Want to interact with people on Mastodon, GNU Social, and more? Bridgy Fed is for you.

https://fed.brid.gy/

Bridgy Fed connects the IndieWeb with federated social networks using ActivityPub and OStatus:

Original design docs:

License: This project is placed in the public domain.

Development

You'll need the App Engine Python SDK version 1.9.15 or later (for vendor support) or the Google Cloud SDK (aka gcloud) with the gcloud-appengine-python and gcloud-appengine-python-extras components. Add it to your $PYTHONPATH, e.g. export PYTHONPATH=$PYTHONPATH:/usr/local/google_appengine, and then run:

virtualenv local
source local/bin/activate
pip install -r requirements.txt
python -m unittest discover

The last command runs the unit tests. If you send a pull request, please include (or update) a test for the new functionality!

If you hit an error during setup, check out the oauth-dropins Troubleshooting/FAQ section. For searchability, here are a handful of error messages that have solutions there:

bash: ./bin/easy_install: ...bad interpreter: No such file or directory

ImportError: cannot import name certs

ImportError: No module named dev_appserver

ImportError: cannot import name tweepy

File ".../site-packages/tweepy/auth.py", line 68, in _get_request_token
  raise TweepError(e)
TweepError: must be _socket.socket, not socket

error: option --home not recognized

You may need to change granary, oauth-dropins, webmention-tools, mf2util, or other dependencies as well as as Bridgy Fed. To do that, clone their repo locally, then install them in "source" mode with e.g.:

pip uninstall -y granary
pip install -e <path to granary>
ln -s <path to granary>/granary \
  local/lib/python2.7/site-packages/granary

The symlinks are necessary because App Engine's vendor module evidently doesn't follow .egg-link or .pth files. :/

To deploy to App Engine, run:

gcloud -q app deploy --project bridgy-federated *.yaml

Compatibility

Here are in progress notes on how I'm testing interoperability with various federated social networks.

ActivityPub

Salmon