anniegiang / izone-private-mail-archive

Backup your mails from IZ*ONE's Private Mail app

IZ*ONE Private Mail Backup (아이즈원 프라이빗 메일 백업)

A simple script to fetch, save, and view all your private mails.

Table of Contents

Latest release: April 26, 2021 (PST)
README last updated: May 2, 2021 (PST)
End of service: May 31, 2021 23:59 (JST)

• Intro
• Pre-reqs
• Steps
• Folder structure
• Release logs
• Troubleshooting
• Progress

Intro

This script fetches every single mail you have ever received from the members you are subscribed to, and saves each mail as a static HTML file, which is accessible indefinitely. All images are downloaded from PM's server, and saved as an image file. Additionally, a simple HTML file is generated to view mails either by member or all at once. The script will always ensure your inbox is updated and complete at each run-time, which is useful if fetches fail.

Pre-reqs

• npm
• Node.js
• Private Mail user ID (in the app's settings)
• Private Mail acess token
  • Located in the HTTP request header. The header can be captured using a proxy. I created a guide for Android and MacOS users on how to do this.

Steps

0. Make sure you have all the Pre-reqs
1. Clone this repo
   git clone https://github.com/anniegiang/izone-private-mail-archive.git
2. Open userSettings.js and fill in your info:
   
3. npm install
4. npm run start (run this when you want to get the latest mail)

All mails are saved as a static html file in the output folder specified in userSettings.js.

1. View mails all at once or by member by opening out/index.html in the browser.
2. View mails by member out/memberKoreanName/index.html.
3. View mails individually out/memberKoreanName/.

Don't modify anything in the output folder. Always keep the mail id at the start of mail html files, as the script uses them to save mails efficiently, and to know if your inbox is updated or not.

Folder structure

out/index.html => mail viewer to see mails all at once or by member
out/memberKoreanName/index.html => individual mail viewers by member
out/memberKoreanName/ => individual mails by member
out/memberKoreanName/images => individual images by member

Release logs

Pull the master branch for the latest changes.
git pull origin master

4/26/2021

• Navbar of links to see all mails or mails by member. Please delete your output folder and run npm run start.

4/14/2021

• Mail filenames are customizable in userSettings.js (date and subject).

4/11/2021

• Each fetch will not terminate early to ensure your inbox is not only updated, but is also completely full.

4/10/2021

• All mails are viewable in out/index.html. Please delete your output folder and run npm run start.

Troubleshooting

Error saving mail, [Error: EILSEQ: illegal byte sequence]

• This happens if the the mail's filename has emojis. Configure your machine to accept special encoded characters and convert them to be UTF-8. Or, go to userSettings.js and set mailFileName.subject as false to remove the mail subject from the filename.

Progress

• Working on improving speed and performance