Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

open source, self-hosting CloudApp

tree: b5491d6e63

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 doc githubflavoredmarkdown August 27, 2012
Octocat-spinner-32 regenwolken
Octocat-spinner-32 specs
Octocat-spinner-32 .gitignore add .gitignore August 27, 2012
Octocat-spinner-32 LICENSE.txt added LICENSE.txt November 18, 2011
Octocat-spinner-32 MANIFEST.in
Octocat-spinner-32 README.md
Octocat-spinner-32 regenwolken.cfg use port 3000 as default, 5000 is used by Jabber August 27, 2012
Octocat-spinner-32 setup.py
Octocat-spinner-32 tox.ini add py26 to tox July 29, 2012
README.md

regenwolken – an open source CloudApp server

Cloud.app is really handy, sharing files was never that easy. But I don't like to see (personal) data like screenshots or code snippets go out of my reach. Regenwolken is a full-featured implementation of the Cloud App API with one malus: you have do edit your /etc/hosts.

open server

I've set up a server open for everyone. Simply, add 213.218.178.67 my.cl.ly to your /etc/hosts. Items older than three days will be purged at midnight (only a small vserver). Happy testing!

Quickstart

Short instructions for OS X, adapt these commands to your linux distribution of choice (Debian Squeeze!).

$ brew install mongodb
$ mongod --dbpath foo/ &

Now install regenwolken and its dependencies:

$ easy_install regenwolken
$ easy_install pygments PIL markdown  # optional

Modify /etc/hosts, launch regenwolken and register a new account

$ sudo echo "127.0.0.1 my.cl.ly" >> /etc/hosts
$ regenwolken &
[... open Cloud.app or another client and register a new account]
$ rwctl activate USERNAME

You can change that behavior to instantly activate new users. See the configuration part below.

How to use regenwolken

As an alternative CloudApp-server, you have to edit their DNS my.cl.ly to point to your own IP. This will not interfere with CloudApp Service itself, because they are using cl.ly and f.c.ly for sharing.

$ sudo echo "12.34.56.78 my.cl.ly" >> /etc/hosts

Note: you should set a hostname (= your domain) in regenwolken.cfg. This will return into customized URLs, pointing directly to your host, so others don't need to modify their hosts.

Setup and Configuration

See DEPLOYMENT.md and CONFIG.rst for details.

API implementation

regenwolken provides all API calls to get Cloud.app working and has only few calls of CloudApp's API missing. See API.md for a complete list of features. Below, the following are currently covered by the web interface.

# -H "Accept: text/html"

/                          - GET basic web interface
/items/<short_id>          - GET file or redirect from bookmark
/items/<short_id>/filename - GET same as /items/<short_id>
/<short_id>                - GET viso-like file view or redirect from bookmark
/thumb/<short_id>          - GET thumbnail of item

Thanks to cmur2 for his feature-rich CLI (with HTTPS support!) and help to build this service!

Clients

If you are working on a API or Client for CloudApp, please consider a configurable service url. That makes the hosts file hack unnecessary and as a side effect you can use HTTPS for all connections (feature is still in master).

working

  • Mac OS X Cloud.app
  • Cloudette – free CloudApp iPhone client, works flawlessly
  • BlueNube – 1,99$ iPad client
  • Stratus – CloudApp Client for iOS (iPhone/iPad); add 127.0.0.1 ws.pusherapp.com to /etc/hosts as well.
  • cloudapp-cli – commandline tool
  • JCloudApp – cross-platform Cloud.app widget in Java (supports HTTPS with regenwolken!)
  • gloudapp – linux+GTK-based client

failing clients

Links:

Something went wrong with that request. Please try again.