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.

On Windows

Using pre-built binary

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

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

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