@@ -6,6 +6,33 @@ Export [Firefox][] [session][]s to plain text.

 [Firefox]: https://en.wikipedia.org/wiki/Firefox

 [session]: https://support.mozilla.org/kb/how-restore-browsing-session-backup#w_restoring-from-a-backup-file

+## Requirements

+

+All of these are packaged in [Debian][].

+

+-   [POSIX][]-compatible [shell][]

+-   [`lz4json`][]

+-   [`jq`][]

+

+[Debian]: https://en.wikipedia.org/wiki/Debian

+[POSIX]: https://en.wikipedia.org/wiki/POSIX

+[shell]: https://en.wikipedia.org/wiki/Unix_shell

+[`lz4json`]: https://github.com/andikleen/lz4json

+[`jq`]: https://jqlang.org

+

+## References

+

+Relevant directories, files, and code in the [Firefox source][]:

+

+-   [`browser/components/sessionstore/`][]

+    -   [`session.schema.json`][]: JSON schema used by session stores.

+    -   [`SessionFile.sys.mjs` `SessionFileInternal.Paths`][]: JSON schema used by session stores.

+

+[Firefox source]: https://github.com/mozilla-firefox/firefox

+[`browser/components/sessionstore/`]: https://github.com/mozilla-firefox/firefox/blob/main/browser/components/sessionstore/

+[`session.schema.json`]: https://github.com/mozilla-firefox/firefox/blob/FIREFOX_141_0_RELEASE/browser/components/sessionstore/session.schema.json

+[`SessionFile.sys.mjs` `SessionFileInternal.Paths`]: https://github.com/mozilla-firefox/firefox/blob/FIREFOX_141_0_RELEASE/browser/components/sessionstore/SessionFile.sys.mjs#L69

+

 ## License

 Licensed under the [ISC License][] unless otherwise noted, see the

new file mode 100755

@@ -0,0 +1,75 @@

+#!/bin/sh

+set -euC

+

+# Usage: firefox-session-export [<file>]

+

+file="${1:-}"

+if ! [ "$file" ]

+then

+  for file_ in \

+    "$HOME/.mozilla/firefox/"*default*'/sessionstore.jsonlz4' \

+    "$HOME/.mozilla/firefox/"*default*'/sessionstore-backups/recovery.jsonlz4' \

+    "$HOME/.mozilla/firefox/"*default*'/sessionstore-backups/previous.jsonlz4' \

+    "$HOME/.mozilla/firefox/"*default*'/sessionstore-backups/recovery.baklz4'

+  do

+    [ -r "$file_" ] || continue

+    file="$file_" && break

+  done

+fi

+if ! [ "$file" ]

+then

+  echo 'Could not find session.' >&2

+  exit 1

+fi

+

+# session="$(basename "$file")"

+session="${file#$HOME/.mozilla/firefox/}"

+lz4jsoncat "$file" | jq --arg session "$session" --raw-output '

+  def time:

+    . / 1000 | strflocaltime("%Y-%m-%d %H:%M:%S");

+

+  def entry($isSelected; $lastAccessed):

+    (($isSelected | select(.) | "**") // "") as $bold |

+    ("\($lastAccessed | time): "?     // "") as $time |

+    "\($bold)\($time)[\(.title | @html)](\(.url))\($bold)";

+

+  def tabs($selected):

+    to_entries[] | (.key + 1) as $id | .value |

+    ($id == $selected) as $isSlected |

+    .lastAccessed      as $lastAccessed |

+    .entries | reverse |

+      (.[0]    | "-   \(entry($isSlected; $lastAccessed))"),

+      (.[1:][] | "    -   \(entry(false; null))");

+

+  def windows:

+    to_entries[] | (.key + 1) as $id | .value |

+    .selected as $selected |

+      "### Window \($id)",

+      "",

+      "#### Open tabs",

+      "",

+      (.tabs | tabs($selected)),

+      "",

+      "#### Closed tabs",

+      "",

+      ([._closedTabs[].state] | tabs(0)),

+      "";

+

+  def session($session):

+    "# Session `\($session)`",

+    "",

+    "|             |                     |",

+    "| ---         | ---                 |",

+    "| Start       | \(.session.startTime  | time) |",

+    "| Last update | \(.session.lastUpdate | time) |",

+    "",

+    "## Open windows",

+    "",

+    (.windows | windows),

+    "",

+    "## Closed windows",

+    "",

+    (._closedWindows | windows);

+

+  session($session)

+'