How to convert session information from old TST 0.19.x to new TST 2.x

• On Windows
  • Using pre-built binary
  • Using npm package
• On Linux

(generated by Table of Contents Generator for GitHub Wiki)

Due to limitation of WebExtensions APIs, TST 2.x cannot migrate TST 0.19.x's tree structure information embedded in Firefox's session information. So you need to migrate the session data manually with treestyletab-sessionstore-migrate.

Please note that the sessionstore.jsonlz4 file will be written by Firefox when exiting, so you will have to quit Firefox before running this program. Migration on a running profile will cause data loss!

On Windows

Using pre-built binary

Download the treestyletab-sessionstore-migrate.exe command at first.

Note: If you are using Norton or something other security tool, such a non-signed executable file can be blocked as a dangerous trojan. Then you'll need to disable your security tool or try another way without executable file.

Now you are ready to migrate. Start "command prompt" and go to the profile directory. You can see the path to the profile directory via about:support. Then, put the exe file to there and run it for sessionstore.jsonlz4 and other jsonlz4 files under sessionstore-backup directory, like:

C:\Users\(username)> cd %AppData%\Mozilla\Firefox\Profiles\xxxxx.default
C:...> rename sessionstore.jsonlz4 .\sessionstore.jsonlz4.bak
C:...> move C:\Users\(username)\Downloads\treestyletab-sessionstore-migrate.exe .\
C:...> treestyletab-sessionstore-migrate.exe sessionstore.jsonlz4.bak sessionstore.jsonlz4

...or from backups in folder "sessionstore-backups", e.g.

C:\>cd C:\Users\(username)\AppData\Roaming\Mozilla\Firefox\Profiles\xxxxx.default

C:\Users\(username)\AppData\Roaming\Mozilla\Firefox\Profiles\xxxxx.default>copy sessionstore-backups\previous.jsonlz4 sessionstore.jsonlz4.bak

C:\Users\(username)\AppData\Roaming\Mozilla\Firefox\Profiles\xxxxx.default>rename previous.jsonlz4 sessionstore.jsonlz4.bak

C:\Users\(username)\AppData\Roaming\Mozilla\Firefox\Profiles\xxxxx.default>treestyletab-sessionstore-migrate.exe sessionstore.jsonlz4.bak sessionstore.jsonlz4

Using npm package

Install Node.js 8.6.0 or later at first.

Then start "Node.js command prompt", and install the treestyletab-sessionstore-migrate package globally:

C:\Users\(username)> npm install -g treestyletab-sessionstore-migrate

Now you are ready to migrate. Go to the profile directory. You can see the path to the profile directory via about:support. Then, run the treestyletab-sessionstore-migrate command for sessionstore.jsonlz4 and other jsonlz4 files under sessionstore-backup directory, like:

C:\Users\(username)> cd %AppData%\Mozilla\Firefox\Profiles\xxxxx.default
C:...> rename sessionstore.jsonlz4 .\sessionstore.jsonlz4.bak
C:...> treestyletab-sessionstore-migrate sessionstore.jsonlz4.bak sessionstore.jsonlz4

On Linux

Install Node.js 8.6.0 or later at first. If you are using old Node.js, n Nodde version manager will help you to install newer versions of Node.js. Of source you need to install npm also.

Then install the treestyletab-sessionstore-migrate package globally:

$ sudo npm install -g treestyletab-sessionstore-migrate

Now you are ready to migrate. Go to the profile directory. You can see the path to the profile directory via about:support. Then, run the treestyletab-sessionstore-migrate command for sessionstore.jsonlz4 and other jsonlz4 files under sessionstore-backup directory, like:

$ cd ~/.mozilla/firefox/xxxxx.default/
$ mv sessionstore.jsonlz4 sessionstore.jsonlz4.bak # backup for safety! 
$ treestyletab-sessionstore-migrate sessionstore.jsonlz4.bak sessionstore.jsonlz4