# plugmein.bat

Instantly connect your (or someone else's) dumb **Windows** ass to the **Yggdrasil Network** on demand, with single `.bat` file, no brains required.

![run as adm](_launch.png)

## Requirements

- Windows 10 version 1903 (May 2019 Update) or higher
- Network connection

## Usage

- Download `plugmein.bat` [**here**](../../../raw/branch/master/plugmein.bat) or [**there**](plugmein.bat), whatever works, just make sure your overly smart browser has not changed the `.bat` to `.txt`
- Right-click it
- Run as administrator
- Congratulations!
- Your Yggdrasil network **address has been copied to the clipboard**, you can share it with someone, e.g. to get help through SSH/VNC/RDP

Client window looks like that, green text means that the connection was successful. Just **close this window to disconnect**.

![cmd windows](_cmd.png)

## How it works

To connect to Yggdrasil network, it uses [Popura](https://github.com/popura-network/Popura) - Yggdrasil network client fork which adds several features, including [autopeering](https://github.com/popura-network/Popura/wiki/Autopeering), which kinda makes this whole story zeroconf.

It also downloads and unpacks [Wintun](https://www.wintun.net/) - Wireguard TUN driver that Yggdrasil uses to create virtual network adapter.

Downloads handled through [bitsadmin](https://docs.microsoft.com/ru-ru/windows-server/administration/windows-commands/bitsadmin), unpacking is done by `tar` (which has been [added in the Insider Build 17063](https://docs.microsoft.com/en-us/virtualization/community/team-blog/2017/20171219-tar-and-curl-come-to-windows), in the same patch that added `curl`, which would help a lot, but those sons of bitches broke it a long time ago and aren't interested in fixing it).

## Tips for remote assistance of Windows machines

The first time setup for all of the following is not pretty at all and unfortunately will require some brains. I'm still on the lookout for simple one-click solutions.

SSH access is somewhat reliable since Windows 10, [here's how to enable a server](https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse).

I had a good time using TigerVNC for Windows hosts and Linux clients. [Here's how to install Windows server](https://github.com/TigerVNC/tigervnc/wiki/Setup-TigerVNC-server-%28Windows%29). So far, I haven't needed "Firewall setup" step. At the time of writing, [here is a server .exe](http://tigervnc.bphinz.com/nightly/windows/tigervnc64-winvnc-1.12.80.exe).

## Uninstalling

Just delete `plugmein.bat` and `plugmein` folder which was created alongside the `.bat` when it was first launched.