Index of /flickr/flgrowler

 Name                    Last modified       Size  Description

 Parent Directory        23-Dec-2007 18:02      -  
 flgrowler-1.0.tar.gz    23-Dec-2007 18:05     8k  

NAME
    flgrowler - a series of Python daemons for polling Flickr and displaying
    updates with Growl notifications

SYNOPSIS
     145 ->python ./flcontacts.py  -c ~/.flickr/flgrowler.cfg
     [Tue Dec 18 23:26:52 2007][flcontacts] 00:18:99:99:30:4b is nearby
     [Tue Dec 18 23:27:10 2007][flcontacts] received 50 new events (50 total)
     [Tue Dec 18 23:27:29 2007][flcontacts] sleep for 120 seconds
     [Tue Dec 18 23:29:30 2007][flcontacts] 00:18:99:99:30:4b is nearby
     [Tue Dec 18 23:29:32 2007][flcontacts] received 3 new events (50 total)
     [Tue Dec 18 23:29:32 2007][flcontacts] sleep for 120 seconds

DESCRIPTION
    "flgrowler" is a series of Python daemons for polling Flickr and
    displaying updates with Growl notifications. It consists of three
    separate applications :

    * flactivity
        Display recent activity on your photos.

    * flcontacts
        Display recent photos from your contacts.

    * flavourites
        Display recently favorited photos from one or more of your contacts.

    If configured properly, these applications can also be made to read and
    write previously displayed items to the Intercloud, more better known as
    Amazon S3 servers, to allow for a mostly chronological and seamless
    chain of notifications between multiple machines, say work and home.

    The mostliness can be made more moster by identifying one or more
    Bluetooth devices whose proximity will be measured and used as a
    determining factor whether or not to display notification events.

    At the moment, these are strictly command-line applications that are
    driven by config files. There are no sexy UIs or helper tools. Yet.

OPTIONS
    Options are passed to flgrowler applications using an ".ini" formatted
    config file. Options are grouped by "block" matching the application's
    name.

    For example, the config file for the *flcontacts.py* application would
    be :

  flcontacts
    * api_key
        Your Flickr API key

    * api_secret
        Your Flickr API key application secret

    * auth_token
        A Flickr API auth token for a specific user (presumably you)

    * interval
        The number of seconds to wait before polling a service (Flickr, in
        this case) again

    * datastore
        Where to store data about "already seen" items. Possible values are:
        s3, default

    * storepath
        If the value of 'datastore' is default, then this should be a path
        where a new local database file can be created

    * s3_access_key
        If the value of 'datastore' is s3, a valid Amazon Web Services
        "access" key for reading and writing data from the S3 servers.

    * s3_secret_key
        If the value of 'datastore' is s3, a valid Amazon Web Services
        "secret" key for reading and writing data from the S3 servers.

    * s3_bucket_prefix
        The 's3_bucket_prefix' is required to create a uniquely named bucket
        for storing your data. For example, if your prefix was 'asc', the
        AWS S3 bucket name would be: info.aaronland.asc

        (*info.aaronland.flgrowler* is already taken.)

    * nfc_beacon_addresses
        Any number Bluetooth addresses to locate before polling a service
        (in this case Flickr). If none of the addresses listed are present
        then the application will sleep for 'interval' seconds before trying
        again.

        There is currently no support for anything other than Bluetooth
        devices.

APPLICATION SPECIFIC OPTIONS
  flavourites
    * users
        A comma separated list of Flickr screennames whose favourited photos
        should be displayed.

VERSION
    1.0

DATE
    $Date: 2007/12/19 16:53:23 $

AUTHOR
    Aaron Straup Cope <http://www.aaronland.info>

SEE ALSO
    <http://www.aaronland.info/weblog/2007/12/20/castles/#zomg>

    <http://aws.amazon.com/s3>

REQUIREMENTS
    * Growl
        <http://growl.info/>

    * Growl Python bindings
        <http://growl.info/downloads_developers.php>

    * ElementTree
        <http://effbot.org/zone/element-index.htm>

    B <boto>
        <http://code.google.com/p/boto/>

        Required for use with AWS S3

    B <pyobjc>
        <http://pyobjc.sourceforge.net/>

        Required for use with Bluetooth/NFC detection

    B *<Mac OSX 10.4> or higher
        But only for use with Bluetooth/NFC detection

NOTES
    Eventually, the *growler* base class will be moved in to a separate
    distribution.

    Given the Growl-iness of this package, OS X is also required. It
    wouldn't be very much work to add support for Windows or Linux though...

LICENSE
    Copyright (c) 2007 Aaron Straup Cope. All Rights Reserved.

    This is free software. You may redistribute it and/or modify it under
    the same terms as Perl itself.