README
1
2
3 FiSHLiM
4
5 http://fishlim.kodafritt.se/
6
7
8FiSHLiM is a HexChat plugin for FiSH IRC encryption. It's my attempt at making
9a simple, lightweight and secure plugin for this encryption protocol.
10
11For installation instructions, see the INSTALL file.
12
13
14Features
15--------
16
17Working:
18 * Sending/receiving messages
19 * Topic decryption
20 * Using unecrypted keys / keys without a password from blow.ini
21 * Pure protocol-level filtering (works with highlighting, nick coloring etc)
22 * Partially encrypted messages (i.e. prefixed with nickname by a bouncer)
23 * CBC mode
24
25Not working:
26 * Key exchange
27 * Password-protected key storage
28 * Topic encryption
29 * Remote exploitation (hopefully!)
30 * Plaintext content that contain +OK is decrypted twice
31
32
33Commands
34--------
35
36/setkey [nick or #channel] [mode:]password
37
38 Sets the encryption key for the nick or channel to password. The keys
39 are stored in the configuration file in ~/.config/hexchat/blow.ini
40
41 Optionally, the block cipher mode for outgoing messages may be specified.
42 If unspecified it will be ECB for backwards compatibility, but for
43 greater security, please use CBC mode if possible.
44
45 For incoming messages, the block cipher mode is auto-detected, regardless
46 of which mode was configured with this command.
47
48
49/ciphermode [nick or #channel] mode
50
51 Sets the cipher mode to ECB or CBC. See /setkey.
52
53
54/copykey from [to]
55
56 Copies the key from the given channel or nick. If no "to" nick or channel
57 is given, then it copies to the one which is currently open.
58
59 This command can be used to use an existing channel key when chatting
60 with a single user. To do so, open a dialog with the user and type
61 /copykey #nameofchannel
62
63
64/delkey nick-or-#channel
65
66 Deletes the given nick or channel from the configuration file.
67
68
69