To create new wiki account, please join us on #znc at freenode and ask admins to create a wiki account for you. You can say thanks to spambots for this inconvenience.


From ZNC
Revision as of 16:25, 7 November 2012 by Un1matr1x (talk) (Module moved to the Core)
Jump to: navigation, search

NOTE: ZNC will hold/replay private messages when you disconnect/reconnect by default. This module adds additional options and functionality to this.

When you are set away or detached, this module will save all private messages for you. The messages can be read until you delete them. Messages are stored in an encrypted file on your shell (based on the <password> you set, if set). That way everyone who has access to this shell still cannot read your messages. This module will also set you away when you are idle some time (see timer/settimer).



This user module takes one, two or three arguments. The argument can be -notimer or -timer x. See the disabletimer and settimer documentation below for an explanation. The last argument, which must always be given, is the password used for encrypting the saved data.

Read loading modules to learn more about loading modules.

Note: Your installation must be configured with SSL enabled, otherwise this module will not be available.

example: /msg *status loadmod away -notimer passw0rd
example: /msg *status loadmod away -timer 600 passw0rd (600 seconds, which is 10 minutes)


The module sets you away after some seconds. This can be disabled with disabletimer and the time can be changed with settimer x which sets it to x seconds. The ping command can be used to reset that time so that you will not be set away for x seconds.

<Kuja> away
Notice from [*away(]: You have been marked as away
<Kuja> back
Notice from [*away(]: Welcome Back!
Notice from [*away(]: You have 1 messages!
<Kuja> show
<*away> Kuja_!
<*away> 0) [2005-10-10 10:19:41] test
<*away> #--- End Messages
<Kuja> delete all
Notice from [*away(]: Deleted 1 Messages.

When you attach you will be automatically set back as well.

Known Issues

Away blocks starting ZNC

What am I supposed to do if I can't start ZNC because the away module fails to decrypt its saved messages?
The easiest way to fix this is to enter the correct password.

The second easiest way is to remove away's saved messages:

rm ~/.znc/users/*/moddata/away/.*

If you only want to remove the messages of some user, use this:

rm ~/.znc/users/<username>/moddata/away/.*

To avoid this error in the future and if you don't have problems with saving the password in the ZNC config file, you can add your password there:

LoadModule = away ThisIsMySecretPass