PiliPili_Backend

A program suite for separating the frontend and backend of Emby service playback.

中文版本

Introduction

1. This project is the backend application for separating Emby media service playback into frontend and backend components. It is designed to work with the playback frontend PiliPili Playback Frontend.
2. This program is largely based on YASS-Backend, with optimizations made for improved usability.

---

Principle

1. Use a specific nginxconfiguration (refer to nginx.conf to listen on a designated port for redirected playback links from the frontend.

2. Parse the path and signature from the playback link.

3. Decrypt the signature to extract mediaIdand expireAt:

   • If decryption succeeds, log the mediaId for debugging and validate the expiration time (expireAt). If valid, authentication passes; otherwise, return a 401 Unauthorized error.
   • If decryption fails, immediately return a 401 Unauthorized error.

4. Combine the StorageBasePath from the configuration file with the parsed path to generate a local file path.

5. Retrieve file information:

   • If retrieval fails, return a 500 Internal Server Error.
   • If successful, proceed to the next step.

6. Extract the Content-Range

   from the client's request headers:

   • If present, resume playback from the specified range and stream the file in chunks.
   • If absent, start streaming from the beginning of the file.

   

---

Features

• Compatible with all Emby server versions.
• Supports high-concurrency requests.
• Supports signature decryption and blocks expired playback links.

---

Configuration File

# Configuration for PiliPili Backend

# LogLevel defines the level of logging (e.g., INFO, DEBUG, ERROR)
LogLevel: "INFO"

# EncryptionKey is used for encryption and obfuscation of data.
Encipher: "vPQC5LWCN2CW2opz"

# StorageBasePath is the base directory where files are stored. This is a prefix for the storage paths.
StorageBasePath: "/mnt/anime/"

# Server configuration
Server:
  port: "60002"  # Port on which the server will listen

LogLevel: Logging verbosity levels:

• WARN: Minimal logging unless debugging is insufficient.
• DEBUG: Logs DEBUG, INFO, and ERROR. Recommended for debugging.
• INFO: Logs INFO and ERROR. Suitable for regular operations.
• ERROR: For stable, unattended setups, minimizes log entries. Encipher: A 16-character encryption key for signature obfuscation. Must match between frontend and backend. StorageBasePath:
• Ensures consistency between the frontend's Emby storage path mapping and the backend's actual file paths.
  • Example:
    • Frontend EmbyPath: /mnt/anime/OnePiece/Season 22/file.mkv.
    • If /mnt should be hidden, set StorageBasePath: "/mnt".
    • Ensure the same path is configured in the frontend. Server Configuration:
  • port: Listening port, default is 60002.

---

How to Use

1. Install Using Docker (Recommended)

1.1 Create a Docker Directory

mkdir -p /data/docker/pilipili_backend

1.2 Create Configuration Folder and File

cd /data/docker/pilipili_backend
mkdir -p config && cd config

Copy config.yaml to the config folder and edit it as needed.

1.3 Create docker-compose.yaml

Navigate back to the /data/docker/pilipili_backend directory, and copy docker-compose.yml to this directory.

1.4 Start the Container

docker-compose pull && docker-compose up -d

2. Manual Installation

2.1 Install the Go Environment

2.1.1 Remove Existing Go Installation

Forcefully remove any existing Go installation to ensure version compatibility.

rm -rf /usr/local/go

2.1.2 Download and Install the Latest Version of Go

wget -q -O /tmp/go.tar.gz https://go.dev/dl/go1.23.5.linux-amd64.tar.gz && tar -C /usr/local -xzf /tmp/go.tar.gz && rm /tmp/go.tar.gz

2.1.3 Add Go to the Environment Variables

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc && source ~/.bashrc

2.1.4 Verify Installation

go version # If the output is "go version go1.23.5 linux/amd64," the installation was successful.

2.2 Clone the Backend Program to Local Machine

For example, to clone it to the /data/emby_backend directory:

git clone https://github.com/hsuyelin/PiliPili_Backend.git /data/emby_backend

2.3 Enter the Backend Program Directory and Edit the Configuration File

# Configuration for PiliPili Backend

# LogLevel defines the level of logging (e.g., INFO, DEBUG, ERROR)
LogLevel: "INFO"

# EncryptionKey is used for encryption and obfuscation of data.
Encipher: "vPQC5LWCN2CW2opz"

# StorageBasePath is the base directory where files are stored. This is a prefix for the storage paths.
StorageBasePath: "/mnt/anime/"

# Server configuration
Server:
  port: "60002"  # Port on which the server will listen

2.4 Run the Program

nohup go run main.go config.yaml > streamer.log 2>&1 &