Implement initial version of the droidmgr application with core device management and UI components.

Author: theonlyasdk

.gitignore

@@ -0,0 +1,132 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+bin/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script, and contain the bin/
+#  directory corresponding to the Python interpreter
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# PEP 582; used by e.g. github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+.idea/
+
+# Custom
+.agent

README.md

@@ -1,2 +1,63 @@
-# droidcpy
- A GUI for scrcpy
+# droidmgr
+
+A GUI frontend for scrcpy and device manager for Android written in Python using tkinter.
+
+## Features
+
+- **Device Management**: List and manage all connected Android devices
+- **Screen Mirroring**: Start/stop screen mirroring using scrcpy
+- **Process Management**: View and kill running processes on devices
+- **App Management**: List, start, and stop installed applications
+- **File Management**: Browse, download, upload, and delete files on devices
+- **Auto-Setup**: Automatically downloads and installs ADB if not found
+- **Native Theming**: Uses the native theming of your operating system
+
+## Installation
+
+### Prerequisites
+
+The application uses only Python's standard library, but requires system dependencies:
+
+1. **scrcpy** - For screen mirroring
+   - Linux: `sudo apt install scrcpy`
+   - macOS: `brew install scrcpy`
+   - Windows: Download from [scrcpy releases](https://github.com/Genymobile/scrcpy/releases)
+
+2. **ADB** - Will be downloaded automatically if not found
+
+### Running
+
+Simply execute the main entry point:
+
+```bash
+python3 droidmgr.py
+```
+
+Or make it executable:
+
+```bash
+chmod +x droidmgr.py
+./droidmgr.py
+```
+
+## Usage
+
+1. **Connect your Android device** via USB or WiFi ADB
+2. **Enable USB debugging** in Developer Options on your device
+3. **Run droidmgr**: `python3 droidmgr.py`
+4. **Select a device** from the Devices tab
+5. **Use the tabs** to manage processes, apps, or files
+6. **Click "Start Mirroring"** to begin screen mirroring
+
+## Development
+
+The codebase is designed with clean separation:
+
+- **Core modules** are UI-agnostic and can be used independently
+- **UI modules** only handle presentation and user interaction
+- **Threading** is used for long-running operations to keep UI responsive
+- **Error handling** provides user-friendly messages for common issues
+
+## License
+
+All the code in this repository are released under the Mozilla Public License 2.0. See [LICENSE](LICENSE) file for details.

droidmgr.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+"""droidmgr - GUI frontend for scrcpy.
+
+This is the main entry point for the application.
+It automatically initializes and starts the UI.
+"""
+
+import sys
+from pathlib import Path
+
+# Add src to path
+sys.path.insert(0, str(Path(__file__).parent / 'src'))
+
+from ui import MainWindow, InitDialog
+
+
+def main():
+    """Main entry point for droidmgr."""
+    print("Starting droidmgr...")
+    print("Checking dependencies...")
+    
+    # Try to get existing paths first
+    from core import DependencyManager
+    dep_manager = DependencyManager()
+    
+    adb_path = None
+    scrcpy_path = None
+    show_dialog = False
+    
+    try:
+        adb_path = dep_manager.get_adb_path()
+        print(f"✓ ADB found at: {adb_path}")
+    except RuntimeError:
+        print("✗ ADB not found")
+        show_dialog = True
+    
+    try:
+        scrcpy_path = dep_manager.get_scrcpy_path()
+        print(f"✓ scrcpy found at: {scrcpy_path}")
+    except RuntimeError:
+        print("✗ scrcpy not found")
+        show_dialog = True
+    
+    # Only show initialization dialog if dependencies are missing
+    if show_dialog:
+        print("Initializing missing dependencies...")
+        init_dialog = InitDialog()
+        success, adb_path, scrcpy_path = init_dialog.run()
+        
+        if not success:
+            print("Initialization cancelled or failed.")
+            return
+    
+    print("Starting UI...")
+    app = MainWindow(adb_path, scrcpy_path)
+    app.run()
+
+
+if __name__ == '__main__':
+    main()

requirements.txt

@@ -0,0 +1,2 @@
+# Python standard library (built-in)
+tkinter  # GUI framework (usually pre-installed with Python)

src/__init__.py

@@ -0,0 +1,3 @@
+"""droidmgr - GUI frontend for scrcpy."""
+
+__version__ = "0.1.0"

src/core/__init__.py

@@ -0,0 +1,9 @@
+"""Core functionality for droidmgr."""
+
+from .device_manager import DeviceManager
+from .adb_manager import ADBManager
+from .scrcpy_manager import ScrcpyManager
+from .dependency_manager import DependencyManager
+from .config_manager import ConfigManager
+
+__all__ = ['DeviceManager', 'ADBManager', 'ScrcpyManager', 'DependencyManager', 'ConfigManager']