---
name: "alicqrc"
section: "5"
platform: "linux"
package: "alicq"
version: "0.8.9-1"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/alicqrc"
---

# alicqrc(5)

Alicq configuration file

## NAME

	alicqrc - Alicq configuration file

## DESCRIPTION

alicq condfiguration file is used to customize alicq during startup.  Any configuration file can be specified with **-config** option when running alicq. If **-config** option is not given, default configuration file is searched depending on current platgorm:

- Unix

  - **~/.alicq/alicqrc**

  primary configuration

- **~/.alicqrc**

  for backward compatibility

- Windows

  - **%USERPROFILE/alicq/alicq.cfg**

  - **/alicq/alicq.cfg**

  where *workingdir* is a folder with alicq run file.

## FILE FORMAT

Alicq startup file is just a Tcl script, which is sourced by main program. It looks like configuration file, but it is possible to use any Tcl command in it. For example, if you want to keep ICQ password in other file, you may write something like:

```
	source ~/.alicq/password
```

where **~/.alicq/password** contains string

```
icq password mypassword
```

or

```
icq password [eval_password_by_any_way]
```

Common startup file usually contains following entities:

- calls of module loading commands

  - calls of module configuration commands

  - resources specifications

  - arbitrary Tcl code user wants to evaluate in Alicq interpreter on startup

  Module loading command has following syntax: **module** *module-name*

```
	module tree
```

Alicq looks for modules through a list of catalogues:

- *basedir*/modules

  where *basedir*\
   	is a directory where current configuration file is read from.

- *workingdir*/modules

  where *workingdir* is a directory where alicq run file is read from.

- *workingdir*/../share/alicq/modules

  where *workingdir* is a directory where alicq run file is read from.

## MODULE CONFIGURATION COMMANDS

Each module can have number of configurable parameters. These parameters can  be specified in configuration file using following syntax:

 *module-name* *configurable-parameter* *value*

```
	icq uin 47298730
	icq roster use 1
	tree hide empty no
	tree hide offline yes
```

List of supported configurable parameters can be retrieved with command

**alicq-info** \[ *module-name* \]

## FILES

- **$HOME/.alicq/alicqrc**

  Default startup file for Unix version of Alicq.

- **$HOME/.alicqrc**

  Startup file of older versions of Alicq. Used for backward compatibility.

## SEE ALSO

[**alicq**(1)](/alicq/1.md)

Alicq home page (**http://alicq.sourceforge.net/**)

## AUTHORS

Alicq was written by Ihar Viarheichyk \<iverg@mail.ru\>.

This manual page was written by Dmitry Borodaenko \<angdraug@debian.org\>, based on Alicq README and slightly reworked by Vitus Wagner \<vitus@ice.ru\> and Ihar Viarheichyk \<iverg@mail.ru\>.

This is free documentation; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.