[TOOL][WIN/LIN/MAC] MiUnlockTool - Unlock bootloader of xiaomi devices on mac & linux

Search This thread

frandavid100

Senior Member
Aug 5, 2009
490
14
Valencia
First off, thanks for your hard work. I'm trying to use your tool on Fedora, and I'm not sure if everything's working right.

If I just type 'sudo ./MiUnlockTool.sh', it says 'Unable to start gui application. Are you running this tool on a display environment?'

Which is not a big issue, since I can simply type 'sudo ./MiUnlockTool.sh (username) (password)' to run the tool in CLI mode.

But when I do that, I get a 'Add your account and device in MIUI's Settings' error. Which is weird, because I've already linked my account to the phone in the 'Mi unlock' screen of the Settings.

Does that error message always appear when I still have to wait for some hours? Or should I be getting a different message?
 

Black_Stark

Senior Member
Sep 24, 2012
3,498
1,020
GOA
First off, thanks for your hard work. I'm trying to use your tool on Fedora, and I'm not sure if everything's working right.

If I just type 'sudo ./MiUnlockTool.sh', it says 'Unable to start gui application. Are you running this tool on a display environment?'

Which is not a big issue, since I can simply type 'sudo ./MiUnlockTool.sh (username) (password)' to run the tool in CLI mode.

But when I do that, I get a 'Add your account and device in MIUI's Settings' error. Which is weird, because I've already linked my account to the phone in the 'Mi unlock' screen of the Settings.

Does that error message always appear when I still have to wait for some hours? Or should I be getting a different message?
After adding account on phone u need to wait 72hours.
 

Black_Stark

Senior Member
Sep 24, 2012
3,498
1,020
GOA
Yes, I know I need to wait (although I'm not sure if it's 72 or 360 hours). My question is: should I be getting a "you need to wait xxx hours" message instead of a "you need to enable xxx option in the Settings"?

No. Just bind ur account in dev settings . also keep ur mi cloud sync on both with data and wifi.

Ur mobile hardware info should be synchronised with xiaomi server.
It takes couple of days.

When u try to unlock using tool then everything should match to that of server Then It will send u unlock key. Dont update or change rom from beta to stable. Just keep cloud sync on and wait for couple of days.

Make sure u enable oem unlock, usb debugging, and fastboot driver installed shows ur device is connected.

Try after 3 days.

I un locked my device 2yrs back. I dont know if u need to apply for permission to unlock or not.
 

k1ks

Senior Member
Jan 17, 2014
2,932
6,797
plus.google.com
Tips only for error "Exception in thread "main" java.lang.NoClassDefFoundError: javafx/application/Application"

sudo apt-get purge openjdk*
sudo apt autoremove
sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer
sudo apt install oracle-java8-set-default
JAVA_HOME="/usr/lib/jvm/java-8-oracle/jre/"
 
  • Like
Reactions: AdRi_232
D

Deleted member 7837819

Guest
a bit surprised with this tool and worked like charm on may mac

but rather than that, it reduced the waiting time for me. original xiaomi tool gives me 720 hours waiting time. so i was waiting. just with curiosity i have downloaded this and checked with this on my mac before ending my waiting time. it was 4 days. surprisingly this tool showed me no waiting time and just unlocked. amazing!
 

Fridiero

Member
Feb 14, 2012
9
1
Moscow
Hi! COuld you please help me? On mac I have such problem. I've installed jdk-11.

HTML:
Downloads/MiUnlockTool/MiUnlockTool.command ; exit;
Exception in thread "main" java.lang.NoClassDefFoundError: javafx/application/Application
	at java.base/java.lang.ClassLoader.defineClass1(Native Method)
	at java.base/java.lang.ClassLoader.defineClass(ClassLoader.java:1016)
	at java.base/java.security.SecureClassLoader.defineClass(SecureClassLoader.java:174)
	at java.base/jdk.internal.loader.BuiltinClassLoader.defineClass(BuiltinClassLoader.java:801)
	at java.base/jdk.internal.loader.BuiltinClassLoader.findClassOnClassPathOrNull(BuiltinClassLoader.java:699)
	at java.base/jdk.internal.loader.BuiltinClassLoader.loadClassOrNull(BuiltinClassLoader.java:622)
	at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:580)
	at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:178)
	at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:521)
	at com.xiaomitool.miunlock.Main.main(SourceFile:46)
Caused by: java.lang.ClassNotFoundException: javafx.application.Application
	at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:582)
	at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:178)
	at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:521)
	... 10 more
logout
Saving session...
...copying shared history...
...saving history...truncating history files...
...completed.

How can I solve this problem?
 
Last edited:
  • Like
Reactions: nunoMaga

hugolp

Senior Member
Mar 8, 2013
84
42
Hi

Solved: problem seem to be with my computer usb controller half dying.

I am trying to unlock a Poco F1 using this tool on linux and I am stuck at "Obtaining device info...". I have let it run at that stage for up to 20 minutes. I have tried through the GUI and console modes, same result.

