{"id":31706667,"url":"https://github.com/pavi2410/droidkit","last_synced_at":"2025-10-08T23:17:46.601Z","repository":{"id":310120858,"uuid":"1038770340","full_name":"pavi2410/droidkit","owner":"pavi2410","description":"DroidKit is a comprehensive macOS desktop application for Android developers that provides essential ADB (Android Debug Bridge) tools through an intuitive graphical interface.","archived":false,"fork":false,"pushed_at":"2025-08-27T21:13:31.000Z","size":12854,"stargazers_count":12,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-16T01:48:17.351Z","etag":null,"topics":["adb","android","android-studio","debug","developer-tools","emulator","logcat","toolkit"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pavi2410.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-15T19:34:56.000Z","updated_at":"2025-09-12T14:29:44.000Z","dependencies_parsed_at":"2025-08-15T22:54:00.282Z","dependency_job_id":null,"html_url":"https://github.com/pavi2410/droidkit","commit_stats":null,"previous_names":["pavi2410/droidkit"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pavi2410/droidkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pavi2410%2Fdroidkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pavi2410%2Fdroidkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pavi2410%2Fdroidkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pavi2410%2Fdroidkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pavi2410","download_url":"https://codeload.github.com/pavi2410/droidkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pavi2410%2Fdroidkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000723,"owners_count":26082862,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adb","android","android-studio","debug","developer-tools","emulator","logcat","toolkit"],"created_at":"2025-10-08T23:17:33.888Z","updated_at":"2025-10-08T23:17:46.593Z","avatar_url":"https://github.com/pavi2410.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DroidKit 🧑‍💻🩺📱\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"public/droidkit-icon-128.png\" alt=\"DroidKit\" width=\"128\" height=\"128\" /\u003e\n  \u003ch3\u003eAndroid Toolkit for macOS\u003c/h3\u003e\n  \u003cp\u003e\u003cstrong\u003eDroidKit\u003c/strong\u003e is a comprehensive macOS desktop application for Android developers that provides essential ADB (Android Debug Bridge) tools through an intuitive graphical interface.\u003c/p\u003e\n\u003c/div\u003e\n\n## ✨ Features\n\n### 📟 Device Management\n- **Auto-discovery** of connected Android devices and emulators\n- **Real-time status monitoring** with connection indicators\n- **Multiple device support** with easy switching\n- **Device information display** (model, Android version, API level, serial)\n\n### 🚀 AVD (Android Virtual Device) Management\n- **List available AVDs** from your Android SDK\n- **Launch emulators** directly from the app\n- **Quick access** AVD controls in sidebar\n- **Automatic device detection** after AVD launch\n\n### ⚙️ Configuration \u0026 Settings\n- **Automatic ANDROID_HOME detection** from environment variables\n- **Common SDK path discovery** (macOS standard locations)\n- **SDK path configuration** with validation\n- **Persistent settings** storage\n\n### 📁 File Explorer\n- **Browse device filesystem** with intuitive navigation\n- **File and folder management** with permissions display\n- **Download files** from device to local machine\n- **Path navigation** with breadcrumbs and history\n- **File size and permission details**\n\n### 📋 App Management\n- **List all installed applications** (system and user)\n- **Search and filter** applications by name\n- **Distinguish system vs user apps** with badges\n- **Package name and app info display**\n- **Future: Install/uninstall APKs**\n\n### 📊 Logcat Viewer\n- **Real-time log monitoring** with configurable line count\n- **Log level filtering** with color-coded output\n- **Search and filter** logs by keywords\n- **Export logs** to text files\n- **Terminal-style display** with syntax highlighting\n\n## 🛠️ Tech Stack\n\n- **Frontend**: React 19 + TypeScript + Tailwind CSS\n- **UI Components**: Shadcn UI component library\n- **Backend**: Tauri 2.0 + Rust\n- **ADB Integration**: `adb_client` Rust crate\n- **Build Tool**: Bun for fast package management\n- **Platform**: macOS (with potential for cross-platform expansion)\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n1. **Node.js \u0026 Bun**: Install Bun for package management\n   ```bash\n   curl -fsSL https://bun.sh/install | bash\n   ```\n\n2. **Rust**: Required for Tauri backend\n   ```bash\n   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n   ```\n\n3. **Android SDK**: Install Android Studio or standalone SDK\n   - Set `ANDROID_HOME` environment variable\n   - Ensure `adb` is in your PATH\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd droidkit\n   ```\n\n2. **Install dependencies**\n   ```bash\n   bun install\n   ```\n\n3. **Run in development mode**\n   ```bash\n   bun run tauri dev\n   ```\n\n4. **Build for production**\n   ```bash\n   bun run tauri build\n   ```\n\n## 📖 Usage\n\n### Connecting Devices\n\n1. **USB Devices**: Enable USB debugging on your Android device and connect via USB\n2. **Emulators**: Launch AVDs directly from DroidKit or use Android Studio\n3. **Network Devices**: Future feature for wireless ADB connections\n\n### File Management\n\n- Navigate using folder icons or path breadcrumbs\n- Click files to view details, folders to navigate\n- Use the download button to save files to your Desktop\n- Use back/home buttons for quick navigation\n\n### Log Monitoring\n\n- Adjust line count for log buffer size\n- Use search to filter logs by keywords\n- Export logs for debugging or sharing\n- Color-coded log levels (Verbose, Debug, Info, Warning, Error, Fatal)\n\n### App Management\n\n- Search installed apps by name or package\n- View system vs user applications\n- Future: Install APKs, view app details, manage permissions\n\n## 🏗️ Project Structure\n\n```\ndroidkit/\n├── src/                          # React frontend\n│   ├── components/               # UI components\n│   │   ├── ui/                   # Shadcn UI base components\n│   │   ├── Header.tsx            # App header with branding\n│   │   ├── Sidebar.tsx           # Device list and AVD controls\n│   │   ├── MainContent.tsx       # Tabbed main interface\n│   │   ├── FileExplorer.tsx      # File browser component\n│   │   ├── AppManager.tsx        # App management interface\n│   │   ├── LogcatViewer.tsx      # Log monitoring component\n│   │   └── SettingsDialog.tsx    # Configuration modal\n│   ├── lib/                      # Utilities\n│   └── App.tsx                   # Main application\n├── src-tauri/                    # Tauri backend\n│   ├── src/\n│   │   ├── adb_commands.rs       # ADB operations\n│   │   ├── lib.rs                # Tauri commands\n│   │   └── main.rs               # Application entry\n│   ├── Cargo.toml                # Rust dependencies\n│   └── tauri.conf.json           # Tauri configuration\n├── public/                       # Static assets\n└── README.md                     # Documentation\n```\n\n## 🔧 Available Commands\n\n### Frontend Commands\n- `bun run dev` - Start Vite development server\n- `bun run build` - Build for production\n- `bun run preview` - Preview production build\n\n### Tauri Commands\n- `bun run tauri dev` - Run app in development mode\n- `bun run tauri build` - Build production app\n- `bun run tauri info` - Show environment info\n\n## 🎯 Roadmap\n\n### Phase 1 ✅ (Completed)\n- [x] Basic device detection and information\n- [x] File browser with download capability\n- [x] App listing and management\n- [x] Logcat viewer with filtering\n- [x] AVD management and launching\n- [x] Settings and configuration\n\n### Phase 2 🚧 (Future)\n- [ ] Real-time logcat streaming\n- [ ] APK installation and app uninstalling\n- [ ] Screenshot capture and screen recording\n- [ ] Network ADB connections\n- [ ] Performance monitoring (CPU, memory, battery)\n- [ ] Interactive ADB shell terminal\n\n### Phase 3 🔮 (Vision)\n- [ ] Plugin system for custom tools\n- [ ] Multi-device operations\n- [ ] Automated testing integration\n- [ ] Device farm management\n- [ ] Cloud device support\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 🙏 Acknowledgments\n\n- **Tauri** - For the excellent Rust-based app framework\n- **Shadcn UI** - For beautiful, accessible UI components\n- **adb_client** - For Rust ADB integration\n- **Lucide** - For consistent iconography\n- **Android Open Source Project** - For ADB and development tools\n\n## 📞 Support\n\nIf you encounter any issues or have questions:\n1. Check the [Issues](../../issues) page for existing solutions\n2. Create a new issue with detailed information\n3. Join our community discussions\n\n---\n\n**Built with ❤️ for the Android developer community**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpavi2410%2Fdroidkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpavi2410%2Fdroidkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpavi2410%2Fdroidkit/lists"}