]> www.wagner.pp.ru Git - oss/ljdump.git/blob - README.txt
handle more potential non-filename characters in userpic keywords
[oss/ljdump.git] / 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 If you want to save your username and password so you don't have to type
13 it every time you run ljdump, you can save it in the configuration file.
14
15 The configuration is read from "ljdump.config". A sample configuration is
16 provided in "ljdump.config.sample", which should be copied and then edited.
17 The configuration settings are:
18
19   server - The XMLRPC server URL. This should only need to be changed
20            if you are dumping a journal that is livejournal-compatible
21            but is not livejournal itself.
22
23   username - The livejournal user name. A subdirectory will be created
24              with this same name to store the journal entries.
25
26   password - The account password. This password is never sent in the
27              clear; the livejournal "challenge" password mechanism is used.
28
29 This program may be run as often as needed to bring the backup copy up
30 to date. Both new and updated items are downloaded.
31
32 The community http://ljdump.livejournal.com has been set up for questions
33 or comments.