Clarity - Contact thumbnails you don't mind looking at.

Search This thread

Kevin M

Inactive Recognized Developer
Jul 31, 2011
457
775
kmark.io
Sorry, currently on spring break.

So, in theory, would you be able to install this and run the DB processor to create hi-res thumbnails and then remove the app? I ask because Xposed is not stable on my device (it works, but causes random reboots), so running this and getting it setup then removing Xposed would be ideal for me. Or I can just try and modify my ROM to get it to work without Xposed (I haven't read the implementation details yet).

EDIT: To answer my own question - YES, this works :) Made a nandroid, got everything setup, removed Clairty and Xposed, and restored my /system partition. Good to go!

Yes although you can install this app without Xposed and purely use it for the db processor. You just need root. The downside to the processor is that it only updates things currently in the database. So if one of your contacts has an updated photo then you will have to run the processor again to resize it. When Android adds the updated photo to the database it will be 96x96 again.

Two ways you could go about modifying the ROM. If you're building from source all you have to do is change one field and you're done (after recompiling). If you're not from source then you'll need to disassemble the Contacts Provider APK, change the field in the smali file, and then reassemble making sure it's correctly signed.

:( Doesnt work on Lollipop TouchWiz on the Note 4. Expected but o well

My experimental instructions here appeared to work for a Galaxy S4 + TouchWiz user. It may work for your Note. Please note that your Contacts UID will be different. And to properly backup. Proceed with caution.

What size are y'all using? 256 or increased it?

---------- Post added at 09:53 AM ---------- Previous post was at 09:49 AM ----------

It refuses to change detect contacts

Out of all, it only finds 1 photo and claims it's not even square

Any help?

d431a36fb9f26e6ea4a16dcf9ed0f448.jpg

I didn't create code to handle square cropping an image if needed so I avoided it altogether by ignoring non-perfectly square source images. This is something I will fix eventually. How many contacts with photos are in your Contacts app?
 

rgshah3

Senior Member
Apr 19, 2011
1,714
439
Mumbai
Sorry, currently on spring break.



Yes although you can install this app without Xposed and purely use it for the db processor. You just need root. The downside to the processor is that it only updates things currently in the database. So if one of your contacts has an updated photo then you will have to run the processor again to resize it. When Android adds the updated photo to the database it will be 96x96 again.

Two ways you could go about modifying the ROM. If you're building from source all you have to do is change one field and you're done (after recompiling). If you're not from source then you'll need to disassemble the Contacts Provider APK, change the field in the smali file, and then reassemble making sure it's correctly signed.



My experimental instructions here appeared to work for a Galaxy S4 + TouchWiz user. It may work for your Note. Please note that your Contacts UID will be different. And to properly backup. Proceed with caution.



I didn't create code to handle square cropping an image if needed so I avoided it altogether by ignoring non-perfectly square source images. This is something I will fix eventually. How many contacts with photos are in your Contacts app?
I have atleast 200 with pictures

Doesn't detect them!
The pictures are linked to my Google account
 

Spookymyo

Senior Member
Getting the following error:

Starting task on 2015-03-29 at 10:49:55 AM
Dimen = 256, Dry Run = true, Backups = true, Reboot = true
Cache = /data/data/com.versobit.kmark.clarity/cache
Contacts = /data/data/com.android.providers.contacts
SELinux is enforcing.
Clarity UID = 10067, Contacts UID = 10003
Copying contacts database to cache…
Error: Failed to copy database to cache true, false, false, true, false, false
Task ended on 2015-03-29 at 10:49:56 AM

What's the issue?

---
Eric
VzwGS4
MDK
 

Kevin M

Inactive Recognized Developer
Jul 31, 2011
457
775
kmark.io
I have atleast 200 with pictures

Doesn't detect them!
The pictures are linked to my Google account

If the photos are coming from Google that could be the problem. The one photo it is finding must've been set manually or simply synced from elsewhere. I'll take a look at how Google contact photos are treated.

Using stock 4.4.4 on a 2013 Moto X. No luck with the processor.

Thanks for giving it a go. Please post a db proc log here within some [ code ] tags.

Getting the following error:

Starting task on 2015-03-29 at 10:49:55 AM
Dimen = 256, Dry Run = true, Backups = true, Reboot = true
Cache = /data/data/com.versobit.kmark.clarity/cache
Contacts = /data/data/com.android.providers.contacts
SELinux is enforcing.
Clarity UID = 10067, Contacts UID = 10003
Copying contacts database to cache…
Error: Failed to copy database to cache true, false, false, true, false, false
Task ended on 2015-03-29 at 10:49:56 AM

What's the issue?

---
Eric
VzwGS4
MDK

This seems to be a common theme among TouchWiz users. Here are some experimental instructions that worked for another S4 user. Please note that your Contacts UID will be different. According to your log your Contacts UID is 10003.
 
  • Like
Reactions: Fr3d_

rgshah3

Senior Member
Apr 19, 2011
1,714
439
Mumbai
If the photos are coming from Google that could be the problem. The one photo it is finding must've been set manually or simply synced from elsewhere. I'll take a look at how Google contact photos are treated.



Thanks for giving it a go. Please post a db proc log here within some [ code ] tags.



This seems to be a common theme among TouchWiz users. Here are some experimental instructions that worked for another S4 user. Please note that your Contacts UID will be different. According to your log your Contacts UID is 10003.
Ah okay! Want to make those Google images clear!
Would be delighted if you managed to fix it
 

Spookymyo

Senior Member
If the photos are coming from Google that could be the problem. The one photo it is finding must've been set manually or simply synced from elsewhere. I'll take a look at how Google contact photos are treated.



Thanks for giving it a go. Please post a db proc log here within some [ code ] tags.



This seems to be a common theme among TouchWiz users. Here are some experimental instructions that worked for another S4 user. Please note that your Contacts UID will be different. According to your log your Contacts UID is 10003.

I'm not on a touchwiz rom I'm on CM11.

---
Eric
VzwGS4
MDK
 

Kevin M

Inactive Recognized Developer
Jul 31, 2011
457
775
kmark.io
This sounds great I've run it. is there any concrete way of confirming this did do the job?

What I've done before is find an obviously poor quality thumbnail, upgrade, and take a look again. Perhaps with a screenshot. The only other way right now is to pull the contact from the database and read the image size. I'll add a way to check the new/current sizes to my TODO list and hopefully add it in an upcoming release of Clarity.
 
  • Like
Reactions: Karamvir Singh

cantenna

Senior Member
Aug 5, 2012
2,349
566
Newcastle
What I've done before is find an obviously poor quality thumbnail, upgrade, and take a look again. Perhaps with a screenshot. The only other way right now is to pull the contact from the database and read the image size. I'll add a way to check the new/current sizes to my TODO list and hopefully add it in an upcoming release of Clarity.
Sounds good man! The contact photos look great! Thanks for this tweak :)
 