I am using Ubuntu 16.04 and I have installed Java using this instructions. Using the open java implementation with openjfx packet did still produce an error when trying to run the GUI.

This is what I have done:

  1. Update the phone
  2. Enable developer mode and check USB debug and OEM unlock
  3. In the phone, sign in to my Mi account (which is a few years old), I have not verified my phone number if that matters
  4. Start your program, input Mi account login and password, and wait for it to ask me for fastboot mode phone
  5. Put Poco F1 in fastboot mode and connect it to computer

Your program recognizes the device and goes to "Obtaining device info...", just to get stuck there (both with GUI and console modes).

Any help appreciated.
 
Last edited:

cjlargear

Member
Jul 27, 2005
5
0
I am stuck on Loading... Unlocking Bootloader screen and nothing happens forever...What did I do wrong?
 

cjlargear

Member
Jul 27, 2005
5
0
Are u using GUI or terminal ?

GUI,I will also try cli to see if there is any difference...

On cli it stucks on last stage "Starting final unlock procedure"... and after a few tries it gives error 20034...

EDIT: CLI mode responds : [10:29:00][ERROR ] Error meaning: Current account cannot unlock this device
 
Last edited:

Imran21

New member
Dec 30, 2016
3
0
showing error

It shows error 20091 and says to add account and device. But when i try to add under developer option, it always shows error 20091. I have tried with vpn with china server but still this happens. Please help
device: redmi note 4x
miui global beta 8.9.20
 

djpatch

Member
Jan 8, 2012
22
2
It shows error 20091 and says to add account and device. But when i try to add under developer option, it always shows error 20091. I have tried with vpn with china server but still this happens. Please help
device: redmi note 4x
miui global beta 8.9.20
The same for me , ever 20091 error
 

martinaje

New member
Oct 29, 2018
2
0
Issue with select multiple files on mac?

Actually, I am also looking for the same thing when I select multiple files on my iPhone for sharing, It shows me an error regarding this and there has no connectivity through an app or network but I have still faced a problem. So please share any guideline about How to select multiple files on Mac .;):)
 

tilbud

New member
Nov 2, 2018
1
0
error 20041

