Command Line Web Blogger (clib)

clib is a BSD licensed free software command line tool written in PHP that posts blog posts to blogging services supporting metaWeb API. It supports:

• Posting new blog entries
• Updating blog entries
• Deleting blog entries
• Setting publish/draft status
• Setting categories
• VIM support

Last updated: 26th September 2007

Pre-requisites

• A working PHP CLI installation. PHP 4.x is fine.
• A working Internet connection.

Download and Installation

• Download the file here
• Edit the first line to point to your PHP executable (by default, its /usr/bin/php)
• Save this file somewhere convenient on your filesystem (eg /usr/bin)
• Create a file .clib in your home directory (eg /home/foo/.clib)
• The file contents of .clib should be as follows:

  		[clib]
  		username = someuser
  		password = somepass
  		url = http://yourblog.com/xmlrpc.php
  	

• chmod 600 on the file so that nobody else can read it

Writing a new Blog Post

• Write a blog post with the following format

  		Title: blog title
  		Description: blog contents ...
  		...
  		...
  		Publish: draft
  		Categories: my cat, my dog
  		Comments: Yes
  	

  Note that Publish value can be publish or draft(case insensitive)
  Note that Comments line is optional and can be yes or no (case insensitive)
  Note that Categories line is optional and should be comma-delimited (case insensitive)
• Save the blog post
• Post the blog file as follows:

  		/path/to/clib -f blog_file
  	

• Note that the blog file has a new field item Post-ID that indicates the post ID as returned by the server. This can be used to update the blog post

Updating the Blog Post

• Update the blog post file
• Post the blog file as follows:

  		/path/to/clib -f blog_file
  	

Creating or Updating Posts via VIM

• When editing your blog post file in VIM, run the following command in command mode to post/update the file

  		%!/path/to/clib -V
  	

Deleting the Blog Post

• Delete the blog file as follows:

  		/path/to/clib -f blog_file -d