source code for Fluid Nexus mobile and desktop applications http://fluidnexus.net
Find a file
2011-11-14 02:39:39 -05:00
archive -- some housecleaning 2011-06-22 19:58:17 -04:00
debian -- updating changelogs 2011-11-14 02:39:39 -05:00
FluidNexus -- new version with direct SSL support 2011-11-14 02:37:40 -05:00
l10n -- updating TODO, translations 2011-08-09 04:09:43 -04:00
S60 -- adding todo list 2011-06-22 20:13:33 -04:00
scripts -- updating for new release 2011-08-16 21:42:14 -04:00
share -- updating for new version, 0.3.0 2011-11-14 00:13:09 -05:00
.gitignore -- adding .gitignore 2011-06-18 19:45:13 -04:00
AUTHORS -- Adding copyright notices 2008-03-20 22:41:28 +00:00
CHANGES.rst -- updating changelogs 2011-11-14 02:39:39 -05:00
FluidNexus.py -- working on updating distribution for packaging in a PPA 2011-08-07 15:41:26 -04:00
FluidNexusApp.py -- adding support for building on OS X 2011-08-05 17:30:51 -04:00
generateProtos.sh -- adding/editing messages with attachments works now; starting on 2011-06-23 16:34:16 -04:00
generateTS.sh -- adding translation generation script 2011-07-27 11:30:45 -04:00
generateUI.sh -- UI works for viewing different types of messages...now for UI to 2011-06-25 17:21:16 -04:00
LICENSE -- adding gpl license file 2011-07-31 17:14:36 -04:00
Makefile -- new packaging for creation of desktop menu item and icons 2011-08-08 04:20:30 -04:00
MANIFEST.in -- new packaging for creation of desktop menu item and icons 2011-08-08 04:20:30 -04:00
README.rst -- updating for new version, 0.3.0 2011-11-14 00:13:09 -05:00
RELEASE.rst -- updating manual info, creating new release 2011-08-16 19:47:37 -04:00
setup.cfg -- working on updating distribution for packaging in a PPA 2011-08-07 15:41:26 -04:00
setup.py -- new packaging for creation of desktop menu item and icons 2011-08-08 04:20:30 -04:00
TODO -- updating manual info, creating new release 2011-08-16 19:47:37 -04:00

Fluid Nexus
===========

Nicholas A. Knouf

http://fluidnexus.net

fluidnexus@fluidnexus.net

The software has been testing on Ubuntu Maverick with python 2.6.6 and requires the following python modules: pyqt4, pybonjour, sqlalchemy, textile, pybluez, oauth2, protobuf (version 2.3.0 or higher).

Installing on Ubuntu
--------------------

Installation on Ubuntu requires a number of packages which can be installed using ``sudo apt-get apt-get install python-bluez python-qt4 pyqt4-dev-tools python-protobuf libavahi-compat-libdnssd1``.  Other distributions will need their equivalent.  The code should work on python 2.5, but this hasn't been tested.

Installing on Windows
---------------------

The setup file below will install all of the needed packages, including the python interpreter.  It's recommended to use this instead of download the source code, unless you know what you are doing.


Specific network modality notes
-------------------------------

Bluetooth
+++++++++

* Has been tested to work on Windows XP and Windows 7 using a dlink DBT-120 USB bluetooth adapter, the Windows bluetooth drivers, and pybluez.

* Will not run on OS X due to lack of pybluez; the networking code will have to be ported to lightblue

* Works on Linux using pybluez.

Zeroconf
++++++++

* Has been tested to work on Windows XP with Bonjour for Windows installed.  You may have to allow UDP port 5353 (for zeroconf) through your firewall.

* Should run without modification on OS X if pybonjour is installed; this has not been tested

* Linux will require the installation of a avahi-bonjour compatability library; on ubuntu this is libavahi-compat-libdnssd1.

To run, type "fluid-nexus"; for help, type "fluid-nexus --help".

SECURITY NOTE
=============

Data is stored unencrypted in a local sqlite database.  It is best that you take care of encryption yourself, such as by using ecryptfs home directories or LUKS encrypted devices on Linux.  On Windows, the database and received attachments are stored in the ``FluidNexusData`` folder in your home directory.  It ought to be possible to mount this folder from a TrueCrypt volume.

Data is sent over Bluetooth using the standard encryption facilities of the Bluetooth stack.

Data is sent over link-local wifi using zeroconf for service discovery without any transport layer encryption.

Licenses
========

Fluid Nexus is currently licensed under the GPLv3.

MultipartPostHandlerUnicode.py is licensed under the LGPL and downloaded from http://peerit.blogspot.com/2007/07/multipartposthandler-doesnt-work-for.html