aboutsummaryrefslogtreecommitdiffstats
path: root/readme.md
blob: 6f1f3d16494729b14fb795742db44ee0f8434001 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
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!