Automated bluetooth file sending for developers (mostly).

BluetoothSender is a small utility built for sending files over Bluetooth to paired devices using OBEX Object Push. Since the Apple Bluetooth API already provides all the necessary functionaly to accomplish such a task, this utility is merely used to execute the provided commands in the proper order.



The latest version available for download is 2.0

You can git the source here:


This utility requires MacOS X 10.4 (Tiger) or higher (Leopard is supported). It is a Universal Binary so it works on both PPC and Intel machines. The machine is also required to have Bluetooth support (perhaps this will be resolved in a later version).


This command-line utility will run from the and requires the device to be paired to the computer in order to send a file. Once the device is paired the address of the device can be looked up using the -l command line option. Once the device address is known, sending the file is easy. Run the following command in the Terminal application in the directory where the BluetoothSender was extracted:

                ./BluetoothSender 00-11-22-33-44-55 ../FileToSend.pdf

Substitute 00-11-22-33-44-55 with the address of the device looked up in the System Preferences and substitute ../FileToSend.pdf with the path to the file that needs to be sent.

Building and installing

If the binary package was downloaded, 5 files will be extracted from the ZIP file. In order to install 2 files need to be copied or moved:

  • BluetoothSender: Move this file to the directory in which you will want to use it or move it to /usr/bin if you want to use it regardless of your current directory;
  • BluetoothSender.1: If you move the BluetoothSender file to /usr/bin you may want to move this file to /usr/share/man/man1/. If not you may place it anywhere you like. It can be viewed using man: man ./Bluetooth.1

If the source was downloaded, the project file can be opened and built in Xcode or using xcodebuild.


No new features have been planned.


2008-01-26 Version 2.0 is finished, ready to supply your shell scripts with success exit codes.

2008-01-20 Version 1.0 is ready for download, happily sending your files to all sorts of devices.


BluetoothSender is distributed under the terms of the GNU General Public License. See the file COPYING in the distribution for the terms. GNU also has an FAQ available, explaining what you can and cannot do.