.\" Process this file with .\" groff -man -Tascii clive.1 .\" .TH CLIVE 1 "APRIL 2002" Linux "User Manuals" .SH NAME clive \- A console LiveJournal client .SH SYNOPSIS .B clive .BI "[-u " "username" "] [-w " "password" "] [-j " "journal" "]" .BI "[-s " "subject" "]" .BI "[-r " "security" "] [-f " "mood" " ] [-i " "userpic" "]" .BI "[-m " "music" "] [-p] [-d] [-v]" .BI "[--backdate " "YYYYMMDDhhmm" "]" .BI "[--replace " "itemid" "]" .BI "[--charset " "encoding" "]" .BI "[--plainpass] [--hashpass] [--softreturn]" .PP .B clive [--loginonly | --nologin] .PP .BI "clive [--lfrgp | --laccess | --lpic | --lfriends | --levents" "[=num]" "]" .PP .B clive .BI "[--addfriend " "name" "] [--delfriend " "name" "]" .SH DESCRIPTION .B clive is console client for the LiveJournal system. It doesn't offer much in the way of features. It's strength lies in the ability to pipe the text for an entry into it on stdin, thus allowing it to be used filter-style. It an also lauch your preferred editor to type entries. It allows for users to login and post/read/replace events, and that's it. .SH OPTIONS .IP "-u/--user username" Specify the username .IP "-w/--password password" Specify the password .IP "-j/--usejournal journal" Specify the journal to use, if different from the username. You can also use the associated ID number obtainable with .BR --laccess . .IP "-s/--subject subject" The subject of the post. This will disable interactive entry of the subject. .IP "-r/--security security" Clive defaults to public security, unless specified otherwise. This option is how you do that from the command line. See the SECURITY section below for a description of that spec. .IP "-f/--mood mood" LiveJournal allows you to display a mood along with your post. Use this option to set it. Use quotes if you want to have whitespace in your mood. .IP "-i/--userpic keyword" Many users have more than one user picture, you can specify which one you would like to use here. You can either use the picture keyword, or the ID as specified by .BR --lpic . .IP "-p/--preformat" This will tell LiveJournal that we are sending preformatted text. This is useful if you have a lot of HTML in it. .IP "-d/--nocomments" This will tell LiveJournal to disable comments on this post. .IP "-v/--version" Display Clive version details and exit. .IP "-?/--help" Display a short usage statement. .IP "--backdate YYYYMMDDhhmm" Back date the item to year YYYY, month MM, day DD, hour hh, minute mm. This will insert it into your journal at that date, and it will prevent the post from showing on other users' friends pages. .IP "--replace=itemid" Replace an existing entry. The itemid can be obtained by running with --levents first. Note that not just the entire text, but all settings of the post will be overridden, so you should use --backdate to reuse the old date. To delete an existing entry, just leave the event text empty. .IP "--charset=encoding" Specify the input character set (e.g. utf-8, iso8859-2, koi8-r). If no character set is given, then iso-8859-1 (Western European) is assumed. This option can be set in the configuration file. .IP "--plainpass" Clive, by default, uses a challenge-response system to verify your password. If you use this option, it will send your password as plaintext. .B Use of this option is not recommended. .IP "--hashpass" Clive, by default, uses a challenge-response system to verify your password. If you use this option, it will send an MD5 hash of your password to the server. Which is faster, but not very secure. .B Use of this option is not recommended, .IP "--softreturn" This will collapse multiple lines to a single long line. A new paragraph can still be started with an empty line in the text. In general this will generate pretier output on the website. This option can be set in the configuration file. .IP "--lfrgp" This will display a list of your friends groups with their associated ID numbers. .IP "--laccess" This will display a list of the journals you have access to and their associated ID numbers. .B If you join or leave a community, these numbers will change. .IP "--lpic" This will dislpay a list of your userpics and their associated IDs. .B If you make any changes to your user pictures, the IDs displayed may change. .IP "--lfriends" This will display a list of your friends and their birthdays (if set). .IP "--addfriend name" Add a new friend. It is not an error to add an existing friend. .IP "--delfriend name" Delete a friend. It is not an error to delete an already non-existing friend. .IP "--levents[=num]" This will display a list of the num most recent journal entries. If no argument is given, it will only show the ID, timestamp and subject of the most recent entry. .IP "--loginonly, --nologin" These options control the behavior of clive with respect to logging into the LJ server. Logging in allows you to retrieve any user-specific information such as friend groups. If you wish to just login, use --loginonly. If you don't want to login at all use --nologin. .SH FILES .I ~/.cliverc .RS Your personal configuration file, you can set most options in here so that you don't have to pass them in on the command line. .SH SECURITY LiveJournal has a variety of security settings: public, private, and custom. Clive supports all of these through the .B -r option. Posts default to public security unless set on the commandline. Here are the different security levels and how to specify them. .IP "private" Pass either "1" or "private" as the spec, and you will be the only person that can view your post. .IP "friends" Pass either "2" or "friends" as the spec, and your post will only be viewable by the LiveJournal users you list as friends. .IP "custom" LiveJournal allows you to specify up to 30 different friend groups, and you can set your post readable by different groups. The way to construct a security spec for a custom setting is to start with a ":" and then put in the name (e.g. :closefriends). If you want to use multiple filters, continue separating with colons. To include whitespace, use quotes. (e.g. :schoolfriends:2:"Default View") .SH HEADERS It's annoying when you're editing a posting and realize another subject, or mood description might be more appropriate. It is now possible to set these in the posting itself by adding so called headers. If your posting starts with lines containing special keywords followed by a colon and value, these will be treated as special meta-information instead of the body of your posting. For example currently available headers are: .IP .nf Subject: An example posting Mood: happy Music: EAV - Ding Dong Here follows the body of your posting .SH CONFIGURATION We understand that it can be annoying to pass in half a dozen command line options every time you want to post to LiveJournal, so we allow you to have a configuration file that specifies all of these. You can specify key value pairs in your .cliverc for any of the command line options that take values. Each pair should go on a line of it's own. Any whitespace before and after the key or value is ignored. Lines that begin with # are also ignored. Each pair should look like this: .P key = value .SH ENVIRONMENT .IP VISUAL, EDITOR The name for the external editor to use. If visual is set, this will be preferred. If neither variable is set, a very lame built-in editor will be used. This can be overriden in the configuration file. .SH AUTHORS .nf Original author: Samuel Tesla Current maintainer: Johan van Selst Contact email: http://ljclive.sourceforge.net/