Karamvir Singh

Senior Member
Feb 18, 2012
146
87
www.androbug.com
Hi @Kevin M I just had a request cum suggestion.......
a big gripe that very music guy has from android is blurry album arts.....stupid google caches album art at 320 dpi and displays them even larger than the screen on the now playing page in google play music.......
Doing some research I found cached album arts are stored as randomly numbered extension less files in "android/data/com.android.providers.media/album art" and replacing them with your own image file helps.....
More research.....and I found the the database that points to these file thus editing database also helps.....
But I didn't give up so I extracted the com.android.providers.media.apk from system/app and then opened it up with apk editor pro.......

HOLLA! In the dimens.xml I found just one value
Maximum thumbnail size - 320 DPI......


Now only if you could add a little code in your module that will change that value to 600 or any user selectable value........we will solve the long standing issue 72635 of android
BLURRY ALBUM ARTS ISSUE
 
Last edited:

winjer

Member
Jan 28, 2011
41
1
Here's my log:

Starting task on 2015-04-12 at 11:37:43 PM
Dimen = 256, Dry Run = true, Backups = true, Reboot = true
Cache = /data/data/com.versobit.kmark.clarity/cache
Contacts = /data/data/com.android.providers.contacts
SELinux is enforcing.
Clarity UID = 10180, Contacts UID = 10012
Copying contacts database to cache…
Copying photos to cache…
Backing up current contacts database to /storage/emulated/0/Clarity/2015-04-12--23-37-43
Opening contacts database…
Querying for contacts with photos…
1 found.
1/1: Processing contact 8777 with photo 2
Source photo is 511×512.
Contact photo is not square. Skipping.
Placing 0 new thumbnails into the contacts database…
Dry run. Not overwriting contacts database.
Contact thumbnail database upgrade completed successfully.
Soft reboot in 3 seconds…
Dry run. Not soft rebooting.
Task ended on 2015-04-12 at 11:37:47 PM


