aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorThomas Lange <code@nerdmind.de>2022-11-06 19:33:22 +0100
committerThomas Lange <code@nerdmind.de>2022-11-06 19:33:22 +0100
commit1984d33dd300a44bb1eea548026705444fc6c660 (patch)
treeda8eef43fea017fc936a28bd0fd74a6b60e1a75f
parent3c4741942d4ad5858c2932dc172a1e3b7ba6adc3 (diff)
downloadandroid-sms-extractor-1984d33dd300a44bb1eea548026705444fc6c660.tar.gz
android-sms-extractor-1984d33dd300a44bb1eea548026705444fc6c660.tar.xz
android-sms-extractor-1984d33dd300a44bb1eea548026705444fc6c660.zip
Add readme.mdHEADmaster
-rw-r--r--readme.md14
1 files changed, 14 insertions, 0 deletions
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!