# Transfer of Death - Quick IP Reference Card

## 🚀 FASTEST WAY: Let the App Show You!

The app **automatically displays your IP addresses** at the top when you start it.

Example: `Your IP Address(es): 192.168.86.116 | 10.2.0.45`

Just copy one of those IPs and give it to the other person!

---

## 📋 Manual Commands (If You Need Them)

### Windows
```cmd
ipconfig
```
Look for "IPv4 Address"

### Linux
```bash
hostname -I
```
or
```bash
ip -4 addr show | grep inet
```

### Mac
```bash
ifconfig | grep "inet " | grep -v 127.0.0.1
```
or
```bash
ipconfig getifaddr en0
```

---

## 🎯 Which IP Should I Use?

| Your Situation | Use This IP | Example |
|----------------|-------------|---------|
| **Same Wi-Fi/Network** | 192.168.x.x | 192.168.86.116 |
| **ProtonVPN** | 10.x.x.x | 10.2.0.45 |
| **Tailscale** | 100.x.x.x | 100.64.0.10 |
| **Other VPN** | 10.x.x.x | Check VPN app |

**❌ NEVER use 127.0.0.1** (that's localhost - won't work between PCs)

---

## 🔧 Quick Connection Guide

### Connecting on Same Network:
1. **PC #1:** Start the app, note the IP shown (192.168.x.x)
2. **PC #2:** Enter that IP and port 8000
3. Done!

### Connecting via VPN (ProtonVPN):
1. **Both PCs:** Connect to ProtonVPN
2. **Both PCs:** Change port to 12345 (Settings → Change Port)
3. **PC #1:** Note your VPN IP (10.x.x.x)
4. **PC #2:** Enter that IP and port 12345
5. Done!

### Connecting via Tailscale (Easiest for Remote):
1. **Both PCs:** Install Tailscale, sign in
2. **PC #1:** Note your Tailscale IP (100.x.x.x)
3. **PC #2:** Enter that IP and port 8000
4. Done! (No port forwarding, no firewall issues!)

---

## ✅ Test Before Connecting

```cmd
ping [THE_IP_ADDRESS]
```

If you get replies → Good! IPs can reach each other
If you get timeouts → Problem! Check network/VPN

---

## 🆘 Common Problems

| Problem | Solution |
|---------|----------|
| "Connection refused" | Other PC's app isn't running |
| "Connection timeout" | Can't reach IP (wrong network/VPN) |
| "Permission denied" (10013) | VPN blocking port - change to 12345 |
| "I only see 127.0.0.1" | Not connected to any network |

---

## 🌐 VPN Port Settings

| VPN Service | Blocked Port? | Use This Port Instead |
|-------------|---------------|----------------------|
| ProtonVPN | ✓ Blocks 8000 | 12345 or 45678 |
| Tailscale | ✗ No blocking | 8000 (default) |
| WireGuard | ✗ No blocking | 8000 (default) |
| NordVPN | ✓ Blocks 8000 | 12345 or 54321 |

---

## 💡 Pro Tips

1. **Use Tailscale for remote connections** - it's free and just works
2. **Test with ping first** - saves troubleshooting time
3. **Same port on both PCs** - don't forget!
4. **VPN = VPN IP** - use 10.x.x.x or 100.x.x.x, NOT 192.168.x.x
5. **App shows all IPs** - no need to check manually!

---

## 📱 Example Connection Scenarios

### Home Network Example:
```
PC #1: 192.168.1.100:8000 ← listening
PC #2: connects to → 192.168.1.100:8000
✅ Works!
```

### ProtonVPN Example:
```
PC #1: 10.2.0.45:12345 ← listening (changed port!)
PC #2: connects to → 10.2.0.45:12345
✅ Works!
```

### Tailscale Example:
```
PC #1: 100.64.0.5:8000 ← listening
PC #2: connects to → 100.64.0.5:8000
✅ Works instantly! (No firewall issues)
```

---

**Remember:** The app shows your IPs automatically - you usually don't need to find them manually!
