bagoup

command module
v1.1.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 15, 2020 License: AGPL-3.0 Imports: 14 Imported by: 0

README

bagoup Build Status Coverage Status Go Report Card

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 files.

Installation

brew tap tagatac/bagoup
brew install bagoup

chat.db Access

The Messages database is a protected file in Mac OS. See this article for more details. To to backup your messages, you have two options:

Copy the Messages database to an unprotected folder in Finder.

  1. Open Finder.
  2. Navigate to ~/Library/Messages.
  3. Right-click on chat.db, and click Copy "chat.db" in the context menu.
  4. Navigate to your home folder or another unprotected folder.
  5. Right-click in the unprotected folder, and click Paste Item in the context menu.
Option 2 (less secure): Give your terminal full disk access

https://osxdaily.com/2018/10/09/fix-operation-not-permitted-terminal-error-macos/

If you choose this option, bagoup will be able to open chat.db in its default location.

Contact information (optional)

If you provide your contacts via the --contacts-path flags, bagoup will attempt to match the handles from the Messages database with full names from your contacts list, labeling the folders with full names and each message with first names. Otherwise, phone numbers and email addresses will be used.

The contacts file must be in vCard format and can be obtained, e.g., from the Contacts app or Google Contacts.

Usage

  bagoup [OPTIONS]

Application Options:
  -d, --db-path=        Path to the Messages chat database file (default: ~/Library/Messages/chat.db)
  -v, --mac-os-version= Version of Mac OS from which the Messages chat database file was copied
  -c, --contacts-path=  Path to the contacts vCard file
  -o, --export-path=    Path to which the Messages will be exported (default: backup)
  -h, --self-handle=    Prefix to use for for messages sent by you (default: Me)

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

All conversations will be exported as text files to the specified export path.

Author

Copyright (C) 2020 David Tagatac

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
Package chatdb provides an interface ChatDB for interacting with the Mac OS Messages database typically located at $HOME/Library/Messages/chat.db.
Package chatdb provides an interface ChatDB for interacting with the Mac OS Messages database typically located at $HOME/Library/Messages/chat.db.
mock_chatdb
Package mock_chatdb is a generated GoMock package.
Package mock_chatdb is a generated GoMock package.
Package opsys provides an interface OS for interacting with the running operating system, both with the filesystem and with Mac OS commands.
Package opsys provides an interface OS for interacting with the running operating system, both with the filesystem and with Mac OS commands.
mock_opsys
Package mock_opsys is a generated GoMock package.
Package mock_opsys is a generated GoMock package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL