Metadata-Version: 1.0
Name: hamster-rc
Version: 0.1.0
Summary: Hamster Remote Control
Home-page: http://bitbucket.org/lgs/hamster-rc/
Author: Lorenzo Gil Sanchez
Author-email: lorenzo.gil.sanchez@gmail.com
License: GPL 3
Description: .. contents::
        
        Hamster RC
        ==========
        
        Hamster RC (Remote Control) is a little web application that lets you control
        the Hamster time tracker running on your desktop from a remote browser as the
        one running on your mobile device.
        
        So far it shows the facts made the current day and lets you start and stop a
        new activity. It communicates with Hamster via DBus.
        
        I wrote it because many times I have to go here and there in the office and
        I don't spend the whole day sitting at my desk. I need to track where I spent
        my time and carrying my phone around is something I usually do anyway. I have
        my desktop IP address saved as a bookmark in my mobile browser so it's quite
        easy to access Hamster now :-)
        
        Installation
        ------------
        
        Just type::
        
          easy_install hamster-rc
        
        Remember that you need python binding for dbus installed. Unfortunately this
        is it not easy in an isolated environment such as virtualenv or buildout.
        In my preferred distribution (Fedora) this is provided by the dbus-python
        package. The rest of python dependencies (mako, webob and routes) are installed
        automatically by easy_install.
        
        Usage
        -----
        
        Once it is installed, run it like this::
        
          hamster-rc --host=192.168.0.2 --port=10000
        
        and it will listen on that IP address and TCP port. It runs on localhost:8888 by
        default, which is not very useful since you want to access it from the outside.
        
        Now, point your browser to http://192.168.0.2:10000 and just click on the buttons!
        
        Development
        -----------
        
        You can get the last bleeding edge version of hamster-rc by getting a clone of
        the Mercurial repository::
        
          hg clone https://bitbucket.org/lgs/hamster-rc
        
        Future
        ------
        
        Some features I may implement in the future are:
        
         - Simple authentication
         - HTML5 local storage support for saving the facts when you lost connection to
           the server. Later, when there is connection again, it could sync these facts
           back to Hamster.
        
        Feel free to send me patches for these and other features you would like to
        have. Other feedback is also welcomed.
        
        
        Changes
        =======
        
        0.1.0 (2011-01-23)
        ------------------
        - Initial version
        
Keywords: hamster
Platform: UNKNOWN
