[2013.06.15] SuperSU v1.34

---

SuperSU is the Superuser access management tool of the future

!!! SuperSU requires a rooted device !!!

SuperSU allows for advanced management of Superuser access rights for all the apps on your device that need root. SuperSU has been built from the ground up to counter a number of problems with other Superuser access management tools.


Features include:

- Superuser access prompt
- Superuser access logging
- Superuser access notifications
- Per-app notification configuration
- Temporary unroot
- Deep process detection (no more unknowns)
- Works in recovery (no more segfaulting)
- Works when Android isn't properly booted
- Works with non-standard shell locations
- Always runs in ghost mode
- Wake on prompt
- Convert to /system app
- Complete unroot
- Backup script to survive CyanogenMod nightlies
- Icon selectable from 5 options + invisible
- Theme selectable from 4 options
- Launch from dialer: *#*#1234#*#* or *#*#7873778#*#* (*#*#SUPERSU#*#*)
NOTE: Not all phones take both codes. On some phones you need to use single *# instead of double *#*#

The Pro version additionally offers:

- OTA survival mode (no guarantees)
- Full color-coded command content logging (input/output/error)
- Per-app logging configuration
- Per-app user override
- Grant/deny root to an app for a set amount of time
- PIN protection
- Per-app PIN protection
- Adjust auto-deny countdown


PROTIP:

For extra performance, disable notifications. Logging does not impact performance much.


Redistribution

Yes, you are allowed to embed the (free, non-Pro) SuperSU apk and su binaries in your own custom ROMs ! As is standard (and done by the attached ZIP), normal is to use /system/app/Superuser.apk for the apk and /system/xbin/su for the binary.


Want to help translate ?

See SuperSU project on GetLocalization ! http://www.getlocalization.com/supersu/


Download:

SuperSU on Google Play (free)

SuperSU *Pro* on Google Play (Pro/donate addon, requires free version)

CWM / TWRP / MobileODIN installable ZIP: UPDATE-SuperSU-v1.34.zip
ZIP does not work on all devices, needs fix. Note that if you are already rooted, installing through Play is by far the easiest way to install SuperSU !
ZIP also only for ARM devices, no x86 support yet. Use the TWRP/CWM installer option inside the app itself on x86 devices.

Education

Want to learn how to use "su" correctly from your own apps ? How-To SU !


ROM Developers

Feel free to include the (free version, unmodified) SuperSU APK in your ROMs. You do not need to ask me for permission to include it.

However, you should be aware that SuperSU sometimes adds a "please upgrade" notice to toast notifications when an app is granted root access. As this can interfere with the look and feel of your carefully crafted ROM, you can include this APK (SuperSU NoNag APK) in your ROM as well to disable that notice. It requires SuperSU v1.03 or newer to work. In return for including the NoNag, it would be nice if you would include minor advertisement in your ROM description, such as "Powered by SuperSU", or "Please support SuperSU". This is not a requirement, merely a request.

Who, what, why ?!

---

As you may know, I make a lot of apps that use or require root. I also release rooted kernels. I run into a lot of issues with existing Superuser tools. More importantly, a lot of my users run into these issues as well and then email me about it. So I decided to do something about this. Doesn't mean these were problems you have ever seen, or will ever see.

And thus, I have written - pretty much from scratch - SuperSU. I have taken the su binary command line parameter parsing from Superuser, to make sure that is compatible. Aside from that, it is completely rewritten, because how I wanted to do a number of things was incompatible with the existing codebase.

This is not a stab at ChainsDD, or his skills. He has done great work and will no doubt continue to do so, however, I felt the need for some of these changes, and thus made them. This is an early release, so I expect there will be some unforseen issues somewhere.

From now on, all CF-Root and Mobile ODIN Pro (EverRoot) releases will be built around SuperSU.

Please note that SuperSU is not hardened-security-tested or reviewed, and may be exploitable (... as may other solutions ...).

Changelogs

---

15.06.2013 - v1.34
- Fixed various problems when accessibility options are enabled
- Fixed NPE in log screen
- Updated language files

