/ruuveal

A HTC RUU decryption utility

Primary LanguageCGNU General Public License v3.0GPL-3.0

ruuveal

ruuveal decrypts encrypted zip files contained in RUUs released by HTC.

ruuveal has been (somewhat) tested but that doesn't mean it won't cause the end of the world as we know it. You have been warned.

You will need to extract the zip file from the RUU executable before you can use this tool - use Google, there are a few methods.

One such method is unruu, available from:-

Supported Devices

The following devices are currently supported by ruuveal:-

  • HTC One SC (cp2dcg)
  • HTC One ST (cp2dtg)
  • HTC One SU (cp2dug)
  • HTC Desire 600 SC (cp3dcg)
  • HTC Desire 600 - China Mobile (cp3dtg)
  • HTC Desire 600 - China Unicom (cp3dug)
  • HTC Desire 600 - EDTG (cp3edtg)
  • HTC Desire 700 - China Mobile (cp5dtu)
  • HTC Desire 700 - China Unicom (cp5dug)
  • HTC Desire 700 - China Telecom (cp5dwg)
  • HTC 603e - China Unicom (csndug)
  • HTC J Butterfly (deluxe_j)
  • HTC J DNA (deluxe_u)
  • HTC Butterfly (deluxe_ub1)
  • HTC Butterfly S - China Mobile (dlpdtu)
  • HTC Butterfly S - China Unicom (dlpdug)
  • HTC Butterfly S - China Telecom (dlpdwg)
  • HTC Butterfly S (dlxp_u)
  • HTC Butterfly S LTE (dlxp_ul)
  • HTC One XT (endeavor_td)
  • HTC One X (T3) (endeavor_u)
  • HTC One X+ (enrc2_u)
  • HTC One X+ (enrc2b_u)
  • HTC One X (S4) (evita)
  • HTC One X+ LTE (evitare_ul)
  • HTC Incredible 4G LTE (fireball)
  • HTC One XC (jel_dd)
  • HTC Evo 4G LTE (jewel)
  • HTC One SV (k2_plc_cl)
  • HTC One SV (k2_u)
  • HTC One SV (k2_ul)
  • HTC One Mini U (m4_u)
  • HTC One Mini UL (m4_ul)
  • HTC One U (m7_u)
  • HTC One UL (m7_ul)
  • HTC One WLJ (m7_wlj)
  • HTC One WLS (m7_wls)
  • HTC One WLV (m7_wlv)
  • HTC One - China Mobile (m7cdtu)
  • HTC One - China Unicom (m7cdug)
  • HTC One - China Telecom (m7cdwg)
  • HTC Desire SV (magnids)
  • HTC Droid DNA (monarudo)
  • HTC First (mystul)
  • HTC Desire X (proto)
  • HTC T329d (protodcg)
  • HTC Desire V (protodug)
  • HTC T329t (prototd)
  • HTC One Max - China Unicom (t6dug)
  • HTC One Max - China Telecom (t6dwg)
  • HTC One Max TL (t6tl)
  • HTC One Max U (t6u)
  • HTC One Max UL (t6ul)
  • HTC One Max ULA (t6ula)
  • HTC One Max WHL (t6whl)
  • HTC One Max WL (t6wl)
  • HTC One VX (tc2)
  • HTC One S (ville)
  • HTC One S C2 (villec2)
  • HTC Desire 500 TD (z4td)
  • HTC Desire 601 CL (zara_cl)
  • HTC Desire 601 WL (zara_wl)

If your device is not supported and you would like it supported please open an issue in the tracker with the device name, codename and a link to the most recent hboot file for the device. (Not a link to the full RUU!)

Compilation

ruuveal requires the development files for mcrypt. On Debian/Ubuntu based systems you can probably get these by installing the libmcrypt-dev package. On Redhat based systems the package to install is probably libmcrypt-devel.

Once you have these files you can compile the development tree as follows:-

$ ./autogen.sh
$ ./configure
$ make

Please note that once release tarballs area made the autogen.sh step will not be required since release tarballs ship with the configure script and the Makefile already generated.

Downloads

Downloads are currently available from:-

Usage

$ ruuveal [options] --device DEVICE source.zip output.zip

For example:

$ ruuveal --device jewel rom_01.zip rom_01_decrypted.zip

Once you have decrypted the zip file, it should unzip with any standard zip utility.

Bugs/Issues

Please report any bugs/issues you find - Thanks!

Credits

  • joeykrim - Making me aware HTC has released an encrypted RUU.
  • RaYmAn - Being a sounding board / working through some weird logic.
  • HTC - For continuing to release great devices.