Make a donation to support development of the Bluetooth Command Line Tools


Bluetooth command line tools icon

Sends files to remote OBEX capable devices (computers, mobile phones, etc).


    btobex {-bBluetoothAddress | -nFriendlyName} [-cChannel] [-pPIN [-e]] 
           [-rRetries] [-fFileName] [file1 [file2 [...]]] 

      -b  Bluetooth address of target device in (XX:XX:XX:XX:XX:XX) format.  
      -n  Friendly name of target device.
      -c  RFCOMM channel (1-30). If specified, service lookup is not performed. 
      -p  PIN code for authenticating with remote device.
      -e  Use encrypted connection (only if PIN authentication is used)
      -r  Make specified number of attempts is case of error
      -f  Use this file name for the data from STDIN (standard input)      
      -h  Prints help screen.


    1. Send file "picture.jpg" from the current folder to the device named "Nokia 6300" :

	    btobex -n"Nokia 6300" picture.jpg

    2. Send all text files from the current folder to the device with known address : 

            btobex -b(11:11:22:22:33:33) *.txt
    3. Send output of other program as a file named "message.txt" :

            echo This is a test | btobex -b(11:11:22:22:33:33) -f"message.txt"

btobex maintains the ERRORLEVEL environment variable. Zero means successful execution, any other value - error. Detailed error description is printed to the standard error output.

Download and install

btobex is a part of Bluetooth command line tools suite.

Download setup package from the Bluetooth command line tools home page

Feedback and contacts

Please report bugs, request features and send other feedback to

Subscribe to Bluetooth Command Line Tools RSS feed


Bluetooth Driver Installer | Bluetooth Stack Switcher | Directory of Bluetooth Resources

Privacy policy | Terms and conditions
Copyright © 2009-2024