Instant Messaging
Normal encrypted text is a big block that starts with
-----BEGIN PGP MESSAGE-----. Anyone can see at a glance what it is. It is
also long, and chat apps often break it. They add line breaks, or turn parts
of it into links.
Instant messaging solves that. It turns your encrypted message into a single line of letters and numbers. You can paste the line into any chat app, and the line does not show what it is.
Send a Message
Section titled “Send a Message”-
Type your message in a Text Editor tab. It must be a normal text tab, not an email tab.
-
Choose who can read it:
- To encrypt for a person, tick their key in the Key ToolBox.
- To lock the message with a password instead, leave every key unticked. GpgFrontend asks you for a password.
-
Click Operations in the menu bar, then IM Encrypt. The shortcut is Ctrl+M.
Your text is replaced by one long line. Copy the line and paste it into your chat app.
If you also want the other person to know the message really came from you, choose IM Encrypt & Sign instead. The shortcut is Ctrl+Shift+M. This action always needs at least one ticked key, because a password cannot sign.
A menu item is greyed out in two cases: the current tab is not a normal text tab, or GpgFrontend cannot encrypt right now (for example, IM Encrypt & Sign with no key ticked).
What the Status Panel Shows
Section titled “What the Status Panel Shows”After encrypting, the Status Panel shows the usual encryption result, plus an Instant Messaging card with these lines:
- Encoding: how the line is written.
- Container Format: the version of the message format.
- Message Book: whether you use your own shared phrase or the built-in default.
- Book Fingerprint: a short code for your phrase, if you set one. Without a phrase, the card shows Set a Phrase instead, with the place to set it.
- OpenPGP Payload, Token Length and Wire Overhead: sizes, which you can usually ignore.
Read a Message
Section titled “Read a Message”-
Paste the line into a Text Editor tab.
-
Click Decrypt, exactly as you would for any other message.
GpgFrontend recognises an instant message by itself. There is no separate button for reading one. If the sender signed the message, use Decrypt & Verify to check the signature too.
After decrypting, the Status Panel shows the Instant Messaging card again, this time without the sizes. It tells you which phrase was used to read the line.
If Decrypting Fails
Section titled “If Decrypting Fails”GpgFrontend can only recognise an instant message if you and the sender use the same secret phrase. If the phrases differ, GpgFrontend does not see an instant message at all. It tries to decrypt the line as ordinary text, and you get a normal decryption error.
So if a line from a friend will not decrypt, first check that you both use the same phrase. Compare your Book Fingerprint codes, as described in Share a Secret Phrase.
Share a Secret Phrase
Section titled “Share a Secret Phrase”Without any setup, your messages do not stand out to most people. But anyone who knows GpgFrontend can still tell what they are.
To stop that, you and the person you write to can share a secret phrase. Once you both have the same phrase, your messages look like random text to everyone else.
-
Open Settings. Under Features, choose Instant Messaging.
-
In the Message Book Phrase box, click Generate. A long phrase appears.
-
Click Copy and send the phrase to your friend privately. Do not send it over the chat app you are trying to protect.
-
Click OK to save the phrase. The phrase is only saved when you click OK. Cancel throws it away. On macOS there is no OK button: the phrase is saved when you close the Preferences window.
-
Your friend opens the same page, copies your phrase, clicks Paste, and then clicks OK.
-
You both look at the Book Fingerprint box. It shows a short code made from your phrase. Read the codes out to each other. If they match, you are set. The box has its own Copy button, if you would rather send the code as text.
The fingerprint is safe to say out loud or send anywhere. The phrase is not.
The Message Book Phrase box has these buttons:
- Generate: make a new random phrase.
- Show / Hide: show or hide the phrase.
- Copy: copy the phrase.
- Paste: replace the phrase with the one you copied.
- Clear: remove the phrase and go back to the built-in default.
If you set a phrase in v2.2.2, you do not need to set it again. GpgFrontend moves it over by itself.
What Happens Without a Phrase
Section titled “What Happens Without a Phrase”Nothing breaks. Your message is still properly encrypted, and only the person you sent it to can read it.
The only thing you lose is the disguise. Without a shared phrase, GpgFrontend uses a built-in one that every copy of the program has. So anyone who knows the program can tell your message is an encrypted GpgFrontend message.
When you use IM Encrypt or IM Encrypt & Sign without a phrase, GpgFrontend tells you so in a window called No Message Book Phrase Set. You can choose:
- Open Settings…: open the Settings window. It does not open on the right page by itself. Choose Instant Messaging under Features, and set and save a phrase as shown in Share a Secret Phrase. Then run the action again. Your text is not encrypted in the meantime.
- Continue with Default: encrypt anyway, this time.
- Continue, Don’t Ask Again: encrypt anyway, and stop asking.
- Cancel: stop, and leave your text unchanged.
If the Message Is Too Long
Section titled “If the Message Is Too Long”Instant messages are meant for short notes. If yours is too long, GpgFrontend tells you and leaves your text unchanged.
Either shorten the text, or send it the normal way with Encrypt. There is no length limit on a normal encrypted message.
If Instant Messaging Is Missing
Section titled “If Instant Messaging Is Missing”Instant messaging comes from the InstantMessaging module. If that module is turned off, IM Encrypt, IM Encrypt & Sign and the Instant Messaging settings page all disappear, and Decrypt no longer recognises instant messages. To turn it back on, see Module Controller.
Good to Know
Section titled “Good to Know”- The shared phrase hides what kind of message you are sending. It is not what keeps the message secret. Your OpenPGP keys or your password do that, with or without a phrase.
- The phrase is stored in GpgFrontend’s encrypted storage, never in the plain settings file.
- GpgFrontend keeps one phrase per profile, and uses it for everyone you write to from that profile. If you want a different phrase for each person, you can change the phrase in Settings each time you write to someone else. Or keep a separate profile for each person: each profile remembers its own phrase.