Transport Neutral Encapsulation Format Explained

Transport Neutral Encapsulation Format or TNEF is a proprietary email attachment format used by Microsoft Outlook and Microsoft Exchange Server. An attached file with TNEF encoding is most often named winmail.dat or win.dat, and has a MIME type of Application/MS-TNEF.The official (IANA) media type, however, is application/vnd.ms-tnef.^[1]

Overview

Some TNEF files contain information used only by Outlook to generate a richly formatted view of the message, such as embedded (OLE) documents or Outlook-specific features such as forms, voting buttons, and meeting requests. Other TNEF files may contain files which have been attached to an e-mail message.

Within the Outlook e-mail client, TNEF encoding cannot be explicitly enabled or disabled (except via a registry setting^[2]). Selecting RTF as the format for sending an e-mail implicitly enables TNEF encoding, using it instead of the more common and widely compatible MIME standard. When sending plain text or HTML format messages, some versions of Outlook (apparently including Outlook 2000) prefer MIME, but may still use TNEF under some circumstances (for example, if an Outlook feature requires it).^{[3] [4]}

TNEF attachments can contain security-sensitive information such as user login name and file paths,^{[3] [4]} from which access controls could possibly be inferred.

Exchange Server

Native-mode Microsoft Exchange 2000 organizations will, in some circumstances, send entire messages as TNEF-encoded raw binary independent of what is advertised by the receiving SMTP server. As documented in Microsoft KBA #323483,^[5] this technique is not RFC-compliant because these messages have the following characteristics:

• They may include non-ASCII characters outside the 0–127 US-ASCII range.
• The lines in these messages are often too long for transport via SMTP.
• They do not follow the CRLF.CRLF message termination semantics as specified in RFC 821.

Internal communications between Exchange Servers (2000 and later) over SMTP encode the message in S/TNEF (Summary TNEF) format. The conversion between the format needed by the end client on the Internet is performed on the last Hub Transport server before final delivery, and when the Hub Transport role of an Exchange Server is about to deliver the message to a mailbox role server, the message is converted to MAPI format for storage.

S/TNEF differs from TNEF in that it is 8-bit (not 7-bit for TNEF) and does not contain a plain-text portion.

Decoding

Programs to decode and extract files from TNEF-encoded attachments are available on many platforms.

Multiplatform

• Geary (email client) supports TNEF since version 3.33.1
• TNEF Parse – Claws Mail plugin^[6]
• LookOut^[7] or its successor LookOut (fix version)^[8] – Mozilla Thunderbird extension. See also:
  • LookOut project page at MozDev.org^[9]
  • Bug 77811 – Inline viewer for Microsoft proprietary mail formats, a 21-plus-year-old bug report at the Mozilla Bugzilla^[10]
• Wireshark – Version 1.2 and later can open and dissect winmail.dat files, although it is not useful as a mail reader
• KTNEF – LGPL TNEF extractor by KDE^[11]

Unix-like or POSIX command-line

• yTNEF – GPL TNEF extractor from the POSIX command-line, designed specifically for reading winmail.dat^[12]
• TNEF – GPL TNEF extractor from the POSIX command-line^[13]

Mac

• Klammer – Shareware for Mac OS X, available on App store; also supports MSG files^[14]
• MailRaider Pro - Application for Mac OS X, available on App store; also supports MSG files^[15]
• Winmail Viewer – Shareware Winmail.dat viewer for Mac OS X 10.6 or later, available on App Store, support open Microsoft Outlook (1997, 2000, 2003, 2007, 2010). Winmail.dat files, can extract and save Winmail.dat attachments^[16]
• TNEF's Enough – Freeware decoder for Mac OS 9 and Mac OS X^[17]
• tnefDD – Free GPL decoder with drag-and-drop functionality for Mac OS X^[18]
• TNEF – MacPorts version of the TNEF command-line decoder Mac OS X^[19]
• Letter Opener (previously known as OMiC) – Shareware, plugin for Apple Mail^[20]

iPhone and iPad

• Winmail File Viewer – Paid universal app for the iPhone, iPod Touch and iPad to open winmail.dat attachments with option to save and share extracted files^[21]
• WinMail.dat Viewer - Browse Outlook winmail.dat files – Paid universal app for the iPhone, iPod Touch and iPad to open winmail.dat attachments with option to view, save and share extracted files^[22]
• Winmail File Viewer+ – Paid universal app for the iPhone, iPod Touch and iPad to open winmail.dat attachments with option to save and share extracted files^[23]
• Klammer - open EML, MSG and Winmail.dat files – Paid universal app for the iPhone, iPod Touch and iPad with in-app purchase to provide functionality^[24]
• WinDat Opener – Paid app for the iPhone, iPod Touch and iPad^[25]
• Letter Opener – Free Universal app for the iPhone, iPod Touch and iPad with in-app purchase to provide functionality^[26]
• TNEF's Enough - Free Universal app for iPhone, iPod Touch, and iPad^[27]

