UICC Browser

June 14, 2026 ยท View on GitHub

UICC Browser is an Android application for viewing and editing the contents of UICC. A combination of this application and your older Android phone may be usable as an alternative to your PC/SC card reader and reader/writer software.

The application does not distinguish between physical SIM cards and eSIM profiles. Any active eSIM profile can therefore be accessed in the same way as a physical SIM card.

This project is intended for users who already understand SIM/UICC file structures and the risks of modifying card contents.

Setup

UICC Browser requires Android system-level privileges, so it can only be used on rooted Android device. The author has tested the application on an older Google Pixel 4 with Magisk installed.

If you use Magisk, the easiest installation method is to install the released ZIP file from the Magisk "Modules" tab.

The application specifically requires the following privileged Android permissions:

  • READ_PRIVILEGED_PHONE_STATE
  • MODIFY_PHONE_STATE

Any installation method should work as long as it can grant these permissions to the application. For example (if this method is available);

$ adb shell pm grant com.github.cheeriotb.uiccbrowser android.permission.READ_PRIVILEGED_PHONE_STATE
$ adb shell pm grant com.github.cheeriotb.uiccbrowser android.permission.MODIFY_PHONE_STATE

The minimum supported Android version is Android 13, which corresponds to SDK 33. The current target SDK version is 35.

Build

Use the Gradle wrapper to build and test the project.

$ ./gradlew assembleDebug
$ ./gradlew testDebugUnitTest --stacktrace

Functionalities

UICC Browser currently provides the following features:

  • Select the target SIM card or eSIM profile from the icon at the top of the navigation view when multiple profiles are active on the device.
  • Check whether the EFs described in the JSON resource files exist on the card, and list the EFs that are present.
  • Read and display the data of the selected EF.
  • Display the FCP template of the selected EF.
  • Enable "Pro Mode" at the bottom of the navigation view to add "Edit" to the options menu on the EF data screen.
  • Enter Edit Mode after selecting "Edit" and successfully verifying the required PIN code or ADM key.

The following screen shows Edit Mode for a selected EF.

edit mode

The following screen shows an EF update operation after editing its contents.

update

Warning

Editing UICC contents can break SIM functionality or make a profile unusable. Use this application only with cards and profiles that you are prepared to recover or replace. The author is not liable for any damages or consequences resulting from the use of this application.

Limitations

Current limitations are listed below.

  • Only USIM and ISIM are supported as ADF.
  • BER-TLV EFs are not supported yet.
  • Cyclic EFs are readable, but not editable.
  • The following DFs are not supported yet.
    • DFHNB '5F50'
    • DFSoLSA '5F70'
    • DFBCAST '5F80'
    • DFProSe '5F90'
    • DFACDC '5FA0'
    • DFTV '5FB0'
    • DFSAIP '5FD0'
    • DFSNPN '5FE0'
    • DF5G_ProSe '5FF0'
    • DF5MBSUECONFIG '5FF1'
  • EFIAP, EFADN, EFEXT1, EFPBC, EFGRP, EFGAS, EFANR, EFSNE, EFCCP1, EFUID, EFEMAIL and EFPURI under DFPHONEBOOK are not supported yet.
  • EFTPRPK under DFMexE is not supported yet.
  • EFIIDF under DFGRAPHICS is not supported yet.
  • Special EF operations such as create, delete, and resize are not supported.
  • Some features have not been fully verified because the number of SIM cards and devices available for testing are limited.

License

This software is released under the MIT License, see LICENSE.

Author

Cheerio (cheerio.the.bear@gmail.com)

References