⚠️ NB: Because the latest versions of Signal Desktop protect the database encryption key, so decrypting involves some extra steps. Good luck.
Export chats from the Signal Desktop app to Markdown and HTML files with attachments. Each chat is exported as an individual .md/.html file and the attachments for each are stored in a separate folder. Attachments are linked from the Markdown files and displayed in the HTML (pictures, videos, voice notes).
Currently this seems to be the only way to get chat history out of Signal!
Adapted from mattsta/signal-backup, which I suspect will be hard to get working now.
An export for a group conversation looks as follows:
[2019-05-29, 15:04] Me: How is everyone?
[2019-05-29, 15:10] Aya: We're great!
[2019-05-29, 15:20] Jim: I'm not.
Images are attached inline with  while other attachments (voice notes, videos, documents) are included as links like [name](path) so a click will take you to the file.
This is converted to HTML at the end so it can be opened with any web browser. The stylesheet .css is still very basic but I'll get to it sooner or later.
Make sure you have Python installed.
Install this package:
pip install signal-export
sigexport ~/signal-chats
# or for Windows:
python -m sigexport C:\Temp\SignalExport
If you need step-by-step instructions on things like enabling WSL2, please see the dedicated Windows Installation instructions.
signal-export is packaged in nixpkgs, so you can run
nix-shell -I nixpkgs=channel:nixpkgs-unstable --packages signal-export --command 'sigexport ~/signal-chats'
If you get an error message about secret-tool not being found, you probably need to install libsecret-tools via your Linux package manager.
Please fully exit your Signal app before proceeding, otherwise you will likely encounter an I/O disk error, due to the message database being made read-only, as it was being accessed by the app.
See the full help info:
sigexport --help
Disable pagination on HTML:
sigexport --paginate=0 ~/signal-chats
List available chats and exit:
sigexport --list-chats
Export only the selected chats:
sigexport --chats=Jim,Aya ~/signal-chats
You can add --source /path/to/source/dir/ if the script doesn't manage to find the Signal config location.
Default locations per OS are below.
The directory should contain a folder called sql with db.sqlite inside it.
~/.config/Signal/~/.var/app/org.signal.Signal/config/Signal~/Library/Application Support/Signal/~/AppData/Roaming/Signal/You can also use --old /previously/exported/dir/ to merge the new export with a previous one.
Nothing will be overwritten!
It will put the combined results in whatever output directory you specified and leave your previos export untouched.
Exercise is left to the reader to verify that all went well before deleting the previous one.
git clone https://github.com/carderne/signal-export.git
cd signal-export
rye sync --no-lock
Various dev commands:
rye fmt # format
rye lint # lint
rye run check # typecheck
rye run test # test
rye run sig # run signal-export
FAQs
Export Signal conversations to Markdown and HTML
We found that signal-export demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Malicious Go packages are impersonating popular libraries to install hidden loader malware on Linux and macOS, targeting developers with obfuscated payloads.
Security News
Bybit's $1.46B hack by North Korea's Lazarus Group pushes 2025 crypto losses to $1.6B in just two months, already surpassing all of 2024's $1.49B total.
Security News
OpenSSF has published OSPS Baseline, an initiative designed to establish a minimum set of security-related best practices for open source software projects.