thank you for this great tool!
...but unfortunately i got an unknown error :(

[14:29:23][INFO ] Querying unlock server for unlock key
[14:29:27][ERROR ] Unlock request replied with error code 20041
[14:29:27][ERROR ] Error meaning: Unknown error: %d

does anybody know this error?

regards
tilbud
 

Top Liked Posts

  • There are no posts matching your filters.
  • 53
    [TOOL][WIN/LIN/MAC] MiUnlockTool - Unlock bootloader of xiaomi devices on mac & linux

    Ciao xda users, I'm here to introduce a new tool of mine, MiUnlockTool.
    MiUnlockTool is an unofficial tool used to unlock bootloader on Xiaomi devices. This tool is copied from the original windows MiFlashUnlock tool and works the same way. The main feature of this tool is compatibility with linux and mac operating system (and windows too).
    If you want more information about the tool and the story behind you can read below, if you just want the download link, here it is:
    DOWNLOAD LINK
    Requirements: java (javafx for gui if not included in your jdk/jre)

    Usage:
    - Download and extract the zip file
    - If you don't have it, install java
    - On windows:
    -- open MiFlashUnlock.bat for graphical interface or:
    -- open a cmd windows and cd into extracted dir and use "MiUnlockTool.bat username password" command for command-line usage
    - On linux:
    -- open a terminal window and cd into extracted dir and use "sudo ./MiUnlockTool.sh" command for gui interface or "sudo ./MiUnlockTool.sh username password" for command-line
    - On mac:
    -- open (double click) MiFlashUnlock.command for graphical interface or
    -- open a terminal window and cd into extracted dir and use "./MiFlashUnlock.command username password" for command-line
    - Attach your locked device in fastboot mode.
    - If you are using gui just follow what you see on your screen
    - If you are using command line version remember that there is no confirmation request before unlock and no check if the bootloader is already unlocked.

    Possible errors:
    - If you get a permission related error on linux or mac when launching the tool, open a terminal and cd into extracted dir and use "chmod 777 MiUnlockTool.sh" (or MiUnlockTool.command on mac) to set the executable permission.
    - If your device isn't recognized:
    -- On windows: install adb drivers
    -- On linux/mac trying launching the tool with sudo (sudo ./MiUnlockTool.sh on linux or sudo ./MiUnlockTool.command on mac)
    - Other problems launching the tool: try running "java -jar bin/MiUnlockTool.jar" command
    - If you get some errors with javafx class not found stuff when you try to launch the gui, then you are missing javafx library. See openjfx package on linux.
    - Any other problem: provide feedback in the comments.


    Additional info: original MiFlashUnlock tool is just a bridge between fastboot, you (and your account login credentials) and xiaomi server: the tool gets device info from the device and send them to the server together with the account login token, the server checks wherever you satisfy all their requirements (account authorized, account associated with device in developer settings etc) and if everything is okay the server reply with the unlock key for your device instance (every time you reboot your phone you need a new key). Then the tool send the key to the device with a custom build of fastboot and if the key is right then the device is unlocked, else it reboots. After I discovered all the process behind the original unlock tool (and all the security encryption techniques) I decided to replicate it with a java (cross-platform) tool which embeds a custom fastboot version and replicates what the original tool does. That's a simple explaination of how my tool works (obviously it's more complicated than that).
    This tool requires all of what is required by the original tool (an authorized xiaomi account binded to the device through developer options for three days if I remember correctly).

    FAQs:
    - Is this tool safe to use?
    Yes, the main part is communication between tool and server, a safe thing. Also the unlock procedure itself is safe: or the key is correct or it is not. In both cases the device will not be damage.
    - How did you find out how to replicate the original tool?
    Thank you for your question. It's been a bit difficult since the original tool has been obfuscated and virtualized (protected against reverse engeneering) with a powerful protector: VMProtect. I've spent some time to reverse it (and custom fastboot too) and I finally did it. I will not explain in details how I did it.
    - Is this tool more powerful than the original on? why should I use it on Windows?
    Absolutely not, my tool is worst than the original one (it will have more bugs and on windows it doesn't manage drivers for example), that's why you should NOT use it on Windows. I made it work even with Windows because it was very simple to do. You can use it one Windows just to test it if you like, but I recommend using the better original tool MiFlashUnlock.
    - Wow, you did a tool already done by developers paid by xiaomi, who is paying for the effort you put into this?
    No one, I try to help people and getting appreciation for my work is a bit of a reward to me, but if you want to show your gratitude even more and support me as a developer you can make a donation, I will appreciate that even more ;) (donation link below)
    - I have to put my xiaomi account credentials, should I trust this?
    I'm the developer of XiaoMiTool, I hope that a little bit of my reputation together with the hopefully good early feedback of reckless users on this tool is enough. If you are more a geek you can track the traffic and see that the only server connected are xiaomi and miui.
    - I wanted too see the source of this tool but I see it is a bit obfuscated, why?
    Xiaomi clearly doesn't wanted people to see how MiFlashUnlock works (since they obfuscated it a lot), I don't want to disrespect xiaomi decision by releasing the source plain, so I decided to obfuscated it a bit just to make it a bit harder to see (even if my tool is 100 times easier to reverse than the original)
    - Can I share this tool?
    Of course yes, but I would like you to share it using the xiaomitool.com link (not mega.nz one) so that if I release an update new people will get that and not the old version (there is no tool update enginge built in).
    - You're english is not wonderful...
    I know, hopefully it is understandable enough


    Feedback.
    I love feedback, feedback is the best you can do to help me improving this tool. I have not time to answer everybody's questions but I generally read feedback and do my best to make the tool work. If the tool worked or if the tool didn't worked you can write it in the comments, adding additional information like what error you get, what screen you see when the tool get stuck or even what you tried to solve the problem are precious to me. I have not all of xiaomi devices, I fully ested my tool only with two devices (a redmi 4x and a mi note 2) and only on two operating systems (linux and windows), so any new combination could lead to new errors or problems. Please include also your operating system when leaving feedback. Sometimes there are problems on gui which are not on command-line version, so if the tools fails launching or when using gui I suggest trying the command-line version.

    Donation: free software is great from users prospective, but developers who spend hours of their time and don't get money for it are more unhappy to develop further free tools, so if you liked the tools and it saved you from the need to do 5000 kilometers to get a windows pc, or from the need to download a virtual machine image with your 32kB internet connection, you can show your gratitude by offering me a tasty, cold beer by clicking the link below ;)
    DONATION LINK

    Download: you missed the download link at the top? Here it is again:
    DOWNLOAD LINK
    8
    Fully obfuscated tool. Maybe bloatware or password hijacker
    4
    I'm using the latest Linux Mint but the MiUnlockTool don't work, do you know if there is another tool to unlock the bootloader using GNU/Linux?
    Unfortunately no. The only way that I found to unlock the bootloader was to install Windows and then use Xiaomi's unlock tool.
    I wrote a whole blog post about my experience doing it, but this forum won't let me post a link.
    To read it, search in Google for: "amosbbatto Why we don't own our mobile phones"

    Couldn't get Mi Unlock working on my Windows 10 for the life of me (Unlock button would stay grey even if I had plugged in my phone), but this seemed to work fine until it requested the unlock key.
    You either have to install the USB drivers from xiaomigeek.com or you have to register your phone at the Xiaomi web site. See my blog post about it.
    3
    So, uhh, is the author aware of the bug with %d displaying instead of something meaningful like hours until unlock?
    3

    Lol...using linux and dont know about sudo. We start with sudo for some actions if we want to run comand with admin rights.

    R u using terminal right?

    Then u need sudo command sometime.

    If u want to install app then u say
    sudo apt-get install nameofapp
    Or just go to ubuntu store and search android tools fasboot


    Then open terminal and run fastboot commands
    Connect phone to pc.

    fastboot devices

    fastboot oem device-info

    If its hangs use

    sudo fastboot oem device-info
    Enter password