Linux & macOS Guide

#!/bin/bash

# 1. Detect Environment (NOT Termux)
if [[ "$OSTYPE" == "linux-gnu"* ]]; then
    # Linux detected
elif [[ "$OSTYPE" == "darwin"* ]]; then
    # macOS detected
fi

# 2. Check Python 3 Installation
if ! command -v python3 &> /dev/null; then
    # Attempt auto-install on Linux
    sudo apt-get update && sudo apt-get install -y python3 python3-venv python3-pip
fi

# 3. Create Virtual Environment
if [ ! -d "venv" ]; then
    python3 -m venv venv
fi

# 4. Activate Virtual Environment
source venv/bin/activate

# 5. Install Dependencies
pip install -r requirements.txt

# 6. Launch Application
python main.py

# Check file ownership
ls -la start.sh

# Take ownership if needed (Linux)
sudo chown $USER:$USER start.sh
chmod +x start.sh

# Or run with bash directly
bash start.sh

# Remove quarantine attribute
xattr -d com.apple.quarantine start.sh

# Or run with bash
bash start.sh

# Check if ADB is accessible
which adb
adb version

# Start ADB server
adb start-server

# List connected devices
adb devices

List of devices attached
ABC123XYZ    device

# Connect device and run:
lsusb

# Example output:
# Bus 001 Device 010: ID 18d1:4ee7 Google Inc. Nexus/Pixel Device
#                        ^^^^ This is the vendor ID

# Add to udev rules:
SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"

# Remove quarantine from ADB directory
xattr -dr com.apple.quarantine adb/

# Or approve in System Preferences
# Security & Privacy → General → "Allow Anyway"

# Ubuntu/Debian
sudo apt-get install -y python3-venv

# Fedora
sudo dnf install -y python3-virtualenv

# Then retry start.sh
./start.sh

# Check current permissions
adb devices

# If showing "no permissions"
# 1. Fix udev rules (see USB Permissions section)
# 2. Ensure user in plugdev group:
sudo usermod -aG plugdev $USER

# 3. Log out and back in
# 4. Restart ADB
adb kill-server
adb start-server
adb devices

# Remove corrupted venv
rm -rf venv

# Recreate
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python main.py

# Install pip for system Python first
# Ubuntu/Debian:
sudo apt-get install -y python3-pip

# macOS:
brew install python3  # includes pip

# Then recreate venv:
rm -rf venv
python3 -m venv venv
source venv/bin/activate

# For Homebrew Python:
brew reinstall python3

# For Python.org installer:
cd "/Applications/Python 3.x/"
sudo "./Install Certificates.command"

# Create and activate venv manually
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run application
python main.py

# Deactivate venv when done
deactivate

# Install dependencies globally
pip3 install --user -r requirements.txt

# Run with system Python
python3 main.py