Mulog(1) Chat Logging Script for Museekd


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).


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]


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.


To run this program the standard way type:


Alternativly you use a different config file with:

mulog --config mulog.config

To set the interface password:

mulog --password 1234567890


The default location for the mulog config file.

The default log directory.

The museekd error/connection log file.

The directory where chat room logs are stored.

The directory where private chat logs are stored.


Hyriand <[email protected]>

daelstorm <[email protected]>