LJKit

What’s new?

Now hosted by

Check out the shiny new project page.

The latest version is 0.9.4, released on 2003-03-21. This version includes rewritten mood handling, fewer notifications, and possibly more bugs. See Changes.txt for details.

Caveat Implementor:

• The API is subject to change until version 1.0, which will is scheduled to be released sometime before the Earth smashes into the Sun.
• [LJAccount downloadGroups] and [LJAccount uploadGroups] have been removed. The corresponding *Friends methods have incorporated their functionality.
• Notifications related to friends have been removed for now because of an issue with NSNotificationQueue. They will return in a later release.

Where do I get LJKit?

• Download LJKitSource.tar.gz (116 KB) which contains the source code for LJKit (the framework) and SimpleJournal (an example application).
• Download SimpleJournal.dmg (180 KB) which contains a binary version of SimpleJournal, in case you aren't in the mood to compile. SimpleJournal has not been updated to reflect recent changes to LJKit, so I've decided to leave this functional but outdated version online.

What is LJKit?

LJKit is a framework which can be used to develop LiveJournal clients for Mac OS X. It provides a robust, full featured implementation of the LiveJournal Client/Server Protocol. (The only mode not yet implemented is syncitems.)

LJKit was developed by me and is available to you under the terms of the GNU LGPL. (You can use it in any way you want, including linking it to a commercial application, as long as the source to LJKit itself remains free.)

LJKit is documented using HeaderDoc. You can browse the LJKit Documentation online.

LJKit uses things like NSKeyedArchiver and performSelectorOnMainThread: which are only available in Mac OS X 10.2. If you haven't upgraded, sorry!

What is SimpleJournal?

SimpleJournal is a demonstration application which uses LJKit. SimpleJournal is placed in the public domain. (You can do whatever you want with it. There are no restrictions.)

Here is a screenshot of SimpleJournal in action:

SimpleJournal supports entry writing, editing your most recent entry, friends checking, and friends and groups editing. (That last feature is pretty slick, if I may say so myself.) You are welcome to use SimpleJournal as a starting point in developing your own LiveJournal client. You can release your new client under the GPL or keep the source closed and charge $50 per copy; it's up to you.

Miscellany

Xjournal by Fraser Speirs uses LJKit. (iJournal, another client, does not.)

LJKit is listed on Freshmeat.

If you are using LJKit, please send me an email. I'd like to have an idea of how much attention it is getting so I can decide how often to post updates. Suggestions and patches are welcome. I will set up a CVS repository somewhere if there are enough contributors.