https://github.com/eredden/firehawk-text-extractor
A command-line utility for extracting SMS messages from Firehawk's JSON files.
https://github.com/eredden/firehawk-text-extractor
cli json sms
Last synced: 3 months ago
JSON representation
A command-line utility for extracting SMS messages from Firehawk's JSON files.
- Host: GitHub
- URL: https://github.com/eredden/firehawk-text-extractor
- Owner: eredden
- License: mit
- Created: 2025-06-16T20:22:13.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-17T00:54:55.000Z (about 1 year ago)
- Last Synced: 2025-06-17T01:39:04.404Z (about 1 year ago)
- Topics: cli, json, sms
- Language: Python
- Homepage: https://firehawk.ai
- Size: 2.93 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FireHawk SMS Message Extractor
## Description
This is a simple command-line Python utility for extracting SMS messages from JSON files generated by the Android app **SMS Backup & Restore** by Firehawk.
## Usage
The **src** directory contains all of my source code for this program. The Python script for extracting text can be used as shown below, with `-i` or `--input_file` being the path of the JSON file containing the SMS texts, `-o` or `--output_file` being the path of the file where the formatted texts should go, and `-s` or `--senders` being the names of each sender.
Note that sender names cannot contain spaces or else they will be split into separate senders, i.e. `Evan Redden` will be split into two names as values are delimited by spaces. I am not sure precisely how SyncTech decides the `type` value of each message, so you may have to switch around the order of the names to get things looking correctly.
```bash
$> python ./src/extract-texts.py -i input.sms -o output.sms -s NAME_1 NAME_2
```
The output file will contain texts in the following format, in chronological order:
```
NAME (DATE): MESSAGE CONTENT.
```