bagoup

bagoup (pronounced BAAGoop) is an export utility for Mac OS Messages, implemented in Go, inspired by Baskup. It exports all of the conversations saved in Messages to readable, searchable text or PDF files.

Usage: bagoup [OPTIONS]

Application Options: -i, --db-path= Path to the Messages chat database file (default: ~/Library/Messages/chat.db) -o, --export-path= Path to which the Messages will be exported (default: messages-export) -m, --mac-os-version= Version of Mac OS, e.g. '10.15', from which the Messages chat database file was copied (not needed if bagoup is running on the same Mac) -c, --contacts-path= Path to the contacts vCard file -s, --self-handle= Prefix to use for for messages sent by you (default: Me) --separate-chats Do not merge chats with the same contact (e.g. iMessage and SMS) into a single file -p, --pdf Export text and images to PDF files (requires full disk access) --include-ppa Include plugin payload attachments (e.g. link previews) in generated PDFs -a, --copy-attachments Copy attachments to the same folder as the chat which included them (requires full disk access) -r, --preserve-paths When copying attachments, preserve the full path instead of co-locating them with the chats which included them -t, --attachments-path= Root path to the attachments (useful for re-running bagoup on an export created with the --copy-attachments and --preserve-paths flags) (default: /) -e, --entity= An entity name to include in the export (matches the folder name in the export, e.g. "John Smith" or "+15551234567"). If given, other entities' chats will not be exported. If this flag is used multiple times, all entities specified will be exported. -v, --version Show the version of bagoup

Help Options: -h, --help Show this help message