Skip to content
forked from Dragon863/EchoCLI

A python command line tool for rooting your amazon echo 2nd generation

Notifications You must be signed in to change notification settings

viraniac/EchoCLI

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EchoCLI

A tethered root solution for your echo dot 2nd generation. To start, run main.py


 How does this work? 

⚠️ Warning!

Features

  • Rooted ADB shell over USB or Wi-Fi
  • Record audio from device
  • Use your Echo as an indicator for Home Assistant without internet
  • Restore your device to factory configuration

Install

This project requires python 3. I recommend using linux for running this program. Please ensure you have disabled ModemManager if you have it installed. Install requirements using pip:

pip install -r requirements.txt

Documentation

You can find how this tool works on my website.

Once you have rooted the device, a file called preloader_no_hdr.bin will be generated. To boot the device, you will need to install mtkclient, copy the file into its directory and run python mtk plstage --preloader=preloader_no_hdr.bin. Replace python with python3 depending on the python version you have installed.

Home assistant indicator

When using the home assistant indicator feature, I would recommend using a raspberry pi zero w or other small SBC to run the python flask server, and boot the device. You can use crontab to make this happen automatically on boot using mtkclient.

Thanks

This project would not have been possible without:

  • j10hx40r - For helping me with initially rooting my device, showing me how to use fos_flags in combination and generally pointing me in the right direction when finding resources
  • xyzz's Amonet - This is the exploit I have adapted for this device, including the bootrom exploit
  • chaosmaster - Wrote lots of useful amonet code from which I used several snippets, including for fixing my GPT

Contact me

About

A python command line tool for rooting your amazon echo 2nd generation

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 79.3%
  • Python 18.9%
  • Shell 1.1%
  • Other 0.7%