Skip to content

Home

Jump to bottom
ip edited this page Aug 13, 2020 · 11 revisions

mHide Get Props

Originally (and still) written to be used with MagiskHide Props Config module.
This script is written to be used in a lot of different situations.

The main purpose of mHideGP is to gather prop values from a stock boot image, stock recovery image or the device itself.

mHideGP will generate a file named mhp_Brand_Model_BuildDateTime or mhp_Model_BuildDateTime (depending on the device) that will contain the system build fingerprint, security date and other needed and useful device props.

The mhp file is formatted to be used as a custom fingerprint list for the MagiskHide Props Config module.
You will need to rename the mhp file to printslist
See the MagiskHide Props Config instructions on using a custom fingerprint list.

If a boot or recovery image is used, you will need to unpack the image file first.
mHideGP relies on the use of Android Image Kitchen (AIK) by osm0sis for unpacking a boot or recovery image.
If used with a different method to unpack an image file, make sure to make changes in the script(s) accordingly.

Quick Links

Instructions

Examples

mHideGP

Sets the current (working/target) directory to the same directory that the script file is in.
It will generate a file named mhp_Brand_Model_BuildDateTime or mhp_Model_BuildDateTime depending on the device.

If a ramdisk directory exists in the current directory, it will check for a prop.default or a default.prop file there first.
Then check for a build.prop, prop.default, default.prop or getprop.props file in the current directory.
The first available prop file found will be used, the others will be ignored.

On an Android Device, if no prop file is available, it will try to generate a getprops.props file using the getprop command.

If a certified.list file is in the current directory, mHideGP will check if the device is on the certified list.
If the device is on the list, mHideGP will use the Manufacture (Retail Branding) and Name (Marketing Name) from the certified list to clean up the generated mhp file.

To use the mHideGP script to generate a getprops.props file. (Android)

  • Copy mHideGP to a directory on the device.
  • Copy certified.list to the same directory on the device. (Optional)
  • Run the mHideGP script.

To use the mHideGP script with a device prop file. (Android, MacOS and Linux)

  • Copy mHideGP to a directory.
  • Copy certified.list to the same directory. (Optional)
  • Copy a prop file to the same directory.
  • Run the mHideGP script.

To use mHideGP with multiple prop files, see prop_mHideGP.

To use the mHideGP script with a stock boot or recovery image file. (Android, MacOS and Linux)
AIK requires root access.

  • Install Android Image Kitchen (AIK).
  • Copy mHideGP to the AIK directory.
  • Copy a boot or recovery image files to the AIK directory.
  • Copy certified.list to the AIK directory. (Optional)
  • Run AIK's unpackimg script.
  • Run the mHideGP script.
  • Run AIK's cleanup script.

To use mHideGP with multiple image files, see aik_mHideGP.

concat_mHideGP

Sets the current (working/target) directory to the same directory that the script file is in.
It will combine the mhp files, generated by the mHideGP script, into a one mHide-printslist-CurrentDate file.

mHideGP can only read one prop file at a time and will generate a file named mhp_Brand_Model_BuildDateTime or mhp_Model_BuildDateTime (depending on the device) each time it is run.

The concat_mHideGP script will combine all the mhp_Brand_Model_BuildDateTime and mhp_Model_BuildDateTime (generated by the mHideGP script) into a new mHide-printslist-CurrentDate file.

To use the concat_mHideGP script. (Android, MacOS and Linux)

  • Copy concat_mHideGP to a directory.
  • Copy the mhp_Brand_Model_BuildDateTime and mhp_Model_BuildDateTime file(s) to the same directory.
  • Run the concat_mHideGP script.

aik_mHideGP

Sets the current (working/target) directory to the same directory that the script file is in.
Requires Android Image Kitchen (AIK)

To use mHideGP with a boot or recovery image file, you have to unpack the image first.
This is done in three steps with AIK's unpackimg and cleanup scripts along with the mHideGP script.
To use the mHideGP script with a stock boot or recovery image file, see mHideGP.

