A lightweight, TUI-based Bash tool designed to manage multiple isolated profiles (instances) in Waydroid seamlessly.
- Multi-Profile Management: Create, switch, and clone isolated Android environments.
- Bazzite & Immutable OS Ready: Stores profiles securely in
~/.local/share/waydroid-manager/instances/to survive OS-level resets. - Dual Language Support: Full English and Turkish dynamic interface.
- Export & Import: Easily backup profiles to
.tar.gzarchives and restore them on any machine. - Multi-Select Delete: Delete multiple unused profiles at once with safety confirmation.
- Disk Size Display: View the exact disk space consumed by each profile directly in the menu.
- Automated Safeguard: Automatically detects and isolates raw Waydroid data created in the background without data corruption.
- Event Logging: Records all actions with timestamps in
manager.logfor troubleshooting.
- Linux (Ubuntu, Arch, Fedora, Bazzite, SteamOS, etc.)
- Waydroid installed and initialized (
waydroid init)
Download the script and add it to your local bin directory so you can run waydroid-manager from anywhere in your terminal.
# Ensure the local bin directory exists
mkdir -p ~/.local/bin
# Download the script
wget https://raw.githubusercontent.com/yavasdev/waydroid-manager/main/waydroid-manager.sh -O waydroid-manager
# Make the script executable
chmod +x waydroid-manager
# Move it to your local bin directory
mv waydroid-manager ~/.local/bin/After installation, simply type waydroid-manager in your terminal from any location.
# Clone this repository
cd ~/Downloads
git clone https://github.com/yavasdev/waydroid-manager.git
cd waydroid-manager
# Make the script executable
chmod +x waydroid-manager.sh
# Run the script
./waydroid-manager.sh
⚠️ Important Note:
- Do NOT run the script with
sudo(e.g.,sudo waydroid-manager). Running the entire script as root will break the Waydroid GUI.- The script internally manages
sudoprivileges safely for background container operations when needed.
This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.