Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lemnos/chrome-session-dump

A program for extracting information from chrome session files.
https://github.com/lemnos/chrome-session-dump

chrome chromium session snss

Last synced: 9 days ago
JSON representation

A program for extracting information from chrome session files.

Awesome Lists containing this project

README

        

# What

A tool for dumping the contents of chrome session files.

# Why?

Most tools for reading SNSS files (chrome session files) are either broken or
outdated. This tool aims to facilitate scripting by providing a clean way of
extracting useful information (like the active tab) from a running or saved
chrome session. You could, for instance, use the tool to extract the current
page within an external script and download its contents to disk or
store it inside a bookmark file.

# Installation

## From Source

```
make && sudo make install
```

Binaries are also available for linux and macOS.

## Linux

```
sudo curl -o /usr/bin/chrome-session-dump -L 'https://github.com/lemnos/chrome-session-dump/releases/download/v0.0.2/chrome-session-dump-linux' && sudo chmod 755 /usr/bin/chrome-session-dump
```

## macOS

```
sudo curl -o /usr/bin/chrome-session-dump -L 'https://github.com/lemnos/chrome-session-dump/releases/download/v0.0.2/chrome-session-dump-osx' && sudo chmod 755 /usr/bin/chrome-session-dump
```

# Usage

```
# chrome-session-dump # Print the url of all tabs found in the session in order.
https://ddg.gg
https://protonmail.com

# chrome-session-dump -active # Print the url of the most recently active tab
https://protonmail.com

# chrome-session-dump -printf '%t\n'
Secure email: ProtonMail is free encrypted email.
DuckDuckGo — Privacy, simplified.

# chrome-session-dump -deleted -history|grep 'chrome-session-dump' # Search the history of all (potentially deleted) tabs for a url containing the given expression.
https://github.com/lemnos/chrome-session-dump
```

A session file (or chrome directory) can optionally be provided as the final argument, by default the tool will
look for the most recent session file in ~/.config/chrome.

# Caveats

- Won't work on incognito tabs (since they are not persisted to disk).
- The output lags behind changes by a few milliseconds since chrome does not immediately flush changes to disk.

# To whom it may concern

Please don't use this for evil.