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

Awaystore: Difference between revisions

From ZNC
Jump to navigation Jump to search
M00n (talk | contribs)
Fixed and expanded the section on removing awaystore's encrypted save files
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Languages|Away}}{{DISPLAYTITLE:away}}
{{Languages|Awaystore}}{{DISPLAYTITLE:awaystore}}
<br/>
<br/>
{{Extra Module|version=0.099+}}
{{Core Module|version=1.0}}


NOTE: ZNC will hold/replay private messages when you disconnect/reconnect by default. This module adds additional options and functionality to this.
'''Note: ZNC will hold/replay private messages when you disconnect/reconnect by default, without this module. This module just 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.
When you are set away or are detached from the bouncer, 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). 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 module can also set you away when you are idle for some length of time—see timer/settimer.


== Usage ==
== Usage ==


{{Module arguments
{{Module arguments
| type  = network
| count = one, two or three
| count = one, two or three
| extra = The argument can be <code>-notimer</code> or <code>-timer x</code>. See the <code>disabletimer</code> and <code>settimer</code> documentation below for an explanation.
| extra = The argument can be <code>-notimer</code> or <code>-timer x</code>. See the <code>disabletimer</code> and <code>settimer</code> documentation below for an explanation.
Line 17: Line 18:
'''Note:''' Your installation must be configured with SSL enabled, otherwise this module will '''not''' be available.
'''Note:''' Your installation must be configured with SSL enabled, otherwise this module will '''not''' be available.


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


=== Commands ===
=== Commands ===
The module sets you away after some seconds. This can be disabled with <code>disabletimer</code> and the time can be changed with <code>settimer x</code> 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.
The module sets you away after some seconds. This can be disabled with <code>disabletimer</code> and the time can be changed with <code>settimer x</code> 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
  <Kuja> away
  Notice from [*away(away@znc.com)]: You have been marked as away
  Notice from [*awaystore(awaystore@irc.znc.in)]: You have been marked as away
  <Kuja> back
  <Kuja> back
  Notice from [*away(away@znc.com)]: Welcome Back!
  Notice from [*awaystore(awaystore@irc.znc.in)]: Welcome Back!
  Notice from [*away(away@znc.com)]: You have 1 messages!
  Notice from [*awaystore(awaystore@irc.znc.in)]: You have 1 messages!
  <Kuja> show
  <Kuja> show
  <*away> Kuja_!~kuja@SpotChat-6276A185.berlikomm.net
  <*awaystore> Kuja_!~kuja@SpotChat-6276A185.berlikomm.net
  <*away> 0) [2005-10-10 10:19:41] test
  <*awaystore> 0) [2005-10-10 10:19:41] test
  <*away> #--- End Messages
  <*awaystore> #--- End Messages
  <Kuja> delete all
  <Kuja> delete all
  Notice from [*away(away@znc.com)]: Deleted 1 Messages.
  Notice from [*awaystore(awaystore@irc.znc.in)]: Deleted 1 Messages.


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


== Known Issues ==
== Known Issues ==
=== Away blocks starting ZNC ===
=== awaystore 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?<br />
What am I supposed to do if I can't start ZNC because the away module fails to decrypt its saved messages?<br />
The easiest way to fix this is to enter the correct password.
The easiest way to fix this is to enter the correct password.


The second easiest way is to remove away's saved messages:
The second easiest way is to remove all of away's saved messages (for all users and all networks):
  rm ~/.znc/users/*/moddata/away/.*
  rm ~/.znc/users/*/networks/*/moddata/awaystore/.*
 
If you only want to remove the messages of some user, use this:
If you only want to remove the messages of some user, use this:
  rm ~/.znc/users/'''<username>'''/moddata/away/.*
  rm ~/.znc/users/'''<username>'''/networks/*/moddata/awaystore/.*
 
If you only want to remove the messages on some network, use this:
rm ~/.znc/users/*/networks/'''<network_name>'''/moddata/awaystore/.*
 
Of course, any combination of particular username and network is also possible.


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:
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'''
  LoadModule = awaystore '''ThisIsMySecretPass'''
[[de:Away]]

Latest revision as of 04:49, 26 January 2023



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

When you are set away or are detached from the bouncer, 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). That way everyone who has access to this shell still cannot read your messages. This module can also set you away when you are idle for some length of time—see timer/settimer.

Usage

Arguments

This network 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 awaystore -notimer passw0rd
example: /msg *status loadmod awaystore -timer 600 passw0rd (600 seconds, which is 10 minutes)

Commands

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 [*awaystore(awaystore@irc.znc.in)]: You have been marked as away
<Kuja> back
Notice from [*awaystore(awaystore@irc.znc.in)]: Welcome Back!
Notice from [*awaystore(awaystore@irc.znc.in)]: You have 1 messages!
<Kuja> show
<*awaystore> Kuja_!~kuja@SpotChat-6276A185.berlikomm.net
<*awaystore> 0) [2005-10-10 10:19:41] test
<*awaystore> #--- End Messages
<Kuja> delete all
Notice from [*awaystore(awaystore@irc.znc.in)]: Deleted 1 Messages.

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

Known Issues

awaystore 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 all of away's saved messages (for all users and all networks):

rm ~/.znc/users/*/networks/*/moddata/awaystore/.*

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

rm ~/.znc/users/<username>/networks/*/moddata/awaystore/.*

If you only want to remove the messages on some network, use this:

rm ~/.znc/users/*/networks/<network_name>/moddata/awaystore/.*

Of course, any combination of particular username and network is also possible.

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 = awaystore ThisIsMySecretPass