This script will run the three steps on all the image files in the AIK directory.
AIK's unpackimg to unpack the image, mHideGP to generate a mhp file, and AIK's cleanup to cleanup.

Like the concat script, it will also combine all the mhp files that are in the current directory in into a new mHide-printslist-CurrentDate file.

If you used mHideGP to generate a mhp file that you want to be include in the new mHide-printslist file, just copy it into the AIK directory before running the aik_mHideGP script.

Since the mHideGp script will look for a prop file outside of the ramdisk directory, this script will extent it.
If the file is named build.prop, prop.default, default.prop or getprop.props, it will be appended by adding the file date to the beginning.
YearMonthDay_build.prop for example.

After running mHideGP on the image files, it will look for additional prop files ending with, build.prop, prop.default, default.prop or getprop.props then run mHideGP on each.
To use this option, you will need to name the prop files correctly, see prop_mHideGP.

Unlike the concat script, aik_mHideGP will delete the mhp_Brand_Model_BuildDateTime and mhp_Model_BuildDateTime files as part of the cleanup portion of the script.
Backup files are ignored by all of the mHideGP scripts. They will not be used, merged or deleted.

To use the aik_ mHideGP script. (Android, MacOS and Linux)
AIK requires root access.

  • Install Android Image Kitchen (AIK).
  • Copy aik_mHideGP to the AIK directory.
  • Copy mHideGP to the AIK directory.
  • Copy one or more boot and/or recovery image files to the AIK directory.
  • Copy certified.list to the AIK directory. (Optional)
  • Copy extra mhp generated files to the AIK directory. (Optional)
  • Copy additional prop files to the AIK directory. (Optional)
  • Run the aik_mHideGP script.

prop_mHideGP

Sets the current (working/target) directory to the same directory that the script file is in.

You will need to name the prop files correctly.

This script will look for file(s) named or ending in build.prop, prop.default, default.prop or getprop.props then run the mHideGP script on all the prop files found.

If the file is named build.prop, prop.default, default.prop or getprop.props it will be appended by adding the file date to the beginning.
YearMonthDay_build.prop for example.

To use multiple build.prop files, you will need to rename them since you can not have more than one file named build.prop
Just as long as the file name ends in build.prop

Example
Device1-build.prop - Device-2_build.prop - SomeRandomName_build.prop - My-Device_00_build.prop - Examplebuild.prop
(This would be the same for prop.default, default.prop and getprop.props files.)

Then combine all the mhp files that are in the current directory in into a new mHide-printslist-CurrentDate file.
If you used mHideGP to generate a mhp file that you want to be include in the new mHide-printslist file, just copy it into the directory before running the prop_mHideGP script.

Unlike the concat script, prop_mHideGP will delete the mhp_Brand_Model_BuildDateTime and mhp_Model_BuildDateTime files as part of the cleanup portion of the script.
Backup files are ignored by all of the mHideGP scripts. They will not be used, merged or deleted.

To use the prop_mHideGP script. (Android, MacOS and Linux)

  • Copy mHideGP to a directory.
  • Copy certified.list to the same directory. (Optional)
  • Copy prop file(s) to the same directory.
  • Run the prop_mHideGP script.

get_cert_list

Sets the current (working/target) directory to the same directory that the script file is in.
It will download and convert the public HTML list into a text file named certified.list with tab spacing for the four columns.
Retail Branding, Marketing Name, Device, Model

This script generates a file named certified.list

It is easier and quicker to search a text file than waiting for a website based table to load.
Especially one that has over 29,000 entries.

Note
This script currently keeps a copy of the HMTL file and the corresponding certified.list file as part of the backup. These backups are not necessary and only saved for reference. They are saved to a directory named xfiles in the current directory.

To use the get_cert_list script. (MacOS and Linux)

  • Copy get_cert_list to a directory.
  • Run the get_cert_list script.
Clone this wiki locally