General

About SyncBlue

SyncBlue is a cross-platform program that allows file and folder synchronization via Bluetooth. It is open source and published under the GNU General Public License.

Compatible target devices

Target device compatibility is platform-independent; it is, in principle, possible to connect to Bluetooth-enabled devices of any operating system. However, the target device must support Bluetooth pairing and the OBEX File Transfer protocol. Note: Windows computers support OBEX File Transfer but do not advertise (broadcast) it. To synchronize with a Windows machine, install SyncBlue on it and run it in Server Mode.

Microsoft Windows

System requirements

Windows 7 or higher (64-bit).

Installation

Download the installer. Run it and follow the instructions on the screen.

Usage & options

Connecting to a device

Most (but not all) target devices will only accept an incoming Bluetooth connection if the device has been paired with your computer. Therefore, before you attempt to establish a connection through SyncBlue, ensure that your computer and your device are paired. Most often though, you will be prompted to pair automatically when attempting to sync with SyncBlue. Select the device to connect to from the box and click on "Sync". If it an error occurs, make sure Bluetooth is turned on both on your computer and on the target device, that the target device is within range ( < 5 m.) and that your target device is discoverable and can accept incoming connection requests. If the problem persists, your target device does not support OBEX file transfer and is incompatible with SyncBlue. You should try running SyncBlue in Server Mode on the target device.

Synchronization

The default sync mode is "one-way sync". To change the sync mode, click "Settings".

One-way sync and two-way sync require the user to specify a sync folder on the home device (i.e. the computer running SyncBlue) and remote sync folder on the target device. It is possible to specify a target folder that does not exist yet. As long as the parent directory exists, SyncBlue will create the sync folder at the desired location.

One-way sync

By default, keeps the contents of the target folder identical to those on the home folder, i.e. deletes all contents of the target folder and replaces them with the contents of the home folder. The sync direction can be changed in the settings.

Two-way sync

Synchronizes the target and the home folder, i.e. keeps the most recent files and adds files and folders to either folder that are not present in the other folder. Does not delete files unless there is a more recent file in the other folder to replace it.

Manual sync

Enables the user to browse the files and folders on the remote device. Supports "put", "get", "delete" and "make folder" operations.

Server mode (beta)

Clicking the corresponding button in the menu bar starts a Bluetooth OBEX server which advertises a SyncBlue service to all surrounding Bluetooth devices. The SyncBlue service provides a subset of the functions of OBEX File Transfer which is sufficient to work with all SyncBlue clients. This enables communication between devices that do not natively support OBEX File Transfer such as two Windows machines or cross-platform synchronization between a Mac client and a Windows server.

The server is still in a beta stage. While all operations work on the developers' machines, we have not been able to test it on different operating systems with different Bluetooth stacks, path conventions etc. yet. Make sure to backup critical files before trying the server on your machine, particularly when syncing entire directory structures.

Mac OS X

System requirements

Mac OS X 10.5.x (or higher)

Installation

Download the installer. Run it and follow the instructions on the screen.

Usage & options

Connecting to a device

Before you attempt to establish a connection through SyncBlue, ensure that your computer and your device are paired. If not, SyncBlue will automatically ask for pairing.
After clicking on the button "connect", you should be able to see a list with all the devices already paired with your system. If your device does not show in the list, please allow a couple of seconds and scroll down to the end. You should be see your device next to the button 'pair'.
Select the device to connect to and click on "Browse".
If your device supports OBEX file transfer, a new window will appear displaying all files/folders located in the root of your target device. If it does not, a description should appear at the bottom of the window prompting "Your device does not have the necessary services". This means that your device does not support OBEX or it does not correcly advertise it.
Please note that Windows releases do not advertise OBEX file transfer and are thus (still) not suitable as target devices unless you run a server to advertise OBEX.
Also please make sure that the target device is within range ( < 5 m.) and that your target device is discoverable and can accept incoming connection requests. If the problem persists, your target device does not support OBEX file transfer and is incompatible with SyncBlue.

SyncBlue Browser Interface

Browse into your target device

Once you establish a connection between your computer and the target device, a new browser window will automatically appear. If the target destination folder (by default '/') is not empty, you should be able to see a list of all files/folders contained in the root folder. If you double click on a selected folder, you should be able to browse into its content. You can also use the button 'Home' to return to the root folder or the button 'Up' to move up into the directory.

Manually receive/send/delete files

To receive a file from your target device, please first select it on the list and click on the button 'receive'. A new window should appear asking for a destination location on your computer. A progress bar should appear on the bottom of the window displaying the Estimated Transfer Time and the remaining size to transfer. To send a file to your target device, you should click on the button 'Send'. A new window should appear to choose the file to send. By clicking on 'send', a progress bar should appear displaying the Estimated Time for the transfer and the remaining bytes to send. To delete a file, please select it first, then click on the button 'delete'.

Synchronization

Feature coming soon.

Source code

Python 2.7 for Windows XP/7/8/8.1/10, Linux

It is possible to run the program on other platforms directly from the source code. To do so, extract the source folder, open a terminal/command-line utility, make the source folder your working directory and type "python SyncBlue.py".

Make sure you are running the correct version of Python (Python 2.7) and install the following modules:

If the program does not launch or you are not able to connect to a device, it is most likely that the Python Bluetooth libraries do not support your system's Bluetooth stack.