Metadata-Version: 1.1
Name: regenwolken
Version: 0.6.1
Summary: open source, self-hosting CloudApp
Home-page: http://pypi.python.org/pypi/regenwolken/
Author: posativ
Author-email: info@posativ.org
License: BSD revised
Description: # regenwolken – an open source CloudApp server
        
        [Cloud.app][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](https://github.com/posativ/regenwolken/blob/master/doc/DEPLOYMENT.md) and
        [CONFIG.rst](https://github.com/posativ/regenwolken/blob/master/doc/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](http://developer.getcloudapp.com/) missing. See
        [API.md](https://github.com/posativ/regenwolken/blob/master/doc/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](https://github.com/cmur2) for his feature-rich
        [CLI](https://github.com/cmur2/cloudapp-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][app]
        - [Cloudette](http://cloudetteapp.com/) – free CloudApp iPhone client, works flawlessly
        - [BlueNube](http://bluenubeapp.com/) – 1,99$ iPad client
        - [Stratus](http://www.getstratusapp.com/) – CloudApp Client for iOS (iPhone/iPad); add `127.0.0.1 ws.pusherapp.com` to /etc/hosts as well.
        - [cloudapp-cli](https://github.com/cmur2/cloudapp-cli) – commandline tool
        - [JCloudApp](https://github.com/cmur2/jcloudapp) – cross-platform Cloud.app widget in Java (supports HTTPS with regenwolken!)
        - [gloudapp](https://github.com/cmur2/gloudapp) – linux+GTK-based client
        
        ### failing clients
        
        - Windows' [FluffyApp](http://fluffyapp.com/), fails to login
        
        ## Links:
        
        - [rixth/raincloud](https://github.com/rixth/raincloud) – a (full?) cloud
          implementation written in node.js
        - [short description in my blog](http://blog.posativ.org/2011/regenwolken-hosting-cloudapp-on-your-own-server/)
        
        [app]: http://itunes.apple.com/us/app/cloud/id417602904?mt=12&ls=1
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
