summaryrefslogtreecommitdiff
path: root/README
blob: f710e0fbaa4cb580143e5fda74cbafd9536baa12 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58


                                FiSHLiM

                       http://fishlim.kodafritt.se/


FiSHLiM is a HexChat plugin for FiSH IRC encryption. It's my attempt at making
a simple, lightweight and secure plugin for this encryption protocol.

For installation instructions, see the INSTALL file.


Features
--------

Working:
  * Sending/receiving messages
  * Topic decryption
  * Using unecrypted keys / keys without a password from blow.ini
  * Pure protocol-level filtering (works with highlighting, nick coloring etc)
  * Partially encrypted messages (i.e. prefixed with nickname by a bouncer)
  * CBC mode

Not working:
  * Key exchange
  * Password-protected key storage
  * Topic encryption
  * Remote exploitation (hopefully!)
  * Plaintext content that contain +OK is decrypted twice


Commands
--------

/setkey  [nick or #channel]  [mode:]password

    Sets the encryption key for the nick or channel to password. The keys
    are stored in the configuration file in ~/.config/hexchat/blow.ini
    
    Optionally, the block cipher mode for outgoing messages may be specified.
    If unspecified it will be ECB for backwards compatibility, but for
    greater security, please use CBC mode if possible.
    
    For incoming messages, the block cipher mode is auto-detected, regardless
    of which mode was configured with this command.


/ciphermode  [nick or #channel] mode

    Sets the cipher mode to ECB or CBC. See /setkey.


/delkey  nick-or-#channel

    Deletes the given nick or channel from the configuration file.