Bash script that exports content provider's data to raw and CSV format. It can be your own content provider or any other content provider that isn't blocked with permissions.
First, clone the repository using git:
git clone https://github.com/snatik/adb-export/
or download the script manually using this command:
curl "https://raw.githubusercontent.com/snatik/adb-export/master/adb-export.sh" -o adb-export.sh
Then give the execution permission to the script and run it:
$ chmod +x adb-export.sh
$ ./adb-export.sh
Enable Developer options
on the device
- -e [uri] - Set your provider URI and Export the data to CSV
Example:
./adb-export.sh -e content://com.your.app/images
Example:
./adb-export.sh -e content://com.android.calendar/calendars
The exported data will be in a new created folders with timestamps in the same root folder this script is located. You will find two new created files:
raw_query.txt
- this is what we exported from devicedata.csv
- this is what you need
There is a list of some android content providers that don't block the adb query. My expectation was that it wouldn't be possible because of lack of provider permissions. Just to be on the safe side, I opened a security vulnarability issue to Security Google Team and got few replies where the last one says that this is not a security hole.
Just an example:
-
This one won't work:
content://sms
The result will be: requires android.permission.READ_SMS -
This will work:
content://com.android.contacts/contacts
The result: CSV with all contacts
Which, btw, should also check for permissions, but it doesn't. 😮
If you discover some new that work, add them here
- content://com.android.calendar/calendars
- content://com.android.calendar/events
- content://com.android.calendar/attendees
- content://com.android.calendar/reminders
- content://com.android.calendar/extendedproperties
- content://com.android.contacts/contacts
- content://com.android.contacts/directories
- content://com.android.contacts/deleted_contacts
- content://com.android.contacts/raw_contacts
- content://com.android.contacts/data
- content://com.android.contacts/data/phones
- content://com.android.contacts/raw_contact_entities
- content://com.android.contacts/status_updates
- content://com.android.contacts/groups
- content://com.android.contacts/aggregation_exceptions
- content://com.android.contacts/photo_dimensions
- content://media/external/images/media
- content://media/external/images/thumbnails
- content://media/external/audio/media
- content://media/external/audio/genres
- content://media/external/audio/playlists
- content://media/external/audio/artists
- content://media/external/audio/albums
- content://media/external/video/media
- content://media/external/video/thumbnails
the
external
in the uri, you can also change tointernal
- content://settings/system
- content://settings/secure
- content://settings/global
- content://settings/bookmarks
- content://user_dictionary/words
- MacOSX
- Ubuntu 14.10 (Utopic). Run
sudo apt-get install android-tools-adb
first
If you have successfully tested this script on others systems or platforms please let me know or update this list.
- Any commas in imported values are replaced to " " (space) char, since they don't play well in CSV format. You can configure it by changing
REPLACE_VALUE_COMMAS_TO
variable in the script. - The table schema of the same android content provider on different devices can be different, thus the parsing steps try to understand what is the column and what is the value.
- This is the first version, and if you find bad parsing outputs, please open an issue.
- Use it only for good purposes!
Apache License 2.0
See LICENSE for details.