Requires the TV or other device to have a Flingo-enabled application that pulls
the queue call from the Flingo backend.

* Flingo/Desktop

  Fling items from your personal computer's file system to the TV.
  Will serve the file to the TV as long as Flingo Desktop is running.

* Flingo/CommandLine
 
  Fling items from the command-line to the TV.  Will serve the file
  to the file until the command-line tools is stopped (e.g., ctrl-C). 
 

Install
=======

Download flingo.dmb from https://github.com/Flingo/Flingo/downloads
Open flingo.dmg

When presetend with a dialog

  "flingo" is an application downloaded from the Internet.
  Are you sure want to open it?

click open.  When the window opens, move flingo into Applications.


Build from source
-----------------

Obtain the source distribution from the github download page 

  https://github.com/Flingo/Flingo
  
by clicking on "Downloads" on the right-middle of the web page.
A dialog appears and presents options to download source as
a gzipped tar ball (.tar.gz) or a zip file.  Any recent verison of
Windows natively understands .zip files so download the zip file.

Alternatively checkout the latest version using git.

  http://git-scm.com

or checkout the latest version from the github repository using git. 
For example, run the following from the cmd prompt once git has been
installed:

  git clone https://github.com/Flingo/Flingo.git

If you wish to build Flingo Desktop from source, install python 2.6 or later.
Install setuptools, which can be obtained from 

  http://pypi.python.org/pypi/setuptools


Build from source for MS Windows
--------------------------------

Obtain source code as described in the steps presented in "Build from Source."

Then install py2exe from

  http://www.py2exe.org/

Then install twisted.

  http://twistedmatrix.com/trac/

Twisted requires zope.

  easy_install zope.interface

Install Qt.  I downlaoded the windows installer which includes all of
the components to build using Qt including PyQt.

  http://www.riverbankcomputing.co.uk/software/pyqt/download

From the command prompt change into the directory where you downloaded
the Flingo Desktop sources.

  cd Flingo\Desktop
  python setup.py

If py2exe fails because you do not have MSVCM90.DLL then at least as
of this writing, you can install Microsoft Visual Studio C++ Express
for free from Microsoft.  In my system the necessary DLLs were
installed in the directory  

  C:\Windows\winsxs\x86_microsoft.vc90.crt_1fc8b3b9a1e18e3b_9.0.30729.4974_none_50940634bcb759cb\


Build from source for Mac OS X
------------------------------

In my first attempt to build I used PyQT with Carbon, but when running py2app
I encountered the error:

  ...
  AttributeError: 'module' object has no attribute 'TickCount'

The suggestion at 

  http://stackoverflow.com/questions/3461983/evt-tickcount-not-found-with-python2-6-on-osx-10-6-3

is that this is a problem with the Evt module from Carbon.  One of the
suggested solutions is to use a 32-bit only Python from python.org
instead of the Apple-supplied one.  I downloaded Python 2.6.6 from python.org
and replaced the 2.6.1 installed on my system.

I was able to build flingo.org using 32-bit builds.

python 2.6.6
XCode
  xcode_3.2.2_and_iphone_sdk_3.2_final.dmg

Qt SDK
  qt-mac-carbon-opensource-4.7.1.dmg
  http://get.qt.nokia.com/qt/source/qt-mac-carbon-opensource-4.7.1.dmg

SIP
  cd sip-4.11.2/
  python configure.py --arch i386
  make
  sudo make install


PyQt
  cd PyQt-mac-gpl-4.8.1/
  python configure.py --use-arch i386
  make
  sudo make install

twisted
  sudo easy_install twisted

  This installed version 10.1.0.

qt4reactor
  http://twistedmatrix.com/trac/attachment/ticket/1770/qt4reactor.py

  Put in the directory Flingo/Desktop in the repo.

  I included qt4reactor in the repo for fear that this version might
  disppear given that it isn't part of a versioned distribution but just
  an attachment to a ticket.

py2app

  sudo easy_install py2app

I ran into a couple of problems when building py2app:

   ...
   IOError: [Errno 2] No such file or directory: '/Library/Python/2.6/site-packages/py2app-0.5.2-py2.6.egg/py2app/apptemplate/prebuilt/main-i386'
 > /System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/shutil.py(52)copyfile()
 -> fsrc = open(src, 'rb')
 
I tried to install py2app from source, but I got a new error:
 
   File "/Library/Python/2.6/site-packages/setuptools-0.6c11-py2.6.egg/setuptools/package_index.py", line 475, in fetch_distribution
 AttributeError: 'NoneType' object has no attribute 'clone'
 
 Searching on the web shows that this issue was closed 
 
   http://bugs.python.org/setuptools/issue90
 
 But the fix was supposedly in 0.6c12.  So I downloaded the 0.6c12dev version:
 
   setuptools-0.6c12dev_r85334-py2.6.egg
 
I then tried to reinstall py2app which revealed the requirement for 
a newer version of modulegraph:

  error: Could not find suitable distribution for Requirement.parse('modulegraph>=0.8.1')

easy_install modulegraph installed 0.8 which is clearly <0.8.1, so I 
cloned the Mercurial repo 

  hg clone http://bitbucket.org/ronaldoussoren/modulegraph

and installs as 0.8.2.

Now py2app installs.

Switched back to the Flingo repository:  Flingo/Desktop

  python setup.py py2app

This successfully creates dist/flingo.app.  

  cd dist
  open flingo.app

Success!
 
As an aside, I converted Mac flingo.icns to Windows flingo.ico using 
http://iconverticons.com.