MacOS X Call history decryptor/converter to CSV

Converts the MacOS X call history to CSV file format.
This is a Golang implementation of the n0fates' Call History Decryptor, and is based on n0fates' presentation descibing the internals of the database: https://papers.put.as/papers/macosx/2014/Forensic-artifacts-for-Yosemite-call-history-and-sms-anlaysis-ENG.pdf
Motivation for different implementation is:
- to improve usability by having just one binary executable;
- increase the execution speed by using standard library functions;
- providing more convenient output format (CSV); and
- describe the usage to make it more accessible to those who require to get the call history from MacOS X for any reason, but lacking the time or the technical knowledge required to set up the Python interpreter and packages needed for the ogirinal implementation.
All credit for the decryption logic goes to n0fate.
Purpose
Decrypt and save the call history of the OS X Yosemite+ to a CSV file.
Download
Downloads are available on Releases page.
Usage
Start the program with -h command line flag to see the usage help. Available options will differ depending on the OS the program being started on.
You will still to obtain the database and the encryption key from the MacOS system.
-
Get the copy of the CallHistory.storedata from source OS X machine. The file is stored in this location:
$HOME/Library/Application Support/CallHistoryDB/CallHistory.storedata
with $HOME being the user's home directory.
Copy it to the same directory where you've unpacked the 'callhistory'
If you get the "Operation not permitted" on latest MacOSes:
- Go into "System Preferences";
- Choose "Security and Privacy";
- Go to "Privacy" tab, select "Full Disk Access" item;
- Add the Utilities/Terminal.app — or whatever you're using — to the list.
-
Get the key from the source MacOS X keychain:
- search the MacOS X keychain for the Call History User Data Key
- double-click the entry, and put the checkmark opposite the "show password" field.
- Enter your user's account password and copy the key value to the clipboard.
-
Open the terminal or cmd.exe prompt on Windows (How?). Start the callhistory decryptor on your machine:
C:>callhistory.exe -k <key value from step 2>
-
The output will be printed onto the terminal by default. You can specify an output file by providing the -o command line flag:
C:>callhistory.exe -o your_ex_callhistory_lol.csv
If the database file is called differently than CallHistory.storedata, then use -f command line flag to provide the filename:
$ callhistory -o your_ex_callhistory_lol.csv -f Calls.db
Licence
OS X Call history decryptor
Copyright (C) 2016 n0fate (GPL2 license)
Copyright (C) 2018,2019 rusq (golang implementation, GPL3)
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/.