diff options
| -rwxr-xr-x | package/bin/android-sms-extractor | 58 |
1 files changed, 40 insertions, 18 deletions
diff --git a/package/bin/android-sms-extractor b/package/bin/android-sms-extractor index 3f05911..601ff8c 100755 --- a/package/bin/android-sms-extractor +++ b/package/bin/android-sms-extractor @@ -1,21 +1,46 @@ #!/usr/bin/env python3 -# Export all SMS from the SQLite database of the com.android.messaging -# app as simple plaintext sorted by conversation to stdout. -# -# Usage instructions for LineageOS 14.1 (tested on OnePlus X [onyx]): -# 1. Enable USB debugging in the developer options -# 2. Allow root access from ADB in the developer options -# 3. Connect the device and restart the adb daemon in root mode: -# $ adb root -# 4. Pull the corresponding database file: -# $ adb pull /data/data/com.android.messaging/databases/bugle_db . -# 5. Pass the name of the database file to this script: -# $ ./{this_script} bugle_db +##%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%## +# Android SMS Extractor [Thomas Lange <code@nerdmind.de>] # +##%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%## +# # +# Extract all SMS from the SQLite database of the com.android.messaging app as # +# simple plain text sorted by conversation to stdout or a file. # +# # +# USAGE INSTRUCTIONS (tested with SMS app in LineageOS 14.1 and 17.1): # +# 1. Enable USB debugging in the developer options of your Android. # +# 2. Enable "Root debugging" in the developer options of your Android. # +# 3. Connect your Android to your PC and (re)start ADB in root mode: # +# $ adb root # +# 4. Pull the corresponding database file to your PC: # +# $ adb pull /data/data/com.android.messaging/databases/bugle_db . # +# 5. Pass the path to the extracted database file to this script: # +# $ android-sms-extractor bugle_db # +# # +##%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%## import os import sys import sqlite3 + from datetime import datetime +from argparse import ArgumentParser + +#=============================================================================== +# Initialize argument parser +#=============================================================================== +parser = ArgumentParser(prog="android-sms-extractor", + description="Android SMS Extractor") + +#=============================================================================== +# Define positional arguments +#=============================================================================== +parser.add_argument('db_file', action='store', + help="Path to the SQLite database file") + +#=============================================================================== +# Parse arguments +#=============================================================================== +args = parser.parse_args() # Default date_format_string = "%Y-%m-%d %H:%M:%S" @@ -23,14 +48,11 @@ date_format_string = "%Y-%m-%d %H:%M:%S" # German version # date_format_string = "am %d.%m.%Y um %H:%M:%S" -if len(sys.argv) < 2: - exit("Usage: {} database_file > formatted.txt".format(sys.argv[0])) - -if not os.path.isfile(sys.argv[1]): - exit("Could not open file {}".format(sys.argv[1])) +if not os.path.isfile(args.db_file): + exit("Could not open file »{}«".format(args.db_file)) # Establish connection to local SQLite database -connection = sqlite3.connect(sys.argv[1]) +connection = sqlite3.connect(args.db_file) # Get a cursor to the SQLite database connection c = connection.cursor(); |