Is that enough to figure out what's going on?
 

QuickInfo

Senior Member
Sep 1, 2012
267
58
So if we already have HD pictures on Google, will this sync those back? Because after restoring, Google only seems to load HD for your favorite contacts and the other, you'd have to go into the contact and click on them to load the HD version.
 

wifestealer

Senior Member
Sep 27, 2014
1,512
322
New Delhi
@Kevin M sorry, I'm newbie here but I couldn't find anywhere to tweak the settings. It did install on my phone but i couldn't find anything in settings or in module. BTW i'm on officialy CM 5.1 (Moto g2)
 

Kevin M

Inactive Recognized Developer
Jul 31, 2011
457
775
kmark.io
Fantastic! Works great. All I had to do was uncheck Contacts in sync settings and recheck it.

Thanks! What device and ROM are you using?

So, in theory, would you be able to install this and run the DB processor to create hi-res thumbnails and then remove the app? I ask because Xposed is not stable on my device (it works, but causes random reboots), so running this and getting it setup then removing Xposed would be ideal for me. Or I can just try and modify my ROM to get it to work without Xposed (I haven't read the implementation details yet).

EDIT: To answer my own question - YES, this works :) Made a nandroid, got everything setup, removed Clairty and Xposed, and restored my /system partition. Good to go!

Great to hear. What device and ROM are you using?

Thank you. Working great on N6

Thanks! What ROM are you using?
 

