sigtop

sigtop is a utility to export messages, attachments and other data from Signal Desktop.

For example, the following two commands export all messages to the messages directory and all attachments to the attachments directory:

sigtop export-messages messages
sigtop export-attachments attachments

Documentation is available in the sigtop.1 manual page. You can also read it online.

Installing on macOS

First install Homebrew. Then, to install sigtop, run:

brew install --HEAD tbvdm/tap/sigtop

Later, if you want to update sigtop, run:

brew upgrade --fetch-HEAD sigtop

Installing on other Unix-like systems

First install Go (version 1.18 or later) and a C compiler. On Ubuntu 22.04 or later, you can run:

sudo apt-get install golang gcc

Then, to install sigtop, run:

go install github.com/tbvdm/sigtop@master

This command installs a sigtop binary in ~/go/bin. You can choose another installation directory by setting the GOBIN environment variable. For example, to install sigtop in ~/bin, run:

GOBIN=~/bin go install github.com/tbvdm/sigtop@master

Installing on Windows

First install Go. Next, install the C compiler from WinLibs: download this Zip archive and unzip it to C:\winlibs.

Then, to install sigtop, open a PowerShell window and run:

$env:cc = 'c:\winlibs\mingw64\bin\gcc'
go install github.com/tbvdm/sigtop@master

This command installs sigtop.exe in C:\Users\<username>\go\bin. This directory has been added to your PATH, so you can simply type sigtop in PowerShell to run sigtop.

Alternatively, you can download a pre-compiled Windows binary from the latest release.

Note that sigtop is a console program; it should be run in a PowerShell or Command Prompt window.

Reporting problems

Please report bugs and other problems with sigtop. You can open an issue on GitHub or send an email.