BitPim now provides a stand-alone, Command Line Interface (CLI) feature that allows users to access and manipulate the phone file system without using the full BitPim GUI.
The general BitPim CLI syntax is:
bitpim [CLI Command & Arguments] [-p comm port] [-f phone model]
or if you're running from source:
python bp.py [CLI Command & Arguments] [-p comm port] [-f phone model]
CLI Command & Arguments: a space-separated string specifying the command and its arguments.
-p comm port (optional): specify the interface comm port through which BitPim communicates with the phone.
-f phone model (optional): specify the phone model of the current phone.
If either the comm port or the phone model is not specified, BitPim will use the current settings in the config file. If neither the comm port nor the phone model is available, BitPim will exit with an error.
Depending on the commands, the arguments can include one or more file or directory names. These files or directories can either reside locally on the PC or on the phone file system (FS), each of which has different syntax.
The syntax for specifying local file and directory names is defined by the OS.
The syntax for specifying phone FS is as follows:
The directory name "." can be used to specify the current directory.
Currently, this syntax does not support wildcard characters.
dir nameon the phone file system. The arguments specify one or more phone FS dir names. The prefix
phone:may be omitted from the directory names. The file/directory names are listed one per line.
bitpim "ls phone:/nvm /pim"
lists the files and directories in phone FS dir "/nvm" and "/pim".
bitpim "ls phone:/" -p com5 -f LG-VX8500
lists the files and directories in the root directories of the phone FS using port com5 and phone model LG VX-8500.
bitpim "ls /" -c configfile
lists the files and directories in the root directory of the phone FS using the settings in the config file named configfile.
bitpim "cp nvm ."
copies all files from the phone FS directory nvm to the local current directory.
bitpim "cp phone:/nvm ."
bitpim "cp nvm phone:/nvm/nvm tmp"
copies all files from the phone directory nvm and nvm/nvm to local directory tmp.
bitpim "cp tune.mp3 phone:/nvm/nvm01.dat phone:/test"
copies local file tune.mp3 and phone FS file nvm/nvm01.dat to the phone FS directory test.
bitpim "mkdir tmp phone:/tmp/tmp1"creates 2 directories on the phone FS: tmp and tmp/tmp1.
phone:may be omitted from the file names.
bitpim "rm file1.txt phone:file2.txt tmp/file3.txt"delete file file1.txt, file2.txt, tmp/file3.txt from the phone FS.
bitpim "rmdir tmp phone:tmp1"deletes directory tmp and tmp1 from the phone FS.
BitPim Online Help built 17 January 2010