OBEXFTP(1)

💅 OBEXFTP — the manual, but make it make sense

okay so bestie, you've found yourself on the obexftp(1) page and honestly? you're about to have a good time. let's get into it. 🫶

✨ SYNOPSIS ✨

obexftp [OPTION] [COMMANDS]

🌸 DESCRIPTION 🌸

obexftp is your little key to the files on mobile equipment — yes, cell phones, the whole thing. and with obexftpd you can transfer files between literally any computers using IrDA, Bluetooth and TCP/IP. slay. 🔥

this tool is how you reach the ObexFTP library through a command line interface, but ngl, you might wanna consider the other means available too. like, for example, the ObexFS filesystem for Linux. options, bestie, we love options. 💖

🎀 OPTIONS 🎀

okay this is the important part so pay attention: the ordering of options is important. every command will use the most recent device set. every file without a command switch will apply to the command given most recent. see EXAMPLES below if that made your head spin. 💀

🦋 Transport Options

• -i, --irda — connect using the IrDA protocol. this is the default, so it's basically the main character. ✨
• -b device, --bluetooth device — connect to this bluetooth device. if the device is not given, the first device found gets used. no cap.
• -B number, --channel number — use this bluetooth channel when connecting. the channel will be discoverd automatically if this option is not used.
• -d no/address, --hci no/address — use the bluetooth device referenced by number or address as the source device for the connection.
• -u intf no, --usb intf no — connect to this usb interface, or list all available usb interfaces. (yes it does two jobs, it's versatile like that 💅)
• -t device, --tty device — connect to this tty device.
• -n host, --network host — connect to this network host.

💜 Compatibility Options

• -U uuid, --uuid uuid — select the UUID to connect with. the recognized values are currently "none" needed by some Nokia mobile devices, "FBS" (default) for the normal file browsing service, "IRMC" for IRMC synchronisation, and "S45" when connecting to a Siemens Mobile phone via cable, or "SHARP" for PCSOFTWARE UUID with Sharp devices.
• -H, --noconn — suppress connection IDs (i.e. send no connection header to the mobile).
• -S, --nopath — don't use "setpath" commands (i.e. send the whole path as filename to the mobile). can be used together with --noconn and --uuid none to send an OBEX-PUSH. 👑

🍓 Setting The File Path

• -c folder, --chdir folder — set the mobile's current working directory.
• -C folder, --mkdir folder — set the mobile's current working directory, and the folder will be created if it doesn't exist. growth mindset fr fr. 🌱
• -l folder, --list folder — list a folder.

🧚 Sending And Retrieving Files

• -o path, --output path — specify the target file name, overriding the implicit local name from --get or the implicit remote name from --put.
• -g source, --get source — retrieve files from mobile.
• -G source, --getdelete source — retrieve files from mobile and delete them on the mobile. grab and go, iconic. 💅
• -p source, --put source — send files to the mobile.
• -k source, --delete source — delete files from the mobile.

⭐ Experimental Extras

these are the experimental ones bestie — they're doing their best, treat them gently. 🙈

• -X, --capability — retrieve the capability object from the mobile (if available).
• -Y, --probe — probe and report device characteristics.
• -x, --info — retrieve misc infos from mobile. i.e. memory size and free memory. Siemens specific for now.
• -m src dest, --move src dest — move (rename) files on the mobile. Siemens specific for now.

🌈 Version Information And Help

• -v, --verbose — be verbose and give some additional infos.
• -V, --version — print version string and exit.
• -h, --help, --usage — print short usage instructions.

---

🔥 EXAMPLES 🔥

to get the directory listing from the first irda device:

obexftp -i -l

or just obexftp -l as IrDA is the default. ✨

to get the file bar from directory foo from the first bluetooth device:

obexftp -b -c foo -g bar

to send the file bar to directory foo with device on first serial port:

obexftp -t /dev/ttyS0 -c foo -p bar

it is possible to use RfComm (serial port over bluetooth):

obexftp -t /dev/rfcomm0 -c foo -p bar

and also IrComm (serial port over IrDA):

obexftp -t /dev/ircomm0 -c foo -p bar

to send the file bar using plain OBEX PUSH:

obexftp --bluetooth --nopath --noconn --uuid none --put bar

👑 SEE ALSO 👑

obexftpd(1), openobex(3), obexftp(3), multicobex(3), libbfb(3).

💀 BUGS 💀

Bugs ? Features !

(they said it, not me 😭)

🌸 NOTES 🌸

the software has been tested and reported working on at least Siemens, Ericsson, and Nokia phones. we love a proven track record. 🎀

🫶 AUTHOR 🫶

Christian W. Zuckschwerdt <zany@triq.net>

🎀 NOTES 🎀

1. zany@triq.net — mailto:zany@triq.net

---

okay that's the whole thing bestie, you're officially an obexftp expert. this page is from the OBEXFTP(1) manual, dated 02/21/2024 — go forth and transfer those files. mwah. 💖🦋✨