charm(1)                   OpenBSD Reference Manual                   charm(1)



NAME
       charm - Client for LiveJournal-based blogging sites


SYNOPSIS
       charm [ -h, --help ]

       charm [ -o, --options ]

       charm [ -f, --file FILENAME ] [ -u, --user USERNAME ] [ -c, --check ] [
       -i, --interval MINUTES ] [ -g, --group FRIENDGROUP ]

       charm [ -f, --file FILENAME ] [ -u, --user USERNAME ] [ -z, --sync ] [
       -a, --archive DIR ]

       charm [ -f, --file FILENAME ] [ -u, --user USERNAME ] [ -l, --login ] [
       -n, --nologin ] [ -d, --drafts DIR ] [ -a, --archive DIR ] [ -r,
       --resume DRAFTFILE ] [ -q, --quick ] [ -s, --subject SUBJECT ] [ -p,
       --permit PERMISSION ] [ -m, --mood MOOD ] [ -k, --pic KEYWORD ] [ -M,
       --music MUSIC ] [ -A, --autodetect ] [ --autoformat STATUS ] [
       --backdate STATUS ] [ --comments STATUS ] [ --noemail STATUS ]


DESCRIPTION
       Charm is a client for LiveJournal, Blogger, and other blogging sites
       that support the LiveJournal protocol or the Atom API. It can be used
       for posting, journal administration, offline synchronization, and
       checking for friend updates.


GENERAL OPTIONS
       -h, --help
              Print a help message.


       -o, --options
              Print the posting options.


       -f, --file FILENAME
              Specify the configuration file to read at startup.


       -u, --user USERNAME
              Specify the journal user to perform operations as.


FRIENDS-CHECKING OPTIONS
       -c, --check
              Utilize friends-checking mode.


       -i, --interval MINUTES
              Specify how many minutes to wait between checks.


       -g, --group FRIENDGROUP
              Specify which friend groups to limit check to. Can be specified
              multiple times.


SYNCHRONIZATION OPTIONS
       -z, --sync
              Utilize synchronization (journal download) mode.


       -a, --archive DIRECTORY
              Save synchronized posts to this directory.


POSTING OPTIONS
       -l, --login
              Log in when Charm is started.


       -n, --nologin
              Do not log in when Charm is started.


       -d, --drafts DIRECTORY
              Use this directory to save in-progress journal entry drafts.


       -a, --archive DIRECTORY
              Use this directory to save completed posts.


       -r, --resume DRAFTFILE
              Resume a previous session, reading from this saved draft file.


       -q, --quick
              Non-interactive mode. Read journal entry text from standard
              input, and post it immediately, rather than using the menu-based
              interactive editing.


       -s, --subject "SUBJECT"
              Use this as the subject line of the journal entry.


       -p, --permit PERMISSION
              Use this for the post permissions. Can be "public", "private",
              "friends", or a list of friend groups separated by commas.


       -m, --mood MOOD
              Use this for the mood of this entry.


       -k, --pic KEYWORD
              Use this picture keyword for the userpic of this entry.


       -M, --music "MUSIC"
              Use this as the music for this entry.


       -A, --autodetect
              Use XMMS to automatically determine what music to use for this
              entry.


       --autoformat=[on|off]
              Let the site automatically HTML format this post, or do it
              ourselves?


       --backdate=[on|off]
              Backdate this entry, so it does not show up on the friends pages
              of our friends?


       --comments=[on|off]
              Allow people to post comments on this entry?


       --noemail=[on|off]
              Do not send us email when someone posts a comment on this entry?


ENVIRONMENT
       VISUAL      The default editor to use for writing entries.


       EDITOR      The default editor to use for writing entries, if VISUAL is
                   not set.


       PAGER       The default pager to use when previewing entries.


       BROWSER     The default Web browser to use when viewing a journal.


       HTTP_PROXY  The HTTP proxy to use, if any, in the format site:port


FILES
       ~/.charmrc  The default location of the charmrc file for a user.


MANUAL
       There is a full manual for Charm. It can usually be found in
       /usr/local/share/doc/charm/charm.html


SEE ALSO
       charmrc(5)


AUTHOR
       Lydia Leong (evilhat@livejournal.com)



                                 November 2004                        charm(1)
