Skip to content

Add conversation views to 12 SMS/chat artifacts (Tier 1 + safe Tier 2) #925

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
abrignoni merged 2 commits into from
Jul 3, 2026
Merged

Add conversation views to 12 SMS/chat artifacts (Tier 1 + safe Tier 2) #925

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f42d116
Add conversation views to 9 chat artifacts (Tier 1)
abrignoni Jul 3, 2026
535f8fa
Tier 2: derive MMS/backup directions, add 3 more conversation views
abrignoni Jul 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion scripts/artifacts/Life360.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,23 @@
"description": "Parses Life360 chat messages (messaging.db)",
"author": "@KevinPagano3",
"creation_date": "2024-01-17",
"last_update_date": "2024-01-17",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "Life360",
"notes": "",
"paths": ('*/com.life360.android.safetymapd/databases/messaging.db*',),
"output_types": "all",
"artifact_icon": "message-circle",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Thread ID",
"textColumn": "Message",
"directionColumn": "Message Sent",
"directionSentValue": "Yes",
"timeColumn": "Timestamp",
"senderColumn": "Sender Name"
}
},
},
"get_Life360_places": {
"name": "Life360 - Places",
Expand Down
12 changes: 11 additions & 1 deletion scripts/artifacts/Viber.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,13 +31,23 @@
"description": "",
"author": "",
"creation_date": "2020-12-24",
"last_update_date": "2020-12-24",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "Viber",
"notes": "",
"paths": ('*/com.viber.voip/databases/*',),
"output_types": "standard",
"artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Thread ID",
"textColumn": "Message",
"directionColumn": "Direction",
"directionSentValue": "Outgoing",
"timeColumn": "Message Date",
"senderColumn": "From Phone Number"
}
},
},
"get_Viber_additional": {
"name": "Viber - Additional",
Expand Down
12 changes: 11 additions & 1 deletion scripts/artifacts/bumble.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,20 @@
"get_bumble_messages": {
"name": "Bumble - Chat Messages",
"description": "Bumble chat messages",
"author": "@KevinPagano3", "creation_date": "2022-11-07", "last_update_date": "2022-11-07",
"author": "@KevinPagano3", "creation_date": "2022-11-07", "last_update_date": "2026-07-03",
"requirements": "none", "category": "Bumble",
"paths": ('*/com.bumble.app/databases/ChatComDatabase*', '*/com.bumble.app/files/c2V0dGluZ3M='),
"output_types": "standard", "artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Conversation ID",
"textColumn": "Message Text",
"directionColumn": "Message Direction",
"directionSentValue": "Outgoing",
"timeColumn": "Created Timestamp",
"senderColumn": "Sender Name"
}
},
},
"get_bumble_matches": {
"name": "Bumble - Matches",
Expand Down
14 changes: 13 additions & 1 deletion scripts/artifacts/burner.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,25 @@
"description": "Burner calls and text messages",
"author": "Josh Hickman (josh@thebinaryhick.blog)",
"creation_date": "2021-02-05",
"last_update_date": "2021-02-05",
"last_update_date": "2026-07-03",
"requirements": "None",
"category": "Burner",
"notes": "",
"paths": ('*/com.adhoclabs.burner/databases/burners.db',),
"output_types": "standard",
"artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Other Party Number",
"conversationLabelColumn": "Other Party Contact Name",
"textColumn": "Message",
"directionColumn": "Communication Direction",
"directionSentValue": "Outgoing",
"timeColumn": "Communication Time",
"senderColumn": "Other Party Contact Name",
"sentMessageStaticLabel": "Local User"
}
},
}
}

Expand Down
14 changes: 13 additions & 1 deletion scripts/artifacts/kleinanzeigen.de.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,13 +57,25 @@
"description": "Extracts individual messages from the message database",
"author": "@BrunoFischerGermany",
"creation_date": "2024-04-13",
"last_update_date": "2024-04-13",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "kleinanzeigen.de App",
"notes": "",
"paths": ('*com.ebay.kleinanzeigen/databases/messageBoxDatabase.db*',),
"output_types": "standard",
"artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Counterparty",
"conversationLabelColumn": "Counterparty",
"textColumn": "Message Text",
"directionColumn": "Direction",
"directionSentValue": "Outgoing",
"timeColumn": "Timestamp",
"senderColumn": "Counterparty",
"sentMessageStaticLabel": "Local User"
}
},
}
}

