carderne/sigexport

signal-export

镜像概述和主要用途

signal-export是一款用于从Signal桌面应用导出聊天记录的工具，支持将聊天内容转换为Markdown和HTML文件，并保留附件。每个聊天会生成独立的.md和.html文件，附件则存储在单独文件夹中，且在Markdown文件中通过链接引用，在HTML中可直接显示（图片、视频、语音笔记等）。目前这是从Signal中导出聊天历史的有效方式。

核心功能和特性

• 多格式导出：支持将聊天记录导出为Markdown和HTML两种格式
• 附件处理：自动将附件（图片、视频、语音笔记、文档等）存储在独立文件夹，并在Markdown/HTML中创建链接
• 聊天筛选：可指定导出特定聊天，或列出所有可用聊天
• 增量导出：支持与之前的导出结果合并，避免覆盖原有数据
• 跨平台支持：适配Linux、macOS和Windows系统的Signal配置路径

使用场景和适用范围

适用于需要备份Signal聊天记录的用户，尤其是希望以可读格式（Markdown/HTML）保存聊天历史、保留附件的场景。无论是个人聊天还是群组对话，均可通过该工具进行完整导出。

使用方法和配置说明

Docker安装（推荐）

由于依赖复杂，Docker是最简单的安装方式，需先安装Docker和Python。

1. 安装Docker：https://docs.docker.com/get-docker/
2. 安装Python
3. 安装signal-export包：

   bash
   pip install signal-export
   

4. 运行导出命令：

   bash
   sigexport ~/signal-chats
   # 导出结果将保存到指定目录
   

使用说明

重要：导出前请完全退出Signal应用，否则可能因数据库被占用而出现"I/O disk"错误。

基本命令

查看完整帮助信息：

bash
sigexport --help

常用选项

• 禁用HTML分页并覆盖目标目录内容：

  bash
  sigexport --paginate=0 --overwrite ~/signal-chats
  

• 列出所有可用聊天：

  bash
  sigexport --list-chats
  

• 仅导出指定聊天（以逗号分隔）：

  bash
  sigexport --chats=Jim,Aya ~/signal-chats
  

• 指定Signal配置目录（当工具无法自动找到时）：

  bash
  sigexport --source /path/to/source/dir/ ~/signal-chats
  

  默认配置路径：

  • Linux: ~/.config/Signal/
  • macOS: ~/Library/Application Support/Signal/
  • Windows: ~/AppData/Roaming/Signal/（需包含sql文件夹及其中的db.sqlite文件）

• 合并新导出与之前的导出结果：

  bash
  sigexport --old /previously/exported/dir/ ~/signal-chats
  

  注：合并结果将保存到新指定的输出目录，原导出目录不会被修改。

替代安装方法（高级模式）

适用于熟悉系统配置的用户，需先安装sqlcipher。

Ubuntu（其他Linux发行版可适配包管理器）

安装依赖库：

bash
sudo apt install libsqlite3-dev tclsh libssl-dev

编译安装sqlcipher：

bash
git clone https://github.com/sqlcipher/sqlcipher.git
cd sqlcipher
./configure --enable-tempstore=yes CFLAGS="-DSQLITE_HAS_CODEC" LDFLAGS="-lcrypto -lsqlite3"
make && sudo make install

macOS

1. 安装Homebrew：Homebrew官网
2. 安装依赖：

   bash
   brew install openssl sqlcipher
   

Windows

推荐使用WSL2安装Ubuntu子系统，然后按照Linux安装步骤操作。

安装signal-export

完成sqlcipher安装后，执行：

bash
pip install signal-export[sql]

安装后即可按照上述"使用说明"操作。

开发指南

bash
git clone https://github.com/carderne/signal-export.git
cd signal-export
pip install -e .[dev,sql]
pre-commit install

运行测试：

bash
make test

类型检查：

bash
mypy sigexport/

类似工具

• https://github.com/pajowu/signal-backup-decode%EF%BC%9A%E9%80%82%E7%94%A8%E4%BA%8EAndroid%E8%AE%BE%E5%A4%87%E7%9A%84Signal%E5%A4%87%E4%BB%BD%E8%A7%A3%E7%A0%81%E5%B7%A5%E5%85%B7
• https://github.com/GjjvdBurg/signal2html%EF%BC%9A%E5%90%8C%E6%A0%B7%E4%BB%85%E6%94%AF%E6%8C%81Android%E8%AE%BE%E5%A4%87