# Emby Proxy Helper

## ⚠️ Legal and Ethical Notice (For Educational Purposes Only)
This project is intended solely for educational, research, development, and testing purposes on networks under your control.
Using this software to bypass licensing mechanisms, use paid features without authorization, or violate terms of service is not recommended, and the responsibility lies entirely with the user.

## 🚀 Overview
Two Docker-based services: Emby Server + Nginx helper
Host scripts: Windows, Linux, macOS (shell/ folder)
Services can access the same files via shared volumes and networks

## ⚡ Startup

Run the `start.cmd` file according to your operating system.

### Windows

```cmd
> .\start.cmd
```
### Linux/Mac

```bash
$ sudo sh start.cmd
```

## 🛠 Configuration

Do not modify the mount and interface structure in `docker-compose.yml`.

Add your media paths under `x-common-volumes`.


## 🌐 To access Global Premiere Features (Global Reverse Proxy)

A proxy server is required for this process. (e.g., Raspberry Pi)
- Install AdGuard Home
- Assign a static IP to the Pi
- Assign a subdomain to your domain address on Cloudflare: `dns.example.com`

    | Type | Name | Proxy | TTL  |
    |------|------|-------|------|
    | A    | dns  | DNS only - reserved IP | Auto |


- Obtain a Let’s Encrypt SSL certificate for `dns.example.com` using Certbot
- Restart **AdGuardHome.service**
- Go to dns.example.com → Setup tab → Configure DoH / DoT settings for your modem network

**Add a global host:**
```bash
35.209.229.156 mb3admin.com
```

## 📱 Client Apps

Depending on your needs, you can use one of the following apps:

- Android TV
- Android
- iOS
- Apple TV

Log in to the server and confirm the certificate warning to proceed.

## Manual Certificate Installation (Optional)
If you want to use Emby via a web browser, you will likely need to install the certificate manually. Under normal circumstances, `start.cmd` automatically handles this for your operating system. However, for devices like PlayStation and Xbox, you can also try installing the certificate manually using a Homebrew Enabler/Payloader. 

Download the `*.crt` file from below and install it on the relevant device.

```bash
$ curl -O https://arg0.dev/emby/mb3admin.crt
```

Alternatively, if you cannot do this, you can bypass the HTTP error by simply visiting `mb3admin.com` in your browser before accessing the Emby web interface, and then proceed with the Emby web environment.

That’s it.

# Summary
This project should be used to:
Learn network configuration
Test reverse proxy logic
Examine Docker-based service architectures.

In real-world use cases, you must always comply with the relevant software’s license and terms of use.