Manatee

An ODT file that will not open on a Mac, and how to read it

· 6 min read

An .odt file is an OpenDocument Text document, the default format of several free office suites. Your Mac can read one without installing anything: TextEdit opens ODT files and can save them as DOCX, RTF or PDF. If double-clicking gets you nowhere, it is usually because no app is set to open that extension, not because the file is broken. When the file really is damaged, there are still a few ways to get the text back.

What an ODT file is

OpenDocument is an open standard for office files: .odt for text documents, .ods for spreadsheets and .odp for presentations. It turns up from schools, public bodies and anyone who writes in a free office suite.

Like a DOCX, an ODT is a ZIP archive of XML files wearing a different extension. Inside, content.xml holds the text, styles.xml the formatting, a Pictures folder any images, and a plain file called mimetype sits at the very front declaring what the document is. That structure matters later, because it is also how a damaged ODT can be taken apart and read.

Open it with TextEdit

  1. Right-click the file in Finder and choose Open With, then TextEdit.
  2. If TextEdit is not in the list, choose Other, select TextEdit in the Applications folder, and click Open.
  3. To make TextEdit open every ODT file from now on, select the file, press Command-I, choose TextEdit under “Open with”, and click Change All.

TextEdit is a rich text editor rather than a full word processor, so set your expectations accordingly. Text, fonts, bold and italic, paragraph styles, lists and simple tables come through. Complex page layouts, headers and footers, comments, tracked changes and embedded charts may be simplified or left out, and images may not survive. For a letter, a form or an essay, that is usually everything you need. For a heavily designed document, read it in TextEdit and ask the sender for a PDF if the layout matters.

Save a copy you can use elsewhere

Once the document is open in TextEdit, you can turn it into a format more apps accept:

  1. Choose File, Duplicate, so the original stays as it was.
  2. Choose File, Save, and open the File Format menu.
  3. Pick the DOCX option for a document others can edit, or Rich Text Document for the most basic formatted text.

For a copy that looks the same everywhere, choose File, Export as PDF instead. If all you want is the words, choose Format, Make Plain Text before saving. Turning a text file into a DOCX and converting a DOCX to RTF cover the next steps if you need to move between formats again.

To send an edited version back to someone who uses OpenDocument, the same File Format menu includes OpenDocument Text, so the round trip works.

Spreadsheets and presentations are harder

TextEdit handles text documents only. An .ods spreadsheet or an .odp presentation needs an office suite that reads OpenDocument, and most full office suites, including free ones, do. If you only need to see the contents, the quickest answer is often to ask the sender for a PDF of a presentation or a CSV of a spreadsheet, both of which your Mac opens directly.

When the file really is damaged

Signs that the problem is the file rather than the app: TextEdit reports that the document could not be opened, the file is zero bytes or only a few kilobytes, or it fails in every app you try. Check what it is in Terminal. Type file, a space, drag the ODT into the window and press Return:

file ~/Downloads/minutes.odt

A healthy file reports OpenDocument Text. A report of plain data, or of some other format, means the file is not what its name says or its opening bytes are damaged. Next, list its contents:

unzip -l ~/Downloads/minutes.odt

You should see mimetype, content.xml, styles.xml and META-INF/manifest.xml. An error about a missing end-of-central-directory signature means the archive was cut short, usually by an interrupted download or copy.

Then work through these in order:

  1. Get a fresh copy. Ask the sender to send it again, or download it again, and compare the size with the original. Verifying a file arrived intact shows how to check a copy properly.
  2. Rebuild the archive yourself. The zip tool built into macOS can scan a damaged archive and write a new one from the parts it finds. Run zip -FF ~/Downloads/minutes.odt --out ~/Downloads/minutes-fixed.odt, answer its questions, then try opening the new file in TextEdit.
  3. Read the text by hand. If the rebuilt file opens nowhere but content.xml survived, extract it and open it in TextEdit. The words are all there, surrounded by tags, which is ugly but readable.
  4. Let a repair tool do it. Manatee repairs ODT, ODS and ODP files at the container level, the same way it handles DOCX. Drag the file onto its menu bar icon or into its window. It reads the archive entry by entry, keeps what is intact, and writes a new file beside the original, which it never modifies. The result is reported honestly as Fixed, Partial or Not fixable, and nothing is uploaded. Manatee repairs the file rather than editing it, so open the repaired copy in TextEdit as above.

Some things no repair can bring back: if the document’s text was in the part of the file that never arrived, it is gone, and a Partial result will say so rather than pretend. Why files get corrupted explains where that line falls.

Questions

Is an ODT file safe to open? Documents from office suites can carry macros, but TextEdit does not run them. Opening an ODT in TextEdit shows you the text and formatting and nothing else.

Why does the ODT show a blank icon in Finder? Usually because no app on the Mac has claimed the extension as its default. Setting TextEdit as the default with Get Info, as above, gives the file an icon and makes double-clicking work.

Can I convert an ODT to PDF without installing anything? Yes. Open it in TextEdit and choose File, Export as PDF. The PDF will reflect what TextEdit displays, so check it before sending if the original had a complex layout.