Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
The App Engine server, written in Python
Python JavaScript
branch: master
Failed to load latest commit information.
js A couple of JS fixes for the stats dashboard.
.gitignore Updated README. Removed some junk files. Added a gitignore. Updated A…
LICENSE.md Updated README and moved LICENSE to have the Markdown extension.
README.md Updated links in README.
app.yaml Removed appstats. Fixes #20.
auth.py Applied PEP8 to all python files.
bulkloader.yaml Added a bulkloader file. Also updated the set quota page to stop erro…
channels.py Much smarter sending of links; will prevent the backlog overflow situ…
cron.yaml Added a cron job to set stats to 0 for the hour/day, so we get datapo…
dashboard.html Fixed a bug that would increment totals twice on the stats page.
devlinks.py Added new API endpoint for Android to check its time against.
devlinks_index.html Updated devlinks_index.html to allow links to be marked as read. Conf…
error.html Added custom templates for errors. Will allow clients to respond to e…
hard_quota.html Added custom templates for errors. Will allow clients to respond to e…
index.yaml Limited the number of results shown on the stats dashboard.
models.py Finally worked out the bugs in active users. Fixes #40.
queue.yaml Added a stats system in the background that will silently collect usa…
quota.html Added a datastore model for the quota, along with some convenience me…
stats.py Created a timestamp library to convert everything to Pacific time, so…
subscribe.html Added a stats system in the background that will silently collect usa…
timestamp.py Created a timestamp library to convert everything to Pacific time, so…

README.md

2cloud App Engine Server

About

2cloud is a free, decentralised, open source project to try and make sharing content between browsers and devices as seamless and effortless as possible. An up-to-date list of devices and browsers supported by the project is available at http://www.2cloudproject.com/clients

This is the App Engine software that powers our public server at https://2cloudapp.appspot.com. We provide it here as a reference for implementing your own server software for the project and as a plug and play package for users who want to host their own servers, but don't necessarily want to write their own server.

Installation Instructions

We tried to make installation as streamlined as possible. You just need to download the source (use git, or the download button) and change the identifier in app.yaml. Then use the App Engine SDK to sync it just like you normally would.

Where to Get Help

We try to maintain a presence with our users. To wit, we have:

If you don't use any of those... you're kind of out of luck.

Contribution Guidelines

The quickest, easiest, and most assured way to contribute is to be a beta tester. Simply join the mailing list and wait for a new beta to be released. Try and break it. Submit feedback. Wash, rinse, repeat.

If you're interested in contributing code, we use different guidelines for each part of our app. This is driven by necessity; you can't use PEP-8 on Java, for example. Our App Engine guidelines are simple:

  • If possible, have unit tests written for what you're patching
  • Explain clearly in your pull request what you're patching and why
  • Make sure your code follows the style laid out in PEP-8

That's pretty much it. We're laid back. The best way to figure out what's on our to-do list is to look at the issue tracker or ask on the dev mailing list. Whatever you work on should be something you want to see implemented, though.

Contributors

2cloud is an open source application. It is technically "owned" by Second Bit LLC, but all that really means is they take care of the mundane administrative and financial stuff. The team behind 2cloud is separate from the Second Bit team (despite some overlap). The 2cloud team is as follows:

They're pretty friendly. Please do get in touch!

Credits and Alternatives

One of the great parts about being an open source project is how often we get to stand on the shoulders of giants. Without these people and projects, we couldn't do what we do.

  • blog.notdot.net (basis of stats system)
  • docs.python.org (basis of timestamp.py)
  • jQuery (Stats dashboard)
  • Chrome to Phone (Inspiration)

There are some alternatives to 2cloud out there, and we encourage you to try them out. Use what works best for you. You can find an up-to-date list on our website.

Something went wrong with that request. Please try again.