docs: update README

chore: update correct ext for installation
ci: update ignore path

Author: dungngminh

.github/workflows/ci.yaml

@@ -3,8 +3,16 @@ name: Continuous Integration
 on:
   push:
     branches: [main]
+    paths-ignore:
+      - "**.md"
+      - "art/**"
+      - "install.sh"
   pull_request:
     branches: [main]
+    paths-ignore:
+      - "**.md"
+      - "art/**"
+      - "install.sh"
 
 jobs:
   analyze:

README.md

@@ -1 +1,84 @@
-# Simutil - TUI application for launching Android Simulators / iOS Simulators and more ...
+<h1 align="center">Simutil</h1>
+
+<p align="center">
+  <strong>A terminal UI for managing Android Emulators / iOS Simulators and more</strong><br>
+  <strong>Launch, connect, and manage your devices — all from the terminal</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/dungngminh/simutil/actions/workflows/ci.yaml"><img src="https://github.com/dungngminh/simutil/actions/workflows/ci.yaml/badge.svg" alt="Build" /></a>
+  <a href="https://github.com/dungngminh/simutil/releases/latest"><img src="https://img.shields.io/github/v/release/dungngminh/simutil" alt="GitHub release" /></a>
+</p>
+
+Browse your available emulators and simulators side-by-side, launch with custom options, and connect to physical devices wirelessly.
+
+Simutil is written with [Nocterm](https://nocterm.dev/), a terminal UI framework for Dart with similar syntax to Flutter.
+
+// TODO: Add screenshot of Simutil
+
+### Features
+
+- **One-Key Launch** — Start any device with `Enter`, no need to open Android Studio or Xcode
+- **Android Launch Options** — Provide launch option for Android Emulators: Normal, Cold Boot, No Audio, or Cold Boot + No Audio,...
+- **ADB Tools Built-in** — Connect to physical Android devices wirelessly:
+  - Connect via IP address
+  - Pair with 6-digit code (Android 11+)
+  - QR code pairing (Android 11+)
+
+### Installation
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/dungngminh/simutil/main/install.sh | bash
+```
+
+**Using Homebrew (macOS/Linux):**
+
+```bash
+brew tap dungngminh/simutil
+brew install simutil
+```
+
+**From pub.dev:**
+
+```bash
+dart pub global activate simutil
+```
+
+**From source:**
+
+```bash
+git clone https://github.com/dungngminh/simutil.git
+cd simutil
+dart pub get
+dart pub global activate --source path .
+```
+
+Then run:
+
+```bash
+simutil
+```
+
+### Supported platforms
+
+- [x] macOS
+- [x] Linux
+- [ ] Windows
+
+
+### Contributing
+
+```bash
+git clone https://github.com/dungngminh/simutil.git
+cd simutil
+dart pub get
+dart run bin/simutil.dart   # Run locally
+```
+
+1. Fork this repository
+2. Create a branch and make your changes
+3. Open a Pull Request
+
+### License
+
+MIT — see [LICENSE](LICENSE)

install.sh

@@ -14,10 +14,10 @@ CYAN='\033[0;36m'
 BOLD='\033[1m'
 RESET='\033[0m'
 
-info()    { echo -e "${CYAN}[info]${RESET}  $*"; }
-success() { echo -e "${GREEN}[✔]${RESET}    $*"; }
-warn()    { echo -e "${YELLOW}[warn]${RESET}  $*"; }
-error()   { echo -e "${RED}[✘]${RESET}    $*"; exit 1; }
+info()    { echo -e "${CYAN}[info]${RESET}  $*" >&2; }
+success() { echo -e "${GREEN}[✔]${RESET}    $*" >&2; }
+warn()    { echo -e "${YELLOW}[warn]${RESET}  $*" >&2; }
+error()   { echo -e "${RED}[✘]${RESET}    $*" >&2; exit 1; }
 
 detect_os() {
   local os
@@ -46,8 +46,8 @@ resolve_version() {
   if [ "$version" = "latest" ]; then
     info "Resolving latest release..."
     version=$(curl -fsSL "https://api.github.com/repos/$REPO/releases/latest" \
-      | grep '"tag_name"' \
-      | sed -E 's/.*"tag_name":\s*"([^"]+)".*/\1/')
+      | grep -m 1 '"tag_name":' \
+      | cut -d '"' -f 4)
 
     if [ -z "$version" ]; then
       error "Could not determine the latest release. Check https://github.com/$REPO/releases"
@@ -62,9 +62,9 @@ install() {
   local arch="$2"
   local version="$3"
 
-  local ext=""
+  local ext=".tar.gz"
   if [ "$os" = "windows" ]; then
-    ext=".exe"
+    ext=".zip"
   fi
 
   local asset_name="${BINARY_NAME}-${os}-${arch}${ext}"
@@ -74,20 +74,53 @@ install() {
   info "Version:  ${BOLD}${version}${RESET}"
   info "Downloading ${BOLD}${asset_name}${RESET}..."
 
+  local tmp_dir
+  tmp_dir="$(mktemp -d)"
+  local tmp_file="${tmp_dir}/${asset_name}"
+
   # Create install directory
   mkdir -p "$INSTALL_DIR"
 
-  local target_path="${INSTALL_DIR}/${BINARY_NAME}${ext}"
-
   # Download
   local http_code
-  http_code=$(curl -fsSL -w "%{http_code}" -o "$target_path" "$download_url" 2>&1) || true
+  http_code=$(curl -fsSL -w "%{http_code}" -o "$tmp_file" "$download_url" 2>&1) || true
 
-  if [ ! -f "$target_path" ] || [ ! -s "$target_path" ]; then
-    rm -f "$target_path"
+  if [ ! -f "$tmp_file" ] || [ ! -s "$tmp_file" ]; then
+    rm -rf "$tmp_dir"
     error "Download failed. URL: $download_url\n       Make sure release $version exists with asset $asset_name."
   fi
 
+  info "Extracting..."
+  if [ "$os" = "windows" ]; then
+    unzip -q -o "$tmp_file" -d "$INSTALL_DIR" || {
+      rm -rf "$tmp_dir"
+      error "Failed to extract $tmp_file"
+    }
+  else
+    tar -xzf "$tmp_file" -C "$INSTALL_DIR" || {
+      rm -rf "$tmp_dir"
+      error "Failed to extract $tmp_file"
+    }
+  fi
+
+  rm -rf "$tmp_dir"
+
+  local extracted_file="${INSTALL_DIR}/${BINARY_NAME}-${os}-${arch}"
+  local target_path="${INSTALL_DIR}/${BINARY_NAME}"
+
+  if [ "$os" = "windows" ]; then
+    target_path="${target_path}.exe"
+    if [ -f "${extracted_file}.exe" ]; then
+      extracted_file="${extracted_file}.exe"
+    fi
+  fi
+
+  if [ -f "$extracted_file" ]; then
+    mv "$extracted_file" "$target_path"
+  else
+    error "Could not find expected binary '$extracted_file' after extraction."
+  fi
+
   # Make executable (skip on Windows)
   if [ "$os" != "windows" ]; then
     chmod +x "$target_path"