07.06.2013 - v1.32
- Fixed bug in detection ACCESS_SUPERUSER permission
- Updated language files

21.05.2013 - v1.30
- Updated binary to work on some newer Samsung firmwares
- Nagging has done its job for now - disabled again
- Added backup script and CWM SU files to full unroot file removal
- Added option to remove other superuser apps
- Updated languages files

03.03.2013 - v1.25
- Fixed permission display on Play
- Fixed crash on open and immediate close
- Ask again time choice is now remembered per-app
- Updated language files

28.02.2013 - v1.20
- Added basic tablet theme
- New prompt activity for >= API 14 (Android 4.0)
- Changed default theme+icon to light+emblem (you can change it back in settings, if you want)
- Fixed custom dialog box themes in light+darkactionbar theme
- Fixed issues with the light theme
- Various minor modifications to UI
- Several security improvements
- Added TWRP/CWM binary installer
- android.permission.ACCESS_SUPERUSER - detection and display (disabled by default, see settings)
- Fixed process name detection issue
- Freeloader option (I'm not sure this is staying, so enjoy it while you can)
- Internal refactoring
- Updated language files

23.02.2013 - v1.10
- Added support for x86 devices
- Added basic multi-user support
- Language files updated

20.02.2013 - v1.05
- Fixed possible issue with OTA survival
- Fixed su binary notification freeze issue when suid bit lost
- Fixed background root command freeze when suid bit lost
- Improved su binary version and root presence detection
- Added cleanup stage (detected when needed) before converting to system app, to prevent settings loss
- Language files updated

02.01.2013 - v1.04
- PIN code now survives uninstalling Pro (vuln. fix)
- Fixed pm freeze in logs/settings (USB debugging)
- Fixed various util freezes (convert to system, uninstall) (USB debugging)
- Fixed minor UI text issues
- Language files updated

31.01.2013 - v1.03
- Fixed pm crash in logs/settings
- Reduce nag frequencey to 10%
- Add NoNag APK
- Language files updated

30.01.2013 - v1.02 - NOTES ON DUMPSTATE (click)
- Fixed (another) crash on icon change on Android versions older than 4.0.3
- Launch SuperSU through secret codes: *#*#1234#*#* and *#*#7873778#*#* (*#*#SUPERSU#*#*). Not all phones take both codes. On some phones you need to use single *# instead of double *#*#
- Update su binary parameter parsing to add Google-naive style params
- Dumpstate blacklist
- Language files updated

29.01.2013 - v1.01
- Fixed crash on icon change on Android versions older than 4.0.3
- Adjusted (un)installer code to remove .odex files and remove dalvik caches
- Adjust default icon in manifest
- Dumpstate no longer goes into infinite loop (dumpstate shouldn't kill phone anymore, but this has not fixed dumpstate being triggered - workaround !)
- Language files updated
- Adjusted update ZIP to remove .odex files, overwrite OTA survival binary, remove dalvik caches

28.01.2013 - v1.00 - RELEASE NOTES (click)
- Icon now selectable from 5 options, or hide completely from launcher (see note)
- Theme now selectable from 4 options
- (Pro) Added option to grant/deny with a timer (hold grant/deny button in popup for two seconds)
- Added option to convert to system app
- Added option to trust system user without confirmation
- (Pro) Added option to adjust auto-deny countdown
- (Pro) Added option to PIN protect on a per-app base
- Added option to auto-refresh apps/logs tab
- Fixed "ask again" being forgotten
- CyanogenMod: Added to option to respect/ignore DevOptions --> Root Access setting
- CyanogenMod: Added option to install addon backup script (survive update flashes)
- Fixed 7" tablets now use (improved) large PIN panel
- Free space detection issue work-around (may fix a number of binary installation failures)
- Alternate remount method (may fix binary installation issues on Android 2.x)
- Updated su binary parameter parsing
- Updated su binary to add user-related environment variables
- Adjusted cleanup and copyright texts
- Fixed autoclose upon cleanup complete
- Faster preference text loading
- Faster settings tab fragment instantiation
- Reworked native debug logging
- Reworked shell detection, now includes /system/bin/mksh fallback
- Adjustments that may reduce problems for S-ON users
- Added nag message to non-Pro (with option to disable)
- Language files updated
...
* to start hidden SuperSU from ADB shell with root rights: am start -a android.intent.action.MAIN -n eu.chainfire.supersu/.MainActivity

04.12.2012 - v0.99
- More Android 4.2 related fixes
- Disabled text correction on labels
- Updated languages

14.11.2012 - v0.98

Preliminary update for Android 4.2's multi-user capabilities.
Only the main user can run the UI and gain root access.
Secondary user's apps will not be granted root, nor can
those users change SuperSU configuration.

This is all temporary. Proper multi-user support is being
worked on.

Note that if a non-user process (like ADB shell) needs to
prompt for root, that prompt will always appear on the
MAIN user's screen !

29.10.2012 - v0.97
- Fixed issue with modified AOSP su binary
- Fixed wrong translation crashing app on toast
- Fixed possible exploit (preventive)
- Modified system and shell user - no longer granted root by default
- Added "ADB shell" display
- Added warning to selecting full content logging
- Added method for apps to disable (by default only) full content logging if known to be problematic (<meta-data android:name="eu.chainfire.supersu.meta.contentlog ging.problematic" android:value="true" />, see How-To SU)
- Updated languages

29.08.2012 - v0.96
- Fixed occasional issue with OTA
- Fixed possible exploit (preventive)

22.08.2012 - v0.95
- Fixed action bar icon sizes
- Fixed a few JellyBean-related issues
- Added automatic binary updated during boot if needed and possible
- New logo/icons
- Updated languages

16.07.2012 - v0.94
- Fixed possible NPE crash at startup
- Fixed possible ANR freeze at boot
- Fixed possible ANR freeze at package removal
- Fixed crash with too many logfiles (auto-empties logs!)
- Updated various internal functions to be async
- Updated chattr version (fixes some instances of root loss)
- Added "clear logs" action to actionbar in logs tab
- Updated languages

03.07.2012 - v0.93
- Fixed a possible delay issue (receiver deadlock)
- Updated languages

21.06.2012 - v0.92
- Fixed app detail spinners becoming invisible
- Fixed app detail button layout (diff. for port/land)
- Fixed log detail crash at rotate
- Fixed language override stick at display rotation
- Fixed display of languages without countries in override
- Fixed potential low space installation issue
- Fixed icon rearrange issue (except when low on space)
- Updated languages

18.06.2012 - v0.91
- Fixed root permission check (OTA survival)
- Fixed a number of possible installation failures
- Fixed language detection crash issue
- Added multilanguage support (27 languages and counting)

11.06.2012 - v0.90
- Fixed various texts
- Fixed various crash issues
- Fixed various non-response issues
- Fixed possible security issue
- PIN code now requires verification before changing
- Added title and navigation to log detail activity

07.05.2012 - v0.89
- Fixed stay-on-top issue
- Fixed possible exploit
- Improved security

23.04.2012 - v0.88
- Fixed a number of performance issues
- Added re-authentication option
- Apps now sorted alphabetically
- Voodoo OTA Root Keeper backup removed at binary install

26.03.2012 - v0.87
- Fixed an issue with several apps re-requesting root
- Fixed a number of reported crashes
- Fixed a few ANRs

26.03.2012 - v0.86
- Fixed a cleanup issue

26.03.2012 - v0.85
- Fixed issue if root is disabled during update

25.03.2012 - v0.84
- Modified OTA survival behavior - re-enable this setting if needed !
- Modified SH search order
- Modified backup shell location
- Added cleanup for reinstallation option
- Added cleanup for switching superuser app option
- Added cleanup for full unroot option
- If the APK is not installed, root is always granted

17.03.2012 - v0.83
- Fix command not visible
- Fix zombie process freeze
- Fix zombie process cleanup
- Fix -c followed by multiple parameters
- Fix high cpu load issue
- Fix STDIN closed relay
- Fix log display bug
- Fix swipe empty tabs
- Improved swipe behavior
- Added app title
- Added refresh button

14.03.2012 - v0.80
- Reversed swipe direction
- Adjusted touch response
- Adjusted request queueing
- Adjusted time counter
- Non-prompt notifications now async
- Permissions auto-removed if an app is uninstalled

12.03.2012 - v0.78
- Adjusted prompt-on-boot behavior
- Adjusted request serialization
- Added swiping between tabs
- Fixed force user setting
- Pro: fixed faulty SuperSU restored message

10.03.2012 - v0.75
- Adjustment to OTA survival (better!)
- Slight speedup in Settings
- Fixed native settings update after temp-re-root
- Clear data no longer clears PIN code
- Layout: Prompt: Grant and Deny switch positions (ICS style)
- Layout: AppDetail: Save and Cancel switched positions (ICS style)
- Layout: Added xlarge PIN layout

10.03.2012 - v0.74
- Proper command escaping
- Fixed inifinite loop
- Fixed notification broadcast (should fix all freezing issues)

09.03.2012 - v0.73
- Fixed su binary detection problem
- Fixed two FC's in settings
- Disabled some debug stuff that was left enabled in v0.72

09.03.2012 - v0.72
- Minor adjustments to install script
- Fixed issue with really old SU version detection

09.03.2012 - v0.71
- Fix permission problem due to faulty installation
- Added error message if device is not yet rooted
- Cancelling binary update now closes app

09.03.2012 - v0.70
- Initial public release

Multi-language tests

---

RIGHT NOW THE "NORMAL" SuperSU RELEASE IS NEWER THAN THIS LANGUAGE TEST

This will be updated again soon with new languages and fixes

Language Test #3

Here is the second multi language test for SuperSU !

Based on

SuperSU v0.90

Included languages

- Chinese (China)
- Croatian
- Czech (Czech)
- Danish
- Dutch
- Finnish
- French
- German
- Georgian
- Greek
- Hungarian
- Indonesian
- Italian
- Korean
- Lithuanian
- Polish (Poland)
- Portuguese (Brazil)
- Portuguese (Portugal)
- Romanian
- Russian
- Malaysian
- Norwegian
- Slovak
- Spanish
- Swedish
- Turkish (Turkey)
- Ukrainian

More languages ?

Some more languages are under development, but were not close enough to "done" to being included.

How to help ?

The translations are hosted here: http://www.getlocalization.com/supersu/

You can create an account or login and help with the translations, correct errors, add a new language, etc !

Reporting problems

Report application crashes (these may be caused by faulty translations on very rare occassions) directly to me, Chainfire. You can just post in this thread here.

If there are problems in translations, something is wrongly translated, something is not translated at all, etc, please see the translation website: http://www.getlocalization.com/supersu/.

You can create an account or login and correct the problem, vote for a different translation, etc.

Installing

As this test is based on an existing SuperSU version, you may need to uninstall that first. Start SuperSU, go to the Settings tab, and select the "Reinstall (from Google Play)" option. Then install the attached version of SuperSU.

You can just copy the attached APK to your phone and open it with a file manager. Or if you are an ADB user, "adb install <filename>".

Note that you may need to enable applications to be installed from unknown sources. This is a setting somewhere in the Settings app. I'd tell you exactly where, but this differs per Android version (if you can't find it, ask in the forums dedicated to your phone model).

BIG THANKS TO EVERYONE WHO HAS HELPED OR IS STILL HELPING WITH TRANSLATIONS !

Nice, I shall be updating my version

Sweet dude
Awesome update !

Will SuperSU be able to manage the su binary included on a userdebug build of AOSP? Or does SuperSU download its own binary?

Thanks

Originally Posted by crachel

Will SuperSU be able to manage the su binary included on a userdebug build of AOSP? Or does SuperSU download its own binary?

SuperSU uses it's own binary.

Can I just say this is badass !!! Just saying !!

Originally Posted by Chainfire

SuperSU uses it's own binary.

can i remove existing SU app from my ROM and install this one? or do i have to keep both of them?

After flashing this, though i have granted the permissions, still apps say that, it did not get the permissions for root access and the screen just stays blank!