BTSender 1.1.0
Author: | Arve Barsnes/Sander Johansen |
---|---|
Contact: | arveba/[email protected] |
BTSender is a package that will act as an automatic file pusher that sends a list of files to any detectable BlueTooth devices in the vicinity.
There are three required libraries to use this package, BlueZ [bluez], PyBlueZ [pybluez] and openobex [openobex].
Unpack the file. This is typically accomplished by running:
$ tar -xzf <archive-name>
Enter the generated directory, and then run this:
$ python setup.py install
The package will be installed to ~/BTSender
The shell around the core sending functions is implemented in Python, while the actual sending, which uses the obex protocol, is mostly ripped directly from ussp-push [ussp-push], only slightly rewritten to allow it to be called directly from within python, and other small changes to accomodate the wanted functionality.
The package is easy to use. All you have to do is go to the installation-directory (~/BTSender). There you type:
$ ./start.sh
This will setup an important environment variable so the program will find the libraries, and start BTSender.
Once running, it will search for any nearby BlueTooth devices and send them the files. Any files in the files subdirectory will be pushed out, so if there are files in there you don't want to send they will have to be deleted or moved out. Likewise, if there are new files you want to push out, put them in this directory, and all detected devices will get this file as well.
Running the unit tests should be a simple matter of running:
$ python unittests.py
Although, if you haven't already run the program beforehand, you should setup the variable that the start.sh script does. To do this manually, simply type:
$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib
An HTML version of the documentation in this file may be produced using docutils, like this:
$ rst2html README >README.html
or a LaTeX version like this:
$ rst2latex README >README.tex
The latest version of this library should be available at http://folk.uio.no/sanderj/btsender/BTSender-latest.tar.gz
BTSender by Arve and Sander ( Bluetooth Sender ) Copyright (C) 2006 Arve Barsnes and Sander Johansen
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Sander Johansen <[email protected]> Arve Barsnes <[email protected]>