Microsoft Windows

• Winmail.dat Reader – Freeware easy-to-use decoder^[28]
• Winmail Opener – Freeware decoder^[29]
• tnef2win – Freeware decoder^[30]
• Free File Viewer – Freeware decoder^[31]
• fentun – Freeware decoder^[32]
• Winmail.dat Viewer – modern Windows 8 app (non-free)^[33]

Android

• TNEF Extractor – A free and open source (GPLv3) Android app^[34]
• Opener – A free Android app^[35]
• Reader - Free Android app also available^[28]

Online

• winmail.dat extractor and document converter – Free, in modern, responsive theme^[36]
• Reader Online – The online version of the Winmail.dat Reader (free)^[37]
• tud.at service – Web service and GPL licensed PHP script for reading attachments in winmail.dat files^[38]
• www.winmaildat.com – Another online winmail.dat extractor which allows to upload up to 5 MB^[39]
• the-computer-site.com – converts winmail.dat file to a zip file^[40]

Software libraries

• JTNEF – GPL Java TNEF package^[41]
• POI-HMEF – Java library of the Apache POI project^[42]
• MVCOM – Commercial COM component to parse TNEF^[43]
• Convert::TNEF – TNEF library written in Perl^[44]
• tnefparse library – TNEF access library written in Python, licensed under LGPL^[45]
• Aspose Email – Commercial Java and .NET library that can parse and extract TNEF data^[46]
• EAGetMail Component – Commercial .NET and ActiveX library that can parse and extract TNEF data^[47]
• node-tnef - NodeJS command line tool/library that can parse and extract TNEF data^[48]
• libytnef – GPL TNEF extractor library written in C^[12]
• MimeKit – A .NET MIME creation and parser library with support for TNEF^[49]
• TNEF Decoder - A PHP Library to extract TNEF^[50]

References

