Solved: Google Takeout mbox file too big to open

The problem: your Google Takeout mbox will not open

You downloaded a copy of your Gmail through Google Takeout. What you get back is an mbox file: a single file that holds all of your emails stacked one after another. With a full inbox that can easily reach several gigabytes, sometimes tens of gigabytes.

Try to open that file in Thunderbird, Apple Mail or Outlook and one of these things usually happens:

• The program freezes or crashes the moment you import the file.
• The import runs forever and seems to hang.
• Your computer slows to a crawl because the entire file is loaded into working memory at once.
• You get an error that the file is too large or corrupt.

The cause is almost always the same: ordinary mail programs try to read the whole archive in one go. With a few hundred messages that is fine, with hundreds of thousands of messages it is not.

What a viewer with a memory limit does differently

Mbox Viewer by Cloud Captains is a Chrome extension (Manifest V3) built specifically to keep large mail archives manageable. Its homepage is mbox-viewer.online. The trick comes down to two things.

An in-memory limit. The settings include a cap on how many messages may sit in active working memory at the same time. So the viewer does not pull your entire ten-gigabyte archive in at once, it works in manageable chunks. That keeps Chrome responsive, even with a huge file.

A local database. As soon as a message has been read, it is stored in IndexedDB, the database that runs inside your browser on your own device. Your archive therefore lives in a database built to hold a lot of data, not in volatile working memory. Browsing, searching and filtering then run against that database instead of against the raw file.

Google Takeout often hands you a .mbox.gz

Google Takeout sometimes gives you your mail packed as a .mbox.gz. That is an mbox file compressed with gzip, so the download is smaller. Many mail programs do not understand a .gz file and ask you to unpack it by hand first.

Mbox Viewer unpacks .mbox.gz automatically the moment you drop it into the window, so you do not need a separate extraction tool. The unpacking also happens locally in your browser, not somewhere online.

Finding something fast in a huge archive

With an enormous archive, searching matters more than browsing. Mbox Viewer has a search bar with operators that let you filter very precisely. A few examples:

• from:name@example.com searches by sender, to: by recipient.
• subject:invoice searches the subject line.
• has:attachment shows only messages with an attachment, has:link only messages with a link.
• after:2020-01-01 and before:2021-01-01 limit to a period, as do older_than:30d and newer_than:7d.
• larger:5M and smaller:1M filter by size.
• "exact phrase" searches for precise text and NOT term excludes something.

There is also a regex mode for advanced patterns, and you can save searches so you do not have to retype a frequently used filter every time.

What else you can do afterwards

Once your archive is in the viewer, you can organize messages with labels, stars and notes (Captain notes). You can export single messages or a whole selection, for example as PDF, .eml, .html or as a CSV with metadata. For investigation there is a Forensic tab that shows, among other things, the authentication (SPF, DKIM, DMARC), the transport chain and a suspicion score.

External images are blocked by default while reading, so tracking pixels cannot follow you. If you do want to see the images in a specific message, you load them with a button.