Skip to content

Commit

Permalink
Updated README
Browse files Browse the repository at this point in the history
  • Loading branch information
Marcus-L committed Feb 11, 2017
1 parent 236a5fa commit 9df1d26
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
# Chrome Cookie Bakcup
# Chrome Cookie Backup

A Windows Tool for backing up and restoring Chrome's encrypted cookies

## Background:
As of 2/11/2017 (Chrome 56), Chrome on Windows uses [DPAPI](https://msdn.microsoft.com/en-us/library/ms995355.aspx) to encrypt protected data including cookies and saved passwords. DPAPI generates unique encryption keys per user and domain or standalone Windows installation. If you move protected files (e.g. Cookies) to a different user account or a different domain or Windows installation, the protected data will become unusable.

This tool creates a decrypted SQLite backup file of the `Cookies` file in the Chrome User Data Profile folder, using the credentials of the logged on user's profile. The tool can restore from this backup file back into a Chrome User Profile `Cookies` using a different user account or domain or Windows installation, by re-encrypting the data using the other user's credentials.
This tool creates a decrypted SQLite backup file of the `Cookies` file in the Chrome [User Data](https://www.chromium.org/user-experience/user-data-directory) Profile folder, using the credentials of the logged on user's profile. The tool can restore from this backup file back into a Chrome User Profile `Cookies` using a different user account or domain or Windows installation, by re-encrypting the data using the other user's credentials.

## Usage

1. Download or build the tool from source.
1. Build the tool from source or [download the latest release](https://github.com/Marcus-L/chrome-cookie-backup/releases).
2. Run the tool using the Windows user account of the source user/computer and save a backup file
3. Move the `User Data` folder in its entirety to a different user account or Windows installation, or simply create a new profile on the target computer.
4. Run the tool on the target computer using the target user account, and restore the backup to the desired Chrome profile(s). You may map Chrome profiles from the backup file to profiles on the target computer.
Expand All @@ -21,7 +21,7 @@ This tool creates a decrypted SQLite backup file of the `Cookies` file in the Ch
* DPAPI .NET Wrapper System.Security.Cryptography.ProtectedData docs: https://msdn.microsoft.com/en-us/library/system.security.cryptography.protecteddata(v=vs.110).aspx

### Built With
* Visual Studio 2015 or 2017
* Visual Studio 2017 RC
* .NET Framework 4.5.2
* [System.Data.Sqlite](https://system.data.sqlite.org/) - ADO.NET provider for SQLite (Chrome stores cookies in a SQLite database)
* [Json.NET](http://www.newtonsoft.com/json) - For reading Chrome profile Preferences Json
Expand Down

0 comments on commit 9df1d26

Please sign in to comment.