avd_manager 1.0.4

package/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+github: Tdebo21
+buy_me_a_coffee: guimbobabag
+custom: ['https://www.buymeacoffee.com/guimbobabag']

package/.github/workflows/build-release.yml

@@ -0,0 +1,103 @@
+name: Build and Create Release
+
+on:
+  push:
+    tags:
+      - "v*" # Trigger on version tags (v1.0.0, v1.1.0, etc.)
+
+jobs:
+  build:
+    name: Build ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        include:
+          - os: ubuntu-latest
+            output-name: avdm-linux
+            asset-name: avdm-linux
+          - os: windows-latest
+            output-name: avdm-windows.exe
+            asset-name: avdm-windows.exe
+          - os: macos-latest
+            output-name: avdm-macos
+            asset-name: avdm-macos
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Dart SDK
+        uses: dart-lang/setup-dart@v1
+        with:
+          sdk: stable
+
+      - name: Get dependencies
+        run: dart pub get
+
+      - name: Build executable
+        run: dart compile exe bin/avdm.dart -o ${{ matrix.output-name }}
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: ${{ matrix.os }}-build
+          path: ${{ matrix.output-name }}
+
+  release:
+    name: Create GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v3
+        with:
+          path: artifacts
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            artifacts/ubuntu-latest-build/avdm-linux
+            artifacts/windows-latest-build/avdm-windows.exe
+            artifacts/macos-latest-build/avdm-macos
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install Dependencies
+        run: npm install
+
+      - name: Generate Changelog & Bump Version
+        if ${{ github.event.inputs.dry_run != 'true' }}
+        id: version
+
+        run: |
+        npx standard-version --release-as ${{ github.event.inputs.bump }}
+        VERSION=$(node -p "require('./package.json').version")
+        echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+
+  update-homebrew:
+    name: Update Homebrew Formula
+    needs: release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Trigger Homebrew update
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            // This creates an issue reminder to update the Homebrew formula with the new version and SHA256
+            const { data: issue } = await github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: `Update Homebrew formula for version ${process.env.GITHUB_REF.replace("refs/tags/v", "")}`,
+              body: `A new release has been created for version ${process.env.GITHUB_REF.replace("refs/tags/v", "")}. Please update the Homebrew formula with the new version and the correct SHA256 checksum for the new release.`
+            });
+            console.log("Remember to update the Homebrew formula with new SHA256");

package/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: Dart CLI CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    name: Run format, analyze, and test
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up Dart
+        uses: dart-lang/setup-dart@v1
+
+      - name: Install dependencies
+        run: dart pub get
+
+      - name: Check formatting
+        run: dart format . --set-exit-if-changed
+
+      - name: Analyze project source
+        run: dart analyze
+
+      # Optional: Add tests if you have any
+      - name: Run tests
+        run: dart test

package/.versionrc.json