Expand Down
12 changes: 11 additions & 1 deletion scripts/artifacts/line.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,23 @@
"description": "",
"author": "",
"creation_date": "2021-03-15",
"last_update_date": "2021-03-15",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "Line",
"notes": "",
"paths": ('*/jp.naver.line.android/databases/**',),
"output_types": "standard",
"artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Thread ID",
"textColumn": "Message",
"directionColumn": "Direction",
"directionSentValue": "Outgoing",
"timeColumn": "Start Time",
"senderColumn": "From ID"
}
},
},
"get_line_calls": {
"name": "Line - Call Logs",
Expand Down
13 changes: 12 additions & 1 deletion scripts/artifacts/mewe.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,24 @@
"description": "",
"author": "",
"creation_date": "2021-11-10",
"last_update_date": "2021-11-10",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "MeWe",
"notes": "",
"paths": ('*/com.mewe/databases/app_database',),
"output_types": "standard",
"artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Thread Id",
"conversationLabelColumn": "Thread Name",
"textColumn": "Message Text",
"directionColumn": "Message Direction",
"directionSentValue": "Sent",
"timeColumn": "Timestamp",
"senderColumn": "User Name"
}
},
},
"get_mewe_session": {
"name": "MeWe - SGSession",
Expand Down
12 changes: 11 additions & 1 deletion scripts/artifacts/skype.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,23 @@
"description": "",
"author": "",
"creation_date": "2021-03-15",
"last_update_date": "2021-03-15",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "Skype",
"notes": "",
"paths": ('*/com.skype.raider/databases/live*',),
"output_types": "standard",
"artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Thread ID",
"textColumn": "Content",
"directionColumn": "Direction",
"directionSentValue": "Outgoing",
"timeColumn": "Send Time",
"senderColumn": "From ID"
}
},
},
"get_skype_contacts": {
"name": "Skype - Contacts",
Expand Down
38 changes: 33 additions & 5 deletions scripts/artifacts/smsmms.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,20 +5,31 @@
"description": "SMS messages from mmssms.db (incl. LG extended types and Samsung spam_sms)",
"author": "",
"creation_date": "2020-03-10",
"last_update_date": "2020-03-10",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "SMS & MMS",
"notes": "",
"paths": ('*/com.android.providers.telephony/databases/mmssms*',),
"output_types": "standard",
"artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Thread ID",
"textColumn": "Body",
"directionColumn": "Type",
"directionSentValue": "Sent",
"timeColumn": "Date",
"senderColumn": "Address",
"sentMessageStaticLabel": "Local User"
}
},
},
"get_sms_mms_mms": {
"name": "MMS Messages",
"description": "MMS messages and attachments from mmssms.db",
"author": "",
"creation_date": "2020-03-10",
"last_update_date": "2020-03-10",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "SMS & MMS",
"notes": "",
Expand All @@ -27,6 +38,18 @@
'*/com.android.providers.telephony/parts/*'),
"output_types": "standard",
"artifact_icon": "image",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Thread ID",
"textColumn": "Body",
"directionColumn": "Direction",
"directionSentValue": "Sent",
"timeColumn": "Date",
"senderColumn": "From Address",
"sentMessageStaticLabel": "Local User",
"mediaColumn": "Media"
}
},
}
}

