uwucode/ygege

Ygégé - High-Performance U2P Indexer

Ygégé is a blazing-fast indexer for U2P (UTOPEER) written in Rust, designed for seamless integration with *** and other media automation tools.

🚀 Key Features

• High-performance U2P metadata access – Fast queries against U2P metadata relays
• Lightning Fast – Near-instant search results with low memory footprint
• DNS Handling – Reliable resolution even in restrictive network environments
• Zero Dependencies – No browser drivers or external services needed
• ***** Ready** – Drop-in custom indexer support
• TMDB/IMDB Integration – Enhanced metadata fetching
• Multi-Architecture – Supports linux/amd64 and linux/arm64

📦 Quick Start

Using Docker Run

bash
docker run -d \
  --name ygege \
  -p 8715:8715 \
  --restart unless-stopped \
  uwucode/ygege:latest

Using Docker Compose

Create a compose.yml file:

yaml
services:
  ygege:
    image: uwucode/ygege:latest
    container_name: ygege
    restart: unless-stopped
    environment:
      - BIND_IP=0.0.0.0
      - BIND_PORT=8715
      - LOG_LEVEL=info
    volumes:
      - ./ygege/sessions:/app/sessions
    ports:
      - 8715:8715

Then run:

bash
docker compose up -d

🔧 Configuration

Environment Variables

Using config.json (Alternative)

Mount a configuration file instead of using environment variables:

yaml
services:
  ygege:
    image: uwucode/ygege:latest
    container_name: ygege
    restart: unless-stopped
    volumes:
      - ./ygege/sessions:/app/sessions
      - ./ygege/config.json:/app/config.json
    ports:
      - 8715:8715

config.json example:

json
{
  "bind_ip": "0.0.0.0",
  "bind_port": 8715,
  "log_level": "info"
}

🔌 *** Integration

1. Find your *** AppData directory (in /system/status page)
2. Download ygege.yml from the https://github.com/UwUDev/ygege/blob/master/ygege.yml
3. Copy it to {prowlarr_appdata}/Definitions/Custom/ (create Custom folder if needed)
4. Restart ***
5. Add Ygégé as an indexer with:
   • Base URL: http://localhost:8715/ (or http://ygege:8715/ for Docker Compose)

🏷️ Available Tags

📊 API Endpoints

• GET /search – Search U2P metadata with advanced filters
• GET /torrent/info – Get detailed metadata information
• GET /torrent/{id}/files – List files metadata associated with an entry
• GET /health – Health check endpoint

Full API documentation: https://github.com/UwUDev/ygege/blob/master/docs/api-documentation.md

🛡️ Security & Performance

Ygégé focuses on efficient and reliable access to U2P / UTOPEER metadata. It does not host or distribute any content itself; it only queries and exposes metadata provided by U2P services.

📝 Important Notes

🔐 Credentials / Keys: For Docker Compose setups, *** using Docker secrets or environment files instead of hardcoding keys.

🆘 Support & Documentation

• GitHub Repository: https://github.com/UwUDev/ygege
• Full Documentation: https://github.com/UwUDev/ygege/tree/master/docs
• Issues & Bug Reports: https://github.com/UwUDev/ygege/issues
• Docker Guide: https://github.com/UwUDev/ygege/blob/master/docs/docker-guide.md

📜 License

This project is licensed under the MIT License – see the https://github.com/UwUDev/ygege/blob/master/LICENSE file for details.

---

Built with ❤️ using Rust | Multi-arch support: linux/amd64, linux/arm64