@@ -0,0 +1,15 @@
+{
+  "types": [
+    { "type": "feat", "section": "Features", "hidden": false },
+    { "type": "fix", "section": "Bug Fixes", "hidden": false },
+    { "type": "docs", "section": "Documentation", "hidden": false },
+    { "type": "perf", "section": "Performance", "hidden": false },
+    { "type": "refactor", "section": "Refactoring", "hidden": false },
+    { "type": "style", "section": "Styles", "hidden": false },
+    { "type": "test", "section": "Tests", "hidden": false },
+    { "type": "chore", "section": "Chores", "hidden": true }
+  ],
+  "commitUrlFormat": "https://github.com/Tdebo21/avd_manager/commit/{{hash}}",
+  "compareUrlFormat": "https://github.com/Tdebo21/avd_manager/compare/{{previousTag}}...{{currentTag}}",
+  "releaseCommitMessageFormat": "chore(release): {{currentTag}}"
+}

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [1.0.4](https://github.com/Tdebo21/avd_manager/compare/v1.0.3...v1.0.4) (2026-05-13)
+
+## 1.0.0
+
+- Initial version.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rabi Iya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,270 @@
+[![npm version](https://img.shields.io/npm/v/avd-manager-cli.svg)](https://www.npmjs.com/package/avd-manager-cli)
+[![downloads](https://img.shields.io/npm/dm/avd-manager-cli.svg)](https://www.npmjs.com/package/avd-manager-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Last Updated](https://img.shields.io/github/last-commit/Tdebo21/avd_manager.svg)](https://github.com/Tdebo21/avd_manager/commits)
+[![CI](https://github.com/Tdebo21/avd_manager/actions/workflows/ci.yml/badge.svg)](https://github.com/Tdebo21/avd_manager/actions)
+[![pub package](https://img.shields.io/pub/v/avd_manager.svg)](https://pub.dev/packages/avd_manager)
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-%E2%98%95-yellow)](https://buymeacoffee.com/guimbobabag)
+[![Sponsor](https://img.shields.io/badge/sponsor-GitHub-blue)](https://github.com/sponsors/Tdebo21)
+
+# 📱 avdm - AVD Manager CLI Tool
+
+**avdm** is a simple and efficient command-line tool that helps you manage Android Virtual Devices (AVDs) right from your terminal.
+
+Built for developers who want a faster, scriptable, and more minimal alternative to Android Studio’s GUI-based AVD Manager.
+
+---
+
+## 🚀 Features
+
+- ✨ Create and manage Android Virtual Devices with ease
+- 🔍 List all available AVDs and their configurations
+- 🔧 Launch AVDs with custom options
+- 📋 Delete and clean up unused or outdated AVDs
+- 📦 Show disk usage per AVD
+- 📊 Sort AVDs by name or size
+- 📏 Filter AVDs by minimum size (e.g. `--min-size 2GB`)
+- ⚡ Lightweight & fast (written in Dart)
+- No GUI required
+
+---
+
+## 📦 Installation
+
+**Option 1: Via Pub.dev (requires Dart SDK)**
+
+### Prerequisites
+
+> Ensure you have the Dart SDK installed. If not, install it from https://dart.dev/get-dart
+
+- **Dart SDK** 3.0 or higher ([Install Dart](https://dart.dev/get-dart))
+- **Android SDK** with emulator tools ([Install Android Studio](https://developer.android.com/studio))
+- **Java JDK** 11 or higher
+
+```bash
+dart pub global activate avd_manager
+avdm --help
+```
+
+### 1. Clone the repo
+
+```bash
+git clone https://github.com/Tdebo21/avd_manager.git
+cd avd_manager
+```
+
+### 2. Activate the CLI
+
+```bash
+dart pub global activate --source path .
+```
+
+> This makes avdm available globally as a command.
+>
+> If you previously installed `avdm`, refresh the global install with:
+
+```bash
+dart pub global deactivate avdm
+dart pub global activate --source path .
+```
+
+---
+
+**Option 2: Download Binary (no Dart Required)**
+
+> Optionally, you can install **AVD Manager CLI Tool** by downloading the binary from the releases page.
+
+**Option 3: Using npm**
+You can install AVD Manager CLI globally using npm:
+
+```bash
+npm install -g avd-manager-cli
+```
+
+**Option 4: Using Homebrew**
+
+```bash
+# Example installation using Homebrew (macOS)
+
+brew tap Tdebo21/avd_manager
+brew install avd_manager
+```
+
+## 🛠 Usage
+
+```bash
+avdm <command> [options]
+```
+
+### 📋 Available Commands
+
+| Command  | Description                             |
+| -------- | --------------------------------------- |
+| `list`   | List all AVDs with optional sort/filter |
+| `create` | Create a new AVD from a system image    |
+| `patch`  | Patch an existing AVD (config changes)  |
+| `launch` | Launch a specific AVD                   |
+| `delete` | Delete a specific AVD                   |
+| `help`   | Show help                               |
+
+### 🔧 Options for `list`
+
+| Flag         | Description                           | Example          |
+| ------------ | ------------------------------------- | ---------------- |
+| `--sort`     | Sort AVDs by `name` or `size`         | `--sort size`    |
+| `--min-size` | Only show AVDs larger than given size | `--min-size 1GB` |
+
+# Usage Examples
+
+# List all AVDs
+
+```bash
+avdm list
+```
+
+> Note: `avdm list` reports the size of each AVD's local `.avd` directory. Newly created AVDs often
+> start very small (around 1MB) and grow after the emulator is launched and the AVD image files are
+> created.
+
+# Sort AVDs by size
+
+```bash
+avdm list --sort size
+```
+
+# Filter AVDs larger than 2GB
+
+```bash
+avdm list --min-size 2GB
+```
+
+# Sort AVDs by name and filter by minimum size
+
+```bash
+avdm list --sort name --min-size 1GB
+```
+
+# Create a new AVD
+
+```bash
+avdm create <avd_name> --device "Pixel 2" --api 30
+```
+
+# Examples:
+
+```bash
+avdm create Slim_API30 --api=30
+avdm create TestDevice --device="Nexus 4" --api=29
+avdm create miniTestPhone --device "pixel" --api 30 --abi arm64-v8a
+```
+
+> On Apple Silicon, the tool now defaults `--abi` to `arm64-v8a` when not provided. Use `--abi x86` or `--abi x86_64` only if you have Intel system images installed.
+
+# Launch AVD with prompt-based selection:
+
+```bash
+avdm launch
+```
+
+# Launch specific AVD with defaults:
+
+```bash
+avdm launch TestDevice
+```
+
+# Launch with performance flags:
+
+```bash
+avdm launch TestDevice --cold-boot --no-boot-anim --no-snapshot-load
+avdm launch TestDevice --no-snapshot-save
+```
+
+> Use "avdm <command> --help" for more information about a command.
+
+# Delete an AVD
+
+```bash
+avdm delete Slim_API30
+```
+
+---
+
+# 🧩 How It Works
+
+avdm looks for AVDs in your $ANDROID_AVD_HOME environment variable.
+
+If not set, it defaults to ~/.android/avd/.
+
+It reads each AVD’s directory and calculates its total disk usage.
+
+Outputs the AVD name and its formatted size (e.g. 1.94 GB).
+
+---
+
+## Troubleshooting
+
+### AVD Not Found
+
+Ensure your `ANDROID_SDK_ROOT` environment variable is set:
+
+```bash
+# macOS/Linux
+export ANDROID_SDK_ROOT=~/Library/Android/sdk  # macOS
+export ANDROID_SDK_ROOT=~/Android/sdk  # Linux
+
+# Windows (PowerShell)
+$env:ANDROID_SDK_ROOT="C:\Users\YourName\AppData\Local\Android\sdk"
+```
+
+### Permission Denied (Linux/macOS)
+
+Ensure the tool has execute permissions:
+
+```bash
+chmod +x ~/.pub-cache/bin/avdm
+```
+
+### Emulator Won't Launch
+
+- Check that your system supports virtualization (KVM on Linux, Hypervisor Framework on macOS)
+- Increase available RAM
+- Disable VT-x/AMD-V in BIOS if conflicts exist
+
+---
+
+# 🤝 Contributing
+
+Contributions, suggestions, and bug reports are welcome!
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/your-feature`
+3. Commit your changes: `git commit -am 'Add awesome feature'`
+4. Push to the branch: `git push origin feature/your-feature`
+5. Open a Pull Request
+
+---
+
+# 📝 License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.
+
+---
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history and release notes.
+
+---
+
+# ❤️ Support & Sponsorship
+
+If you found this project useful, consider sponsoring it to support further development!
+
+💖 Sponsor on GitHub: [![Sponsor](https://img.shields.io/badge/sponsor-GitHub-blue)](https://github.com/sponsors/Tdebo21)
+
+Or buy me a coffee: [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-%E2%98%95-yellow)](https://buymeacoffee.com/guimbobabag)
+
+# ✨ Author
+
+Rabi Iya
+GitHub @Tdebo21

package/analysis_options.yaml

@@ -0,0 +1,30 @@
+# This file configures the static analysis results for your project (errors,
+# warnings, and lints).
+#
+# This enables the 'recommended' set of lints from `package:lints`.
+# This set helps identify many issues that may lead to problems when running
+# or consuming Dart code, and enforces writing Dart using a single, idiomatic
+# style and format.
+#
+# If you want a smaller set of lints you can change this to specify
+# 'package:lints/core.yaml'. These are just the most critical lints
+# (the recommended set includes the core lints).
+# The core lints are also what is used by pub.dev for scoring packages.
+
+include: package:lints/recommended.yaml
+
+# Uncomment the following section to specify additional rules.
+
+# linter:
+#   rules:
+#     - camel_case_types
+
+# analyzer:
+#   exclude:
+#     - path/to/excluded/files/**
+
+# For more information about the core and recommended set of lints, see
+# https://dart.dev/go/core-lints
+
+# For additional information about configuring this file, see
+# https://dart.dev/guides/language/analysis-options

package/bin/avdm.dart

@@ -0,0 +1,176 @@
+import 'dart:io';
+import 'package:args/args.dart';
+import 'package:avd_manager/commands/create.dart';
+import 'package:avd_manager/commands/delete.dart';
+import 'package:avd_manager/commands/launch.dart' as launch_cmd;
+import 'package:avd_manager/commands/list.dart';
+import 'package:avd_manager/src/version.dart';
+
+void main(List<String> args) async {
+  final createParser = ArgParser()
+    ..addFlag('help', abbr: 'h', negatable: false, help: 'Show create usage')
+    ..addOption('device', help: 'Device name (e.g. "pixel")')
+    ..addOption('api', help: 'API level (e.g. 28)')
+    ..addOption('name', help: 'AVD name')
+    ..addOption('abi',
+        help: 'ABI for the system image (e.g. x86, x86_64, arm64-v8a)');
+
+  final launchParser = ArgParser()
+    ..addFlag('help', abbr: 'h', negatable: false, help: 'Show launch usage')
+    ..addFlag('wipe-data', negatable: false, help: 'Wipe user data')
+    ..addFlag('cold-boot', negatable: false, help: 'Cold boot the AVD')
+    ..addFlag('no-snapshot-load',
+        negatable: false, help: 'Do not load from snapshot')
+    ..addFlag('no-snapshot-save',
+        negatable: false, help: 'Do not save to snapshot on exit')
+    ..addFlag('no-boot-anim', negatable: false, help: 'Disable boot animation');
+
+  final deleteParser = ArgParser()
+    ..addFlag('help', abbr: 'h', negatable: false, help: 'Show delete usage');
+
+  final listParser = ArgParser()
+    ..addFlag('help', abbr: 'h', negatable: false, help: 'Show list usage')
+    ..addOption('sort',
+        allowed: ['size', 'name'], help: 'Sort AVDs by "size" or "name"')
+    ..addOption('min-size',
+        help: 'Only show AVDs larger than this size (e.g. 500MB, 1GB)');
+
+  // ADD VERSION FLAG TO MAIN PARSER
+  final parser = ArgParser()
+    ..addFlag('help', abbr: 'h', negatable: false, help: 'Show usage')
+    ..addFlag('version', negatable: false, help: 'Show version information')
+    ..addCommand('create', createParser)
+    ..addCommand('launch', launchParser)
+    ..addCommand('delete', deleteParser)
+    ..addCommand('list', listParser);
+
+  late ArgResults results;
+  try {
+    results = parser.parse(args);
+  } catch (e) {
+    print('❌ Error: ${e.toString()}');
+    _printUsage(parser);
+    exit(64);
+  }
+
+  // Handle --version flag FIRST (before checking other flags)
+  if (results['version'] as bool) {
+    final version = getVersion();
+    print('avd_manager version $version');
+    return;
+  }
+
+  if (results['help'] as bool) {
+    _printUsage(parser);
+    return;
+  }
+
+  final command = results.command;
+  if (command == null) {
+    print('No command provided. Use --help for usage information.');
+    return;
+  }
+  // Handle commands
+  switch (results.command!.name) {
+    case 'launch':
+      final cmd = results.command!;
+      if (cmd['help'] as bool) {
+        print('Usage: avdm launch <avd_name> [options]\n${launchParser.usage}');
+        return;
+      }
+      final name = cmd.rest.isNotEmpty ? cmd.rest[0] : null;
+      final extraArgs = <String>[];
+      List<String> emulatorArgs = [];
+
+      if (cmd.wasParsed('wipe-data')) {
+        emulatorArgs.add('-wipe-data');
+      }
+
+      if (cmd['cold-boot']) extraArgs.add('-no-snapshot-load');
+      if (cmd['no-snapshot-load']) extraArgs.add('-no-snapshot-load');
+      if (cmd['no-snapshot-save']) extraArgs.add('-no-snapshot-save');
+      if (cmd['no-boot-anim']) extraArgs.add('-no-boot-anim');
+
+      await launch_cmd.launchAvd(name, extraArgs: extraArgs);
+      break;
+    case 'create':
+      final cmd = results.command!;
+      if (cmd['help'] as bool) {
+        print('Usage: avdm create <name> [options]\n${createParser.usage}');
+        return;
+      }
+      final name = cmd.rest.isNotEmpty ? cmd.rest[0] : null;
+      final device = cmd['device'] as String?;
+      final api = cmd['api'] as String?;
+      final abi = cmd['abi'] as String?;
+      if (name == null || api == null) {
+        print(
+            '❌ AVD name and --api are required.\nUsage: avdm create <name> --device "Nexus 9" --api 30');
+        return;
+      }
+      await createAvd(name, device: device, apiLevel: api, abi: abi);
+      break;
+    case 'delete':
+      final cmd = results.command!;
+      if (cmd['help'] as bool) {
+        print('Usage: avdm delete <avd_name>');
+        return;
+      }
+      final name = cmd.rest.isNotEmpty ? cmd.rest[0] : null;
+      if (name == null) {
+        print('❌ Please specify the AVD name to delete.');
+        print('Usage: avdm delete <avd_name>');
+        return;
+      }
+      // confirm deletion
+      stdout.write('Are you sure you want to delete AVD "$name"? (y/N) ');
+      final confirm = stdin.readLineSync();
+      if (confirm == null || confirm.toLowerCase() != 'y') {
+        print('Deletion cancelled.');
+        return;
+      }
+      await deleteAvd(name);
+      break;
+    case 'list':
+      final cmd = results.command!;
+      if (cmd['help'] as bool) {
+        print('Usage: avdm list [options]\n${listParser.usage}');
+        return;
+      }
+      final sortBy = cmd['sort'] ?? 'name';
+      final minSizeStr = cmd['min-size'] ?? '0';
+
+      await listAvds({
+        'sort': sortBy,
+        'min-size': minSizeStr,
+      });
+      break;
+    default:
+      print('❓ Unknown command: ${results.command!.name}');
+      print('\n${usage(parser)}');
+  }
+}
+
+void _printUsage(ArgParser parser) {
+  print('''AVDM - Lightweight Android AVD Manager CLI
+${usage(parser)}
+Commands:
+  avdm create <avd_name> [--device="Pixel 2"] [--api=30]    Create and patch an AVD
+  avdm list                                                 List all AVDs
+  avdm delete <avd_name>                                    Delete an AVD
+  avdm launch <avd_name> [options]                          Launch an AVD with optional flags
+
+Examples:
+  avdm create Slim_API30 --api=30
+  avdm create TestDevice --device="Nexus 4" --api=29
+  avdm delete Slim_API30
+  avdm launch TestDevice --wipe-data --no-boot-anim
+
+
+Use "avdm <command> --help" for command-specific usage.
+''');
+}
+
+// Function to generate usage string
+String usage(ArgParser parser) =>
+    'Usage: avdm <command> [options]\n\n${parser.usage}';

package/docs/404.html

@@ -0,0 +1,28 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="UTF-8" />
+    <title>404 - Command Not Found!</title>
+    <link rel="stylesheet" href="./theme.css" />
+    <link rel="icon" href="./assets/404.png" type="image/png" />
+  </head>
+  <body style="text-align: center; padding: 50px">
+    <img src="./assets/404.png" alt="AVD Manager CLI Logo" width="120" />
+    <h1 style="color: var(--accent); font-size: 48px">
+      404 — Command Not Found!
+    </h1>
+    <p>The page you're looking for doesn't exist or has been moved.</p>
+    <p>Check the URL and try again, or return to the homepage.</p>
+    <a
+      href="https://Tdebo21.github.io/avd_manager"
+      id="go-home"
+      style="
+        background: var(--accent);
+        color: #000;
+        padding: 10px 20px;
+        border-radius: 6px;
+      "
+      >Go Home</a
+    >
+  </body>
+</html>