1. Web site: Some Microsoft Media Types for registration. IANA. October 25, 2010.
2. Web site: When you use Outlook 2007 to send an e-mail message, the recipient of the message sees an attachment that is called Winmail.dat. Microsoft. July 29, 2009. March 3, 2011.
3. Web site: Description of Transport Neutral Encapsulation Format (TNEF) in Outlook 2000. Microsoft. September 11, 2009. September 4, 2009. https://web.archive.org/web/20090904213017/http://support.microsoft.com/kb/241538. dead.
4. Web site: How e-mail message formats affect Internet e-mails in Outlook. Microsoft. 2005-03-30. October 13, 2006.
5. http://support.microsoft.com/kb/323483 Microsoft KBA #323483
6. Web site: Claws Mail - Plugins. www.Claws-Mail.org. December 23, 2017.
7. Web site: LookOut. addons.Mozilla.org. September 30, 2011 . December 23, 2017.
8. Web site: LookOut (fix version). addons.Mozilla.org. December 23, 2017.
9. Web site: mozdev.org - lookout: index. lookout.MozDev.org. December 23, 2017. December 24, 2017. https://web.archive.org/web/20171224213807/http://lookout.mozdev.org/. dead.
10. Web site: 77811 - Inline viewer for Microsoft proprietary mail formats (ms-tnef, etc.) ["winmail.dat"]]. bugzilla.Mozilla.org. December 23, 2017.
11. Web site: KTnef. KDE Gitlab.
12. Web site: ytnef: Yeraze's TNEF Stream Reader - for winmail.dat files. Yeraze. November 21, 2017. December 23, 2017. GitHub.
13. Web site: tnef. Mark. Simpson. December 8, 2017. December 23, 2017. GitHub.
14. Web site: Klammer on the Mac App Store. Mac App Store. December 23, 2017.
15. Web site: MailRaider Pro on the Mac App Store. Mac App Store. December 23, 2017.
16. Web site: Winmail Viewer - Open and Read Winmail.dat Files on the Mac App Store. Mac App Store. December 23, 2017.
17. Web site: Josh Jacob - TNEF's Enough. www.JoshJacob.com. December 23, 2017.
18. Web site: tnefDD. SourceForge.net. December 23, 2017.
19. Web site: The MacPorts Project -- Available Ports. Jim Mock. ([e-mail]). www.MacPorts.org. December 23, 2017.
20. Web site: Letter Opener. Restoroot.org. December 23, 2017. dead. https://web.archive.org/web/20061102080739/http://www.restoroot.org/OMiC/. November 2, 2006. mdy-all.
21. Web site: Winmail File Viewer on the App Store. App Store. January 8, 2018.
22. Web site: WinMail.dat Viewer for OS 10 on the App Store. App Store. July 11, 2017 . January 8, 2018.
23. Web site: Winmail Viewer for iPhone and iPad on the App Store. App Store. July 12, 2017 . January 8, 2018.
24. Web site: Klammer on the App Store. App Store. January 8, 2018.
25. Web site: WinDat Opener on the App Store. App Store. January 8, 2018.
26. Web site: Connecting to the iTunes Store.. iTunes.apple.com. January 8, 2018.
27. Web site: TNEF's Enough. App Store. February 2, 2020 . en-us. 2020-03-17.
28. Web site: Winmail.dat Reader - Open winmail.dat files (Freeware). www.Winmail-dat.com. December 23, 2017.
29. Web site: Winmail Opener - freeware utility for opening winmail.dat and other TNEF-encoded files. www.Eolsoft.com. December 23, 2017.
30. Web site: tnef(TO)win, convert mstnef-attachments. Frank. Petersen. www.Petersen.de. December 23, 2017.
31. Web site: PDF, DOC, DOCX, DAT, BIN, PHP Viewer - FreeFileViewer. www.FreeFileViewer.com. December 23, 2017.
32. Web site: Welcome to Fentun's Home Page. www.Fentun.com. December 23, 2017. November 26, 2004. https://web.archive.org/web/20041126072804/http://www.fentun.com/. dead.
33. Web site: Get Winmail.dat Viewer - Letter Opener - Microsoft Store. Microsoft Store. December 23, 2017.
34. Web site: Tools / TNEF Extractor · GitLab. June 22, 2020.
35. Web site: Winmail.dat Opener. Google.com. December 23, 2017.
36. Web site: Free Online Document Converter. Milos Wikarski. grapph.com. doc2any.Grapph.com. December 23, 2017.
37. Web site: Online version - Winmail.dat Reader. www.Winmail-dat.com. December 23, 2017.
38. Web site: MS-TNEF degenerator. tud.at. December 23, 2017.
39. Web site: www.winmaildat.com. Winmaildat.com. December 23, 2017.
40. Web site: the-computer-site.com - The Computer Site - Extract Attachments from WINMAIL.DAT files. The-Computer-Site.com. December 23, 2017.
41. Web site: JTNEF - Java TNEF package. www.FreeUtils.net. January 8, 2018.
42. Web site: POI-HMEF - Java API To Access Microsoft Transport Neutral Encoding Files (TNEF). poi.Apache.org. January 8, 2018. January 14, 2018. https://web.archive.org/web/20180114215100/http://poi.apache.org/hmef/index.html. dead.
43. Web site: MVCOM - MAPI-Free COM component for Outlook .pst, .msg, .ost.. www.Encryptomatic.com. January 8, 2018.
44. Web site: Convert::TNEF - Perl module to read TNEF files - metacpan.org. Metacpan.org. January 8, 2018.
45. Web site: tnefparse: a TNEF decoding library written in python, without external dependencies. October 18, 2017. January 8, 2018. GitHub.
46. Web site: Outlook Alternative - Email APIs for .NET Java Android SharePoint Cloud. Farrukh. Sheikh. www.Aspose.com. January 8, 2018. February 27, 2017. https://web.archive.org/web/20170227084249/https://www.aspose.com/products/email. dead.
47. Web site: IMAP4 Component, POP3 Component, Email Parser for C#, VB, C++, Delphi - Retrieve Email, Parse Email, Decrypt Email, S/MIME, Parse winmail.dat, TNEF, Parse Outlook Msg, SSL, TLS. www.EmailArchitect.net. January 8, 2018.
48. Web site: node-tnef. John. Murphy. August 31, 2018.
49. Web site: MimeKit.Tnef Namespace . 2022-12-22 . www.mimekit.net.
50. Web site: github.com/QualityUnit/TNEFDecoder . .

External links

• Specification:
  • "M-OXTNEF: Transport Neutral Encapsulation Format (TNEF) Data Algorithm" - MS-TNEF format specifications
• Microsoft Support:
  • "How e-mail message formats affect Internet e-mails in Outlook" - How to disable TNEF in Outlook 2002 and 2003
  • "Description of Transport Neutral Encapsulation Format (TNEF) in Outlook 2000" - How to disable TNEF in Outlook 2000
  • "How to configure Internet e-mail message formats at the user and the domain levels in Exchange Server 2003" - Includes instructions on disabling TNEF
• Other:
  • "Microsoft Outlook MS-TNEF handling (aka Winmail.dat or 'Part 1.2' problem of unopenable email attachments)"