From 1984d33dd300a44bb1eea548026705444fc6c660 Mon Sep 17 00:00:00 2001 From: Thomas Lange Date: Sun, 6 Nov 2022 19:33:22 +0100 Subject: Add readme.md --- readme.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 readme.md diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..6f1f3d1 --- /dev/null +++ b/readme.md @@ -0,0 +1,14 @@ +# Android SMS Extractor +With this Python script you can extract all SMS messages from the SQLite database of the `com.android.messaging` app. The extracted SMS messages will be displayed on `stdout` as readable plain text sorted by conversation. + +## Usage instructions +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` + +**IMPORTANT:** This script has been written in 2019 when I needed a quick solution to export all SMS from my Android device (*OnePlus X*) running *LineageOS 14.1*. This script was later in 2022 also successfully tested with the SMS database of `com.android.messaging` in *LineageOS 17.1*. If it also works for you: Good! If not: I'm sorry! -- cgit v1.2.3