Top Liked Posts

  • There are no posts matching your filters.
  • 44
    Code:
    Clarity is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    Introduction
    Clarity is an Xposed module and root Android application for increasing the size and quality of contact thumbnails in the Android contacts database. It's comprised of two components. An Xposed modification and a root-required Database Processor.

    Clarity also increases the quality and size of locally stored album art.

    Xposed Mod
    Android stores two versions of contact images. The contact photo and the contact thumbnail. While both are downscaled appropriately from the original image, the two are very different in size. Contact photos clock in at around 720×720 pixels or so depending on the original image. Contact thumbnails are a measly 96×96 pixels. Contact photos are used in places where contact imagery is going to be distinctively large like the KitKat/Lollipop Phone app. Or when you receive an incoming call. Thumbnails are used for notifications, messaging applications, and other roles which the full contact photo is unnecessarily big. Unfortunately, as screen PPIs have skyrocketed since the 96×96 limit was put in place, contact thumbnails are now too small for their original purpose. Regardless, most applications continue to use contact thumbnails.

    Clarity forces Android to use a user-defined size (defaulting to 256×256) when adding contact thumbnails to the database. While these new images are larger and look much better they will load slightly slower and increase memory requirements. For newer devices this should not be a problem. For reference, I have not witnessed any side effects on my Galaxy S4 using the default 256×256 setting. Since the size can be adjusted you can optimize it for your device.

    In the name of simplicity, Clarity does not change the method Android uses to downscale contact thumbnails, just the final dimensions. However since Clarity allows you to increase the size of the thumbnail and consequently decrease the magnitude of the downscale, there will be noticeably fewer artifacts in your new thumbnails.

    The Xposed module does not magically increase the quality of thumbnails already added in the database. It only affects newly added/updated contacts and images. To upgrade your entire contacts database either use the Database Processor detailed below or re-import the contacts. Re-importing may require you to deconnect/desync the account the contacts are associated with and then reconnect/resync the account. Some sync applications may have a force refresh option and that should work nicely. For instance, HaxSync has a Force redownload option under its contact settings.

    When the Xposed module is activated, Clarity will also up the size of locally stored album art (for instance, MP3s on the external storage). Just like the contact thumbnail part of the module, existing album art is unaffected. To get Android to reprocess all the album art on your device you must delete all the files found in the albumthumbs directory. This is usually found somewhere on your external storage. Popular paths are /storage/emulated/legacy/Android/data/com.android.providers.media/albumthumbs and /storage/sdcard0/Android/data/com.android.providers.media/albumthumbs. Different devices and ROMs can have different paths but the last /Android/data/com.android.providers.media/albumthumbs bit should stay the same. Once that directory has been cleared out, higher quality album art will be regenerated by Android on demand (as they are needed). See Android issue 73635 for more information about the album art problem.

    Database Processor
    In addition to the Xposed-based modification described above, Clarity includes a Database Processor. This powerful feature forcibly updates every contact thumbnail in your database. It rips out the internal contacts database file, finds all your contacts with photos and puts in new thumbnails. It'll then replace the old database with the new one. It is highly recommended to immediately reboot after processing to avoid Android going berserk. It will if you don't. :)

    While powerful, the Database Processor is also extremely dangerous. I am not responsible for any damage to your device as a result of using Clarity. It performs several operations as root and modifies core Android files that were never meant to be touched by anything other than Android itself. I highly recommend a full recovery-based backup of your device alongside the built-in backup feature. Please use the dry-run feature first (hell, multiple times even) to ensure the operation will succeed for your ROM. It is possible a successful dry-run could still fail when doing the real-deal so, as I mentioned before, backup your stuff. The built-in contact backups will be saved to a Clarity folder on your "primary" external storage. What primary means depends on your ROM and device. It could be your actual external SD card or it could be an internal storage location. Regardless, the current backup location will be noted, assuming backups are enabled, in the processor's log. As an added bonus, if the backup feature is on it will also save the log file alongside your backups!

    The Database Processor has been tested on CM (CyanogenMod) 10 (based on Android 4.1.2), CM 11 (based on Android 4.4.4), CM 12 (based on Android 5.0.2), and CM 13 (based on Android 6.0.1). It should work on any AOSP-based ROM from Ice Cream Sandwich (4.0) to Marshmallow (6.0). For stock ROMs and anything created by carriers I have no idea. If it works for you please report back! If it doesn't, well, report that too.

    Images

    Features
    • Simple lightweight Xposed modification
    • Powerful database processor for forcibly updating contact thumbnails
    • Also clarifies locally stored album art
    • Should work on nearly any AOSP-based ROM like CyanogenMod
    • Free and open-source software. No nags. No data collection. No secrets.

    Known Issues
    • Does not appear to work with Google-synced contact photos.
    • May not work with all devices and ROMs. See the following post.

    Installation
    1. Make certain you have Xposed installed before continuing.
    2. Install the app by a) searching for it in the Xposed Installer or b) manually through the APK provided on GitHub or the Xposed website.
    3. Configure the app in its settings panel. It can be accessed through the module section of the Xposed Installer or by the launcher shortcut.
    4. Enable the module in the Xposed Installer.
    5. Reboot.
    6. Done!
    7. The Xposed module will only update contact photos that are modified or added to the database after it is turned on. The database processor will attempt to update the contact photos in place and right away. To avoid using the database processor your contact photos must be manually refreshed. How/if this can be done and how easily is dependent on how you sync your contacts. For instance, if you use HaxSync you can update all your photos by going to Settings app -> Accounts -> HaxSync -> Advanced Settings -> Contact Settings -> Check Force redownload. Hit back twice. Select your account name at the top. Click Contacts to uncheck it. Recheck it and wait for sync to finish.

    Changelog
    See the GitHub repository for the definitive changelog.
    Code:
    v1.2-cfad189 - 03 Jul 2016 - Stable
    ------------
    This release introduces the following improvements:
    * Added a Spanish translation
      (thanks to Jose Artuñedo @ XDA)
    * Fix a SELinux-related issue with the Database Processor
      on Marshmallow
    * Support Marshmallow's new permission system
    * Added some additional debugging info to the processor log
    * Tested on CyanogenMod 13 (Android 6.0.1)

    Code:
    v1.1-93b7945 - 03 May 2015 - Stable
    ------------
    This release introduces the following improvements:
    * The database processor will no longer fail if contacts2.db-journal
      cannot be found. It will note the absence of the journaling file
      in the log and proceed as normal
    * Will now increase the size and quality of locally stored album art.
      Suggested by @Karamvir Singh. See [url=http://xdaforums.com/showpost.php?p=60499753&postcount=55]this post[/url] for more
      information.
    * An XXXHDPI icon
    * Updated donation links
    * Minor log bug fix
    * Better shell usage
    * Less condescending toast notifications
    Code:
    v1.0-917d899 - 25 Mar 2015 - Stable
    ------------
    Initial release. Make sure to see the README or XDA thread!

    Downloads

    FAQ
    Q: Something went horribly wrong! How do I restore from one of the backups?
    A: Ouch! Clarity stores backups on your "external storage." Depending on your device and ROM this could be an actual SD card or internal. If your device has two check both. It will be in a directory named Clarity. In the Clarity backup directory there will be sub-directories with dates. Select the one before everything went to hell. You'll find up to three files: contacts2.db contacts2.db-journal, and dbprocessor.log The .db file(s) are the actual contacts databases. The dbprocessor.log is your log file and has lots of great information for us to use. Now that we have located everything we need let's get restoring.

    Method #1 - By hand
    If your device still boots and you can navigate around (even if things are crashing every few seconds) try this. If you have a custom recovery that supports adb then this will work as well if you boot into it.
    1. Grab the adb command line tool. For Windows check here. For Linux and Mac see here.
    2. Now put your device in debug mode. Go to the settings app. Tap About phone. Keep tapping Build number until it says you are a developer. Go back and select Developer options. Turn the development options "on" if needed. Under Debugging turn on Android debugging.
    3. Now connect your device to your computer. It should say something about debugging being enabled in the status bar. Make certain your phone is unlocked. If it says something about allowing the computer debug access to your phone please accept it.
    4. Open up a command line or terminal. On Linux I'm going to assume you know what to do. On Mac it's the Terminal app. On Windows it's C:Windowssystem32cmd.exe
    5. Type adb version and hit enter. If your get something about it being not found then adb isn't installed in your PATH or you're not in the directory in which adb was extracted. You can navigate to that directory with the cd command. So to navigate to the system32 folder on Windows, for instance, I'd type cd C:Windowssystem32 and hit enter.
    6. Type adb shell and hit enter. This will dump us into a shell instance directly on your device.
    7. Type id and hit enter. If the first bit is not uid=0 then unlock your device and type su and hit enter. If your device prompts for superuser access please grant it.
    8. Navigate to the directory in which your backups are stored on your device. For me this would be something like cd /storage/emulated/legacy/Clarity/2015-Something
    9. You should now see the backup files if you type ls and hit enter. Great. Now to move these into place.
    10. Open your dbprocessor.log file on your device through a file manager or move it onto your computer to read its contents. You can read it through the command line if you wish but it's much more convenient to be able to copy and paste if needed.
    11. Note the Contacts UID and Contacts directory. Mine is 10006 and /data/data/com.android.providers.contacts respectively.
    12. Execute cp contacts2.db /your/contacts/directory/databases/contacts2.db and hit enter. For me this full command is cp contacts2.db /data/data/com.android.providers.contacts/databases/contacts2.db
    13. If you have a contacts2.db-journal file do the same except with that file. For me this is: cp contacts2.db-journal /data/data/com.android.providers.contacts/databases/contacts2.db-journal
    14. Now to correct the permissions. Type chown +UID:+UID /your/contacts/directory/databases/contacts2.db* and hit enter. For me this is chown +10006:+10006 /data/data/com.android.providers.contacts/databases/contacts2.db*
    15. Reboot immediately by typing reboot and hitting enter.
    16. All done. Your contacts database has been restored.

    Method #2 - Recovery
    Took a backup with your custom recovery before processing? Just restore from the backup to get your device back to normal.

    Credits

    Licensing
    Copyright © 2015-2016 Kevin Mark. Clarity is licensed under the GNU General Public License, Version 3, which can be found in LICENSE.md

    Clarity is developed in my spare time and will always remain free and open-source software. If you find this application useful please feel free to donate.

    XDA:DevDB Information
    Clarity, Xposed for all devices (see above for details)

    Contributors
    Kevin M
    Source Code: https://github.com/kmark/Clarity

    Xposed Package Name: com.versobit.kmark.clarity

    Version Information
    Status: Stable
    Current Stable Version: v1.2-cfad189
    Stable Release Date: 2016-07-03

    Created 2015-03-25
    Last Updated 2016-07-23
    3
    Clarity

    ROM Compatibility
    Clarity should work with CyanogenMod and other closely AOSP-based ROMs. Other ROMs like the stock ones found on most popular Android devices may not work with Clarity. If you have a device or ROM that Clarity works or does not work with (and is not already on the below list) please tell me!

    LG G2
    • CyanogenMod 12

    LG G3
    • SkyDragon (Lollipop)

    Motorola Droid X2
    • CyanogenMod 10

    Nexus 6
    • Temasek

    OnePlus One
    • BlissPop 2.2
    • Temasek 5.0.2

    Samsung Galaxy Note II N7100
    • CyanogenModX 5.0.2

    Samsung Galaxy Note 4
    • CyanogenMod 12 (3/24 nightly)
    • Stock (doesn't work? try this)

    Samsung Galaxy S4
    • CyanogenMod 11
    • CyanogenMod 12
    • CyanogenMod 13

    Xperia J
    • Xperia Revolution ROM

    ROM Incompatibility
    Moto X (2013)
    • Stock (Android 4.4)
    3
    Looks Promising !!!!

    Thank you. The application is now available.
    2
    Thank you for the bug reports. I have 6.0.1 on my test device now and I'll be looking into the issue when I can. Unfortunately I have no plans to widen support to devices/ROMs that have heavily modified their contacts system. If it almost works on a given device we can try to work it out but no promises. ;)
    2
    v1.1-93b7945

    Hey guys. A new version of Clarity is now available. Below is the changelog for your convenience.

    Code:
    v1.1-93b7945 - 03 May 2015 - Stable
    ------------
    This release introduces the following improvements:
    * The database processor will no longer fail if contacts2.db-journal
      cannot be found. It will note the absence of the journaling file
      in the log and proceed as normal
    * Will now increase the size and quality of locally stored album art.
      Suggested by @Karamvir Singh.
    * An XXXHDPI icon
    * Updated donation links
    * Minor log bug fix
    * Better shell usage
    * Less condescending toast notifications

    From the README on the album art fix:
    When the Xposed module is activated, Clarity will also up the size of locally stored album art (for instance, MP3s on the external storage). Just like the contact thumbnail part of the module, existing album art is unaffected. To get Android to reprocess all the album art on your device you must delete all the files found in the albumthumbs directory. This is usually found somewhere on your external storage. Popular paths are /storage/emulated/legacy/Android/data/com.android.providers.media/albumthumbs and /storage/sdcard0/Android/data/com.android.providers.media/albumthumbs. Different devices and ROMs can have different paths but the last /Android/data/com.android.providers.media/albumthumbs bit should stay the same. Once that directory has been cleared out, higher quality album art will be regenerated by Android on demand (as they are needed). See Android issue 73635 for more information about the album art problem.

    The first and second posts have also been updated with some helpful information like how to restore your contacts from the backups and which devices are known to be compatible / incompatible. Enjoy.