= OBEX FTP Client for GNOME-VFS =

This package provides an OBEX FTP client for GNOME-VFS applications.
In practice, this lets you access the file system Bluetooth equipped
mobile phones and PDAs in GNOME applications such as the file manager.


== Build Requirements ==

Gnome-vfs-obexftp uses a standard autoconf based build system.  The
following additional libraries are required in order to build:

 * glib
 * gnome-vfs
 * dbus-glib
 * openobex
 * bluez-libs

With those installed, gnome-vfs-obexftp should build like any other
autoconf-based package.

Note that you should configure the same prefix and sysconfdir for
gnome-vfs-obexftp as used for gnome-vfs so that the module gets found.


== Using Gnome-vfs-obexftp ==

To use gnome-vfs-obexftp, you will need the following:

 * a supported Bluetooth adapter.
 * hcid (from bluez-utils) must be running.
 * a Bluetooth PIN agent such as bluetooth-applet (from bluez-gnome)
   should be running to handle PIN requests.

With those dependencies met, you can get a list of the paired OBEX-FTP
capable devices by pointing your file manager at the location "obex:".
From here, you can browse the file system of each of those devices.


== Pairing New Devices ==

Gnome-vfs-obexftp does not have any direct UI for pairing with new
devices.  Provided that you have a PIN agent running, the process is
fairly quick and painless.  There are two ways to begin the process:

Some phones will have a "Pair new device" menu item.  On my Nokia
6230, it is hidden here:

  Settings -> Connectivity -> Bluetooth -> Paired devices ->
  Options (with the left menu key) -> Pair new device

This will require that the computer be discoverable so the phone can
see it.

Alternatively, if you know the Bluetooth address of the phone, you can
establish a pairing by pointing the file manager at "obex://[$ADDRESS]/".

You should now be prompted to enter a PIN into both the phone and the
computer.  Provided the PINs match, the devices will be paired.


== Bug Reports ==

Gnome-vfs-obexftp uses Launchpad for bug tracking.  Bugs can be filed
at the following URL:

    https://bugs.launchpad.net/gnome-vfs-obexftp


== Hacking ==

Gnome-vfs-obexftp is developed using Bazaar.  The development tree is
hosted in Launchpad, and can be downloaded with the following commands:

    bzr get lp:~jamesh/gnome-vfs-obexftp/devel gnome-vfs-obexftp
    cd gnome-vfs-obexftp
    bzr get lp:~jamesh/gnome-vfs-obexftp/osso-gwobex

(The osso-gwobex directory is maintained as a separate branch imported
from Maemo's Subversion repository).