Expand All @@ -53,7 +76,7 @@
'''

_MMS_QUERY = '''
SELECT pdu._id as mms_id, thread_id, pdu.date as date, pdu.date_sent as date_sent, read,
SELECT pdu._id as mms_id, thread_id, pdu.date as date, pdu.date_sent as date_sent, read, pdu.msg_box as msg_box,
(SELECT address FROM addr WHERE pdu._id=addr.msg_id and addr.type=0x89) as "FROM",
(SELECT address FROM addr WHERE pdu._id=addr.msg_id and addr.type=0x97) as "TO",
(SELECT address FROM addr WHERE pdu._id=addr.msg_id and addr.type=0x82) as "CC",
Expand All @@ -64,6 +87,10 @@
'''


# Telephony.Mms msg_box values; wording mirrors the SMS type CASE
_MMS_BOX_DIRECTION = {1: 'Received', 2: 'Sent', 3: 'Draft', 4: 'Outbox'}


def _ms_to_utc(value):
if not value:
return ''
Expand Down Expand Up @@ -143,10 +170,11 @@ def get_sms_mms_mms(files_found, report_folder, seeker, wrap_text):
body = str(data_path)
else:
body = r['text'] or ''
direction = _MMS_BOX_DIRECTION.get(r['msg_box'], r['msg_box'])
data_list.append((_sec_to_utc(r['date']), r['mms_id'], r['thread_id'],
_sec_to_utc(r['date_sent']), r['read'], r['FROM'], r['TO'], r['CC'],
r['BCC'], body, media_ref))
r['BCC'], body, media_ref, direction))

data_headers = (('Date', 'datetime'), 'MSG ID', 'Thread ID', ('Date Sent', 'datetime'), 'Read',
'From Address', 'To Address', 'Cc', 'Bcc', 'Body', ('Media', 'media'))
'From Address', 'To Address', 'Cc', 'Bcc', 'Body', ('Media', 'media'), 'Direction')
return data_headers, data_list, source_path
33 changes: 29 additions & 4 deletions scripts/artifacts/smsmmsBackup.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,26 +5,48 @@
"description": "MMS messages recovered from backup.ab telephony backup files",
"author": "",
"creation_date": "2024-08-15",
"last_update_date": "2024-08-15",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "SMS & MMS from backup.ab",
"notes": "",
"paths": ('*/com.android.providers.telephony/d_f/*_backup',),
"output_types": "standard",
"artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Recipients",
"textColumn": "Body",
"directionColumn": "Message Box",
"directionSentValue": "Sent",
"timeColumn": "Date",
"senderColumn": "Recipients",
"sentMessageStaticLabel": "Local User"
}
},
},
"get_sms_from_backup": {
"name": "SMS and MMS Backup - SMS",
"description": "SMS messages recovered from backup.ab telephony backup files",
"author": "",
"creation_date": "2024-08-15",
"last_update_date": "2024-08-15",
"last_update_date": "2026-07-03",
"requirements": "none",
"category": "SMS & MMS from backup.ab",
"notes": "",
"paths": ('*/com.android.providers.telephony/d_f/*_backup',),
"output_types": "standard",
"artifact_icon": "message-square",
"data_views": {
"conversation": {
"conversationDiscriminatorColumn": "Address",
"textColumn": "Body",
"directionColumn": "Direction",
"directionSentValue": "Sent",
"timeColumn": "Date",
"senderColumn": "Address",
"sentMessageStaticLabel": "Local User"
}
},
}
}

Expand All @@ -42,6 +64,8 @@
EPOCH = datetime.datetime(1970, 1, 1, tzinfo=datetime.timezone.utc)

MMS_BOX = {'0': 'All messages', '1': 'Inbox', '2': 'Sent', '3': 'Drafts', '4': 'Outbox', '5': 'Failed'}
# Telephony.Sms type values stored in the backup XML
SMS_TYPE = {'1': 'Received', '2': 'Sent', '3': 'Draft', '4': 'Outbox', '5': 'Failed', '6': 'Queued'}


def ReadUnixTimeMs(unix_time):
Expand Down Expand Up @@ -128,7 +152,8 @@ def get_sms_from_backup(files_found, report_folder, seeker, wrap_text):
data_list.append((
ReadUnixTimeMs(sms.get('date', 0)), ReadUnixTimeMs(sms.get('date_sent', 0)),
sms.get('read', ''), sms.get('type', ''), body,
', '.join(sms.get('recipients', [])), sms.get('address', ''), sms.get('status', '')))
', '.join(sms.get('recipients', [])), sms.get('address', ''), sms.get('status', ''),
SMS_TYPE.get(sms.get('type', ''), sms.get('type', ''))))

data_headers = (('Date', 'datetime'), ('Date sent', 'datetime'), 'Read', 'Type', 'Body', 'recipients', ('Address', 'phonenumber'), 'Status')
data_headers = (('Date', 'datetime'), ('Date sent', 'datetime'), 'Read', 'Type', 'Body', 'recipients', ('Address', 'phonenumber'), 'Status', 'Direction')
return data_headers, data_list, source_path
Loading