Metadata-Version: 2.2
Name: adbnik
Version: 0.2.1
Summary: Adbnik — one desktop app for ADB, SSH, serial, device files, and USB screen control.
Author: Adbnik contributors
License: MIT
Project-URL: Homepage, https://nvnkennedy.github.io/adbnik/
Project-URL: Repository, https://github.com/nvnkennedy/adbnik
Project-URL: Documentation, https://github.com/nvnkennedy/adbnik#readme
Project-URL: PyPI, https://pypi.org/project/adbnik/
Keywords: android,adb,ssh,serial,scrcpy,pyqt5,sftp,desktop,screen-mirroring
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: Qt
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt5<6.0,>=5.15.11
Requires-Dist: pyserial<4.0,>=3.5
Requires-Dist: paramiko<5.0,>=3.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Provides-Extra: build
Requires-Dist: pyinstaller<7.0,>=6.0; extra == "build"

# Adbnik

**Adbnik** is a **desktop control room** for Android and embedded work: **ADB shell** tabs, **SSH** sessions, **serial (COM)** consoles, **device and remote file** browsing, and **USB screen mirroring** (via scrcpy or another tool you install)—in **one window** with tabs and bookmarks.

It is **not** made by Google. It does **not** bundle ADB, OpenSSH, or scrcpy. Install those yourself (or use existing installs) and set paths under **File → Preferences** if they are not on your `PATH`.

---

## What you can do

| Goal | In Adbnik |
|------|------------|
| Shell, install, device commands | **ADB**: pick a device, open shell tabs, bookmarks and shortcuts. |
| Remote servers | **SSH** tabs using the `ssh` client on your **PATH**. |
| Boards / firmware logs over COM | **Serial**: port and baud in the same UI. |
| Files on phone or server | **File explorer** workflows (Android / remote). |
| Mirror the device screen on PC | **Screen**: launch your mirroring tool (e.g. scrcpy). |

---

## Before you install

- **Python 3.9+** (64-bit recommended on Windows).
- **Platform-tools (ADB)** on `PATH`, USB debugging on the device.
- **OpenSSH client** (`ssh`) on `PATH` for SSH tabs.
- **scrcpy** (or similar) for mirroring, on `PATH` or set in Preferences.
- **COM** hardware + driver for serial.

---

## Install

Use the **same Python** for `pip` and for running the app. On Windows this avoids broken `Scripts\adbnik.exe` installs.

**Recommended:**

```bat
py -m pip install --upgrade pip
py -m pip install adbnik
py -m adbnik
```

**If you use a specific Python (example: `C:\Python\python.exe`):**

```bat
C:\Python\python.exe -m pip install --upgrade pip
C:\Python\python.exe -m pip install adbnik
C:\Python\python.exe -m adbnik
```

Always prefer **`python -m adbnik`** if double-clicking **`adbnik.exe`** ever fails.

---

## First run

1. Start the app with **`py -m adbnik`** (or your `python -m adbnik`).
2. Set **ADB** / **scrcpy** paths in **File → Preferences** if not on `PATH`.
3. Open **ADB**, **SSH**, **Serial**, **Files**, or **Screen** from the UI.

Settings: **`%USERPROFILE%\.adbnik.json`**. An older **`.devicedeck.json`** is migrated when you save.

---

## Fix: `ModuleNotFoundError: No module named 'adbnik'`

The **`adbnik` package** is missing in the Python that runs your launcher (usually **mixed pip / mixed Python**).

```bat
C:\Python\python.exe -m pip uninstall adbnik -y
C:\Python\python.exe -m pip install --force-reinstall adbnik
C:\Python\python.exe -c "import adbnik; print(adbnik.__file__)"
C:\Python\python.exe -m adbnik
```

Use **`your\python.exe -m pip`** every time—not a different `pip` on `PATH`.

List interpreters: `py -0p`.

---

## Development

```bat
git clone https://github.com/nvnkennedy/adbnik.git
cd adbnik
py -m venv .venv
.venv\Scripts\activate
py -m pip install -e ".[dev]"
py -m pytest tests -q
py -m adbnik
```

Windows **.exe** packaging: `adbnik.spec`, `scripts/build_windows_exe.ps1`, installers under `installer/`.

---

## Links

| | |
|--|--|
| **Repository** | [github.com/nvnkennedy/adbnik](https://github.com/nvnkennedy/adbnik) |
| **PyPI** | [pypi.org/project/adbnik](https://pypi.org/project/adbnik/) |
| **Site** | [nvnkennedy.github.io/adbnik](https://nvnkennedy.github.io/adbnik/) |

Maintainer upload steps: [docs/PYPI_PUBLISH.md](docs/PYPI_PUBLISH.md).

---

## License

MIT — see [LICENSE](LICENSE).
