NAME

       Mulog - Chat Logging Script for Museekd

DESCRIPTION

       Mulog  is  command-line  Python script that connects to museekd(1) and saves chat messages
       into log files. Under the Log Directory, it creates room & private  subdirectories  and  a
       syslog file. If it loses connection with museekd, it will automatically exit.

       Setting the interface and password on the command-line is a security risk. Since interface
       and password settings are saved to the config file when set, you  should  set  them,  exit
       mulog, and restart mulog without the options on the commandline..LP

       Before running, you will need a working museekd(1) and need to know your museekd interface
       and interface password. Configure those with musetup(1).

SYNOPSIS

       mulog [-c <config-filename> ] [--config <config-filename>] [-i <host:port | /socket.path>]
       [--interface    <host:port   |   /socket.path>   [-p   <interface-password>]   [--password
       <inteface-password>] [-l <directory>] [--log <directory>] [-v] [--version] [-h] [--help]

OPTIONS

       Mulog accepts the following options:

       -c <filename>, --config <filename>
              Use a different config file.

       -l <directory>, --log <directory>
              Use a different chat log directory.

       -i, --interface <host:port | /socket.path>
              Choose a different interface (saved to config file)

       -p, --password <interface-password>
              Choose a different password (saved to config file)

       -v, --version
              Display Version and exit.

       -h, --help
              Display Help and exit.

EXAMPLE

       To run this program the standard way type:

       mulog

       Alternativly you use a different config file with:

       mulog --config mulog.config

       To set the interface password:

       mulog --password 1234567890

FILES

        ~/.museekd/mulog.config
              The default location for the mulog config file.

        ~/.museekd/logs/
              The default log directory.

        ~/.museekd/logs/syslog
              The museekd error/connection log file.

        ~/.museekd/logs/room/
              The directory where chat room logs are stored.

        ~/.museekd/logs/private/
              The directory where private chat logs are stored.

AUTHORS

       Hyriand <hyriand@thegraveyard.org>

       daelstorm <daelstorm@gmail.com>

SEE ALSO

       mucous(1)   murmur(1)   muscan(1)   muscand(1)museekcontrol(1)    museekd(1)    musetup(1)
       musetup-gtk(1) museeq(1)