README.txt

   1 ljdump - livejournal archiver
   2
   3 This program reads the journal entries from a livejournal (or compatible)
   4 blog site and archives them in a subdirectory named after the journal name.
   5
   6 The simplest way to run this is to execute the ljdump.py script with Python.
   7 Depending on your OS, you may be able to double-click the ljdump.py script
   8 directly, or you may need to open a Terminal/Command Prompt window to run it.
   9 Either way, it will prompt you for your Livejournal username and password,
  10 then download all your journal entries, comments, and userpics.
  11
  12 You may optionally download entries from a different journal (a community)
  13 where you are a member. If you are a community maintainer, you can also
  14 download comments from the community.
  15
  16 If you want to save your username and password so you don't have to type
  17 it every time you run ljdump, you can save it in the configuration file.
  18
  19 The configuration is read from "ljdump.config". A sample configuration is
  20 provided in "ljdump.config.sample", which should be copied and then edited.
  21 The configuration settings are:
  22
  23   server - The XMLRPC server URL. This should only need to be changed
  24            if you are dumping a journal that is livejournal-compatible
  25            but is not livejournal itself.
  26
  27   username - The livejournal user name. A subdirectory will be created
  28              with this same name to store the journal entries.
  29
  30   password - The account password. This password is never sent in the
  31              clear; the livejournal "challenge" password mechanism is used.
  32
  33   journal - Optional: The journal to download entries from. If this is
  34             not specified, the "username" journal is downloaded. If this
  35             is specified, then only the named journals will be downloaded
  36             (this element may be specified more than once to download
  37             multiple journals).
  38
  39 This program may be run as often as needed to bring the backup copy up
  40 to date. Both new and updated items are downloaded.
  41
  42 The community http://ljdump.livejournal.com has been set up for questions
  43 or comments.
  44
  45 -----
  46
  47 convertdump - convert ljdump format to wordpress importer format
  48 Contributed by Sean M. Graham (www.sean-graham.com) and others
  49
  50 This will convert a pydump archive into something compatible with the
  51 WordPress LiveJournal importer.  This is the same format used by the Windows
  52 ljArchive exporter.
  53
  54 Arguments:
  55     -u  --user      username of archive to process [required]
  56     -l  --limit     limit the number of entries in each xml file (default 250)
  57     -i  --insecure  include private and protected entries in the output
  58     -h  --help      show this help page
  59
  60 Example:
  61     ./convertdump.py --user stevemartin --limit 200 --insecure