Instantly connect your (or someone else's) dumb Windows ass to the Yggdrasil Network on demand, with single .bat file, no brains required.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
lnkr 7f686a2b14 Update 'README.md' 2 months ago
README.md Update 'README.md' 2 months ago
_cmd.png Upload files to '' 2 months ago
_launch.png Upload files to '' 2 months ago
plugmein.bat Add 'plugmein.bat' 2 months ago

README.md

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

Requirements

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

Usage

  • Download plugmein.bat here or there, 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

How it works

To connect to Yggdrasil network, it uses Popura - Yggdrasil network client fork which adds several features, including autopeering, which kinda makes this whole story zeroconf.

It also downloads and unpacks Wintun - Wireguard TUN driver that Yggdrasil uses to create virtual network adapter.

Downloads handled through bitsadmin, unpacking is done by tar (which has been added in the Insider Build 17063, 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.

I had a good time using TigerVNC for Windows hosts and Linux clients. Here's how to install Windows server. So far, I haven't needed "Firewall setup" step. At the time of writing, here is a server .exe.

Uninstalling

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