Features
- Mirrors your screen wirelessly with scrcpy
- New! Support for non-rooted devices
- Automatically adds Wi-Fi adb connection capability at boot [root only]
- Connects through adb via Wi-Fi
- Remembers last known working Wi-Fi IP for fast connection
- Drops you to a wireless shell on the device
- Works in Linux and in Windows via cygwin or WSL (Windows Subsystem for Linux)
- Tackles all scenarios that could get you into issues. It even finds a way when Wi-Fi is turned off!
Requirements
- scrpy must be installed or set to system PATH (clone from: https://github.com/Genymobile/scrcpy)
- To permanently set Android props to allow Wi-Fi adb connections at all times, it is required to have the device rooted (you can use magisk).
- You might need an USB cable for resolving potential connectivity issues in USB debugging mode. If the tool asks for it, just plug it between your device and your PC
How To Run
- Prerequisites:
dos2unix ethernally.sh #might be needed to convert line endings to unix format
chmod +x ethernally.sh #make the script executable
- Simply run the script from its folder (
cd ethernally) and follow the intuitive wizzard guide:
./ethernally.sh
- You could also add it to system path (linux) or to the environment variables (cygwin), and call it from anywhere (eg.
ethernally) - Alternatively, you could create a symlink in your preferred location (eg. on your Linux Desktop)
- You could even add a shortcut on Windows (cygwin) to launch screen mirroring upon execution. To do that, set shortcut's target similar to this:
C:\cygwin\bin\mintty.exe /usr/bin/bash --login "/cygdrive/c/GitHub/ethernally/ethernally.sh"
How To Update
- To update the script, simply pull latest changes from the git repository:
git pull
- Alternatively you could just copy/paste the code into your script or download it again (eg. with
wget)