OBEXFTP(1)

📦
version 0.24.2 · 2 versions
, in ubuntu stonking

💖 obexftp(1) — the OBEXFTP manual, but make it cute 💖

okay bestie, sit down, hydrate, because we're about to learn obexftp and honestly? it's giving legendary. this is the manual page for obexftp, section 1 of the manual (iykyk) 🌸

✨ NAME ✨

obexftp — Mobile Equipment file transfer tool 🫶

📜 SYNOPSIS 📜

obexftp [OPTION] [COMMANDS]

that's it. that's the whole vibe. options first, commands after, and yes the order MATTERS (we'll get there, don't worry) ✨

🦋 DESCRIPTION 🦋

so obexftp is used to access files on mobile equipment, i.e. cell phones. periodt. 📱 and with obexftpd you can transfer files between any computers using IrDA, Bluetooth and TCP/IP. literally any. no cap.

this tool lets you access the ObexFTP library by the means of a command line interface. you might consider using the other means available. E.g. the ObexFS filesystem for Linux. like, options exist, bestie, and they're valid 💅

🎀 OPTIONS 🎀

warning: the ordering of options is important. every command will use the most recent device set. every file without command switch will apply to the command given most recent. see EXAMPLES 👀

okay so basically: whatever device you set last is the device the next command talks to, and a bare filename attaches itself to the most recent command. it's giving "order is the whole plot." 🌈

🛸 Transport Options

  • -i, --irda — connect using the IrDA protocol. this is the default, so if you're lazy (same) you can just vibe and it'll happen ✨
  • -b device, --bluetooth device — connect to this bluetooth device. if the device isn't given, the first device found will be used. first come first served, iconic behavior 🦋
  • -B number, --channel number — use this bluetooth channel when connecting. if you don't use this option, the channel will be discovered automatically. she finds herself 💅
  • -d no/address, --hci no/address — use the bluetooth device referenced by number or address as source device for the connection. yes you can do it by number OR by address, choose your fighter 👑
  • -u intf no, --usb intf no — connect to this usb interface, or list all available usb interfaces. dual purpose king 🔥
  • -t device, --tty device — connect to this tty device. old school, still slays 🎀
  • -n host, --network host — connect to this network host. internet girlie behavior 🌐

💜 Compatibility Options

  • -U uuid, --uuid uuid — select the UUID to connect with. 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. that's five whole moods and you have to pick one 🙈
  • -H, --noconn — suppress connection IDs (i.e. send no connection header to the mobile). quiet, mysterious, unbothered 💅
  • -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. trio of chaos, love that for us 🔥

🗂️ Setting The File Path

  • -c folder, --chdir folder — set the mobiles current working directory. we moving in 🏠
  • -C folder, --mkdir folder — set the mobiles current working directory. the folder will be created if it doesn't exist. she builds her own house 💖
  • -l folder, --list folder — list a folder. window shopping 🛍️

📤 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. you get to name the baby ✨
  • -g source, --get source — retrieve files from mobile. come here, file 🫶
  • -G source, --getdelete source — retrieve files from mobile and delete them on the mobile. getting and deleting, no going back 💀
  • -p source, --put source — send files to the mobile. yeet 📤
  • -k source, --delete source — delete files from the mobile. bye bestie 👋

🧪 Experimental Extras

  • -X, --capability — retrieve the capability object from the mobile (if available). if available, ok, don't come for her 😭
  • -Y, --probe — probe and report device characteristics. she's asking questions 🔍
  • -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. talk to me, tell me everything 🗣️
  • -V, --version — print version string and exit. the dramatic mic drop 🎤
  • -h, --help, --usage — print short usage instructions. three whole ways to ask, LOVE a flexible icon 💅

🌈 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? order. it all comes back to order. she warned you ⭐

👀 SEE ALSO 👀

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

the whole friend group, go say hi 🫶

💀 BUGS 💀

Bugs ? Features !

the most Gen Z sentence ever written and it's from an actual manpage. obsessed 😭✨

📝 NOTES 📝

the software has been tested and reported working on at least Siemens, Ericsson, and Nokia phones. she's been around, she's got range 💖

👑 AUTHOR 👑

Christian W. Zuckschwerdt <zany@triq.net>[1]

🧚 NOTES 🧚

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

and that's the whole page bestie, you're a certifed obexftp girlie now 💅✨ this was the OBEXFTP(1) manual, from the OBEXFTP source, dated 08/19/2026. go forth and transfer files, mwah 🎀🦋💖

📦 where this page comes from