Difference between revisions of "Jabber Email Header"
m (remove tab) |
|||
(26 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
Tell the world that you use | Tell the world that you use XMPP by including a "Jabber-ID" header in your outgoing email. This page describes how to set that up in various email clients. (Feel free to add the config for your email client, just put them in alphabetical order please. :-) | ||
Note well: RFC | Note well: RFC 5322 does not allow anything but US-ASCII text in email headers, so if you have a Jabber ID with Unicode characters in it, you will need to escape those! See the [https://datatracker.ietf.org/doc/draft-saintandre-jabberid/ Internet-Draft] for details. | ||
== Claws Mail == | |||
In [https://www.claws-mail.org/ Claws Mail], do the following: | |||
# Configuration > Preferences > Message View > Text options | |||
# Select Display headers in message view | |||
# Add the "Jabber-ID" header | |||
For adding the header in outgoing mails do the following: | |||
# Click Configuration > Edit Accounts > Edit | |||
# Select Send/Add user defined header | |||
# Choose the "Jabber-ID" header | |||
# Add the "Jabber-ID" header | |||
== Emacs == | == Emacs == | ||
Line 7: | Line 22: | ||
If you use mail-mode for composing mail, this should do the trick: | If you use mail-mode for composing mail, this should do the trick: | ||
(setq mail-default-headers | (if (not (string-match "Jabber-ID" mail-default-headers)) | ||
(setq mail-default-headers | |||
(concat "Jabber-ID: your-jid-here\n" | |||
mail-default-headers))) | |||
If you use message-mode for composing mail (which you do if you use Gnus for reading mail), this should do the trick: | If you use message-mode for composing mail (which you do if you use Gnus for reading mail), this should do the trick: | ||
(setq message-default-headers | (if (not (string-match "Jabber-ID" message-default-headers)) | ||
(setq message-default-headers | |||
(concat "Jabber-ID: your-jid-here\n" | |||
message-default-headers))) | |||
This works for mu4e: | |||
(add-hook 'mu4e-compose-mode-hook | |||
(defun my-add-jabberid () | |||
"Add a Jabber-ID header." | |||
(save-excursion (message-add-header (format "Jabber-ID: %s\n" "my-jid@my-server"))))) | |||
=== Displaying the header === | |||
This works in mu4e >= 1.12: | |||
(add-to-list 'mu4e-header-info | |||
'(:jabber-id :name "Jabber-ID" :shortname "JID" :help "The Jabber ID" :sortable t)) | |||
(add-to-list 'mu4e-header-info-custom | |||
'(:jabber-id . | |||
( :name "Jabber-ID" | |||
:shortname "JID" | |||
:help "The Jabber ID" | |||
:function (lambda (msg) | |||
(or (mu4e-fetch-field msg "Jabber-ID") ""))))) | |||
(setq mu4e-view-fields | |||
'(:from :to :cc :subject :flags :date :maildir :mailing-list :tags :jabber-id)) | |||
== Evolution == | |||
In [https://wiki.gnome.org/Apps/Evolution Evolution], do the following ([https://help.gnome.org/users/evolution/stable/mail-composer-custom-header-lines.html.en source]): | |||
# Select Edit > Plugins | |||
# Enable Custom Header | |||
# Click the Configuratin tab. | |||
# Add the "Jabber-ID" header | |||
For adding the header in outgoing mails do the following: | |||
# Click New > Mail Message | |||
# Select Insert > Custom Header | |||
# Choose the "Jabber-ID" header | |||
== KMail == | |||
In [http://kmail.kde.org/ KMail], do the following: | |||
# Select Settings > Configure KMail | |||
# Go to the Composer category | |||
# Select the Headers tab (some versions call this 'Message List') | |||
# Click on New | |||
# In the Name: field, type "Jabber-ID" | |||
# In the Value: field, type "[your-jid-here]" | |||
# Click OK | |||
== Mail.app == | == Mail.app == | ||
Line 22: | Line 89: | ||
# Open a terminal window | # Open a terminal window | ||
# Construct a command like: | # Construct a command like: | ||
defaults write com.apple.mail UserHeaders '{"Jabber-ID" = "your-jid-here";}' | |||
== Mutt == | == Mutt == | ||
Line 29: | Line 97: | ||
# Open your .muttrc file | # Open your .muttrc file | ||
# In the Composing section (or wherever) add a line that reads | # In the Composing section (or wherever) add a line that reads | ||
my_hdr Jabber-ID: your-jid-here | |||
=== Displaying the header === | |||
To show the header for incoming mails add the following to the .muttrc file: | |||
unignore Jabber-ID | |||
== Thunderbird == | == Thunderbird == | ||
Line 37: | Line 110: | ||
# Open the Preferences | # Open the Preferences | ||
# Click the Advanced tab | # Click the Advanced icon | ||
# Click the General tab | |||
# Click the Config Editor button | # Click the Config Editor button | ||
# Right-click anywhere in the about:config window | # Right-click anywhere in the about:config window | ||
# Select New -> String | # Select New -> String | ||
# For the preference name, type | # For the preference name, type <code>mail.identity.id.header.jid</code> | ||
# For the preference value, type | # For the preference value, type <code>Jabber-ID: your-jid-here</code> | ||
# That's the first pref; now right-click anywhere in the about:config window | # That's the first pref; now right-click anywhere in the about:config window | ||
# Select New -> String | # Select New -> String | ||
# For the preference name, type | # For the preference name, type <code>mail.identity.id.headers</code> | ||
# For the preference value, type | # For the preference value, type <code>jid</code> | ||
# If you have multiple accounts in Thunderbird, differentiate them with mail.identity.id1... and mail.identity.id2 (etc.) | # If you have multiple accounts in Thunderbird, differentiate them with mail.identity.id1... and mail.identity.id2 (etc.) | ||
Note: | Note: In the preference name for Step 7 and the preference value for Step 12, the string "jid" can be anything, as long as the string is the same for both. | ||
=== Displaying the header === | |||
The preference <code>mailnews.headers.extraExpandedHeaders</code> is a list of '''space'''-delimited additional headers to be shown in the header section of the message pane. To show the <code>Jabber-ID</code> header on messages, just add <code>Jabber-ID</code> to this preference. | |||
== Mail Gateways == | |||
More e-mail header information in [[Email Gateway]] page. |
Latest revision as of 23:00, 5 May 2024
Tell the world that you use XMPP by including a "Jabber-ID" header in your outgoing email. This page describes how to set that up in various email clients. (Feel free to add the config for your email client, just put them in alphabetical order please. :-)
Note well: RFC 5322 does not allow anything but US-ASCII text in email headers, so if you have a Jabber ID with Unicode characters in it, you will need to escape those! See the Internet-Draft for details.
Claws Mail
In Claws Mail, do the following:
- Configuration > Preferences > Message View > Text options
- Select Display headers in message view
- Add the "Jabber-ID" header
For adding the header in outgoing mails do the following:
- Click Configuration > Edit Accounts > Edit
- Select Send/Add user defined header
- Choose the "Jabber-ID" header
- Add the "Jabber-ID" header
Emacs
If you use mail-mode for composing mail, this should do the trick:
(if (not (string-match "Jabber-ID" mail-default-headers)) (setq mail-default-headers (concat "Jabber-ID: your-jid-here\n" mail-default-headers)))
If you use message-mode for composing mail (which you do if you use Gnus for reading mail), this should do the trick:
(if (not (string-match "Jabber-ID" message-default-headers)) (setq message-default-headers (concat "Jabber-ID: your-jid-here\n" message-default-headers)))
This works for mu4e:
(add-hook 'mu4e-compose-mode-hook (defun my-add-jabberid () "Add a Jabber-ID header." (save-excursion (message-add-header (format "Jabber-ID: %s\n" "my-jid@my-server")))))
Displaying the header
This works in mu4e >= 1.12:
(add-to-list 'mu4e-header-info '(:jabber-id :name "Jabber-ID" :shortname "JID" :help "The Jabber ID" :sortable t)) (add-to-list 'mu4e-header-info-custom '(:jabber-id . ( :name "Jabber-ID" :shortname "JID" :help "The Jabber ID" :function (lambda (msg) (or (mu4e-fetch-field msg "Jabber-ID") ""))))) (setq mu4e-view-fields '(:from :to :cc :subject :flags :date :maildir :mailing-list :tags :jabber-id))
Evolution
In Evolution, do the following (source):
- Select Edit > Plugins
- Enable Custom Header
- Click the Configuratin tab.
- Add the "Jabber-ID" header
For adding the header in outgoing mails do the following:
- Click New > Mail Message
- Select Insert > Custom Header
- Choose the "Jabber-ID" header
KMail
In KMail, do the following:
- Select Settings > Configure KMail
- Go to the Composer category
- Select the Headers tab (some versions call this 'Message List')
- Click on New
- In the Name: field, type "Jabber-ID"
- In the Value: field, type "[your-jid-here]"
- Click OK
Mail.app
In Apple's Mail.app program, do the following:
- Open a terminal window
- Construct a command like:
defaults write com.apple.mail UserHeaders '{"Jabber-ID" = "your-jid-here";}'
Mutt
In Mutt, do the following:
- Open your .muttrc file
- In the Composing section (or wherever) add a line that reads
my_hdr Jabber-ID: your-jid-here
Displaying the header
To show the header for incoming mails add the following to the .muttrc file:
unignore Jabber-ID
Thunderbird
In Thunderbird, you need to define two separate config options, so do the following:
- Open the Preferences
- Click the Advanced icon
- Click the General tab
- Click the Config Editor button
- Right-click anywhere in the about:config window
- Select New -> String
- For the preference name, type
mail.identity.id.header.jid
- For the preference value, type
Jabber-ID: your-jid-here
- That's the first pref; now right-click anywhere in the about:config window
- Select New -> String
- For the preference name, type
mail.identity.id.headers
- For the preference value, type
jid
- If you have multiple accounts in Thunderbird, differentiate them with mail.identity.id1... and mail.identity.id2 (etc.)
Note: In the preference name for Step 7 and the preference value for Step 12, the string "jid" can be anything, as long as the string is the same for both.
Displaying the header
The preference mailnews.headers.extraExpandedHeaders
is a list of space-delimited additional headers to be shown in the header section of the message pane. To show the Jabber-ID
header on messages, just add Jabber-ID
to this preference.
Mail Gateways
More e-mail header information in Email Gateway page.