Skip to main content

Prowlarr Integration

Ygégé can be used as a custom indexer for Prowlarr, allowing you to integrate YGG Torrent into your media management stack.

Prerequisites​

  • Prowlarr installed and running
  • Ygégé started and accessible
  • The ygege.yml file from the GitHub repository

Installation​

1. Locate Prowlarr's AppData Directory​

The AppData directory path is displayed in Prowlarr's /system/status page.

Prowlarr Status

Example paths:

  • Linux/Docker: /config or /data
  • Windows: C:\ProgramData\Prowlarr
  • macOS: ~/.config/Prowlarr

2. Create the Custom Folder​

In Prowlarr's AppData directory, navigate to Definitions/ and create a Custom folder if it doesn't exist:

mkdir -p /config/Definitions/Custom

3. Copy the Definition File​

Copy the ygege.yml file (French by default, or ygege-en.yml for the English version) from the GitHub repository to the Custom folder:

# Download directly from GitHub
wget https://raw.githubusercontent.com/UwUDev/ygege/master/ygege.yml \
  -O /config/Definitions/Custom/ygege.yml

Or manually:

  1. Download ygege.yml
  2. Place it in {appdata}/Definitions/Custom/

4. Restart Prowlarr​

Restart Prowlarr to detect the new indexer:

docker restart prowlarr

Indexer Configuration​

1. Add the Indexer​

  1. Go to Indexers
  2. Click the + button to add an indexer
  3. Search for "Ygégé" in the list
  4. Click on "Ygégé"

Prowlarr Add Indexer

2. Configure Settings​

Prowlarr Ygege Configuration

ParameterValueDescription
NameYgégéIndexer name
Enable✅Enable the indexer
URLhttp://localhost:8715/Base URL
API Path/apiAPI path
CategoriesAllCategories to index
Important Base URL

Prowlarr does not allow customizing the base URL. Use:

  • Local installation: http://localhost:8715/
  • Docker Compose: http://ygege:8715/ (service name)
  • Custom DNS: http://ygege-dns-redirect.local:8715/

3. Docker Compose Configuration​

If Prowlarr and Ygégé are in the same compose.yml:

services:
  prowlarr:
    image: lscr.io/linuxserver/prowlarr:latest
    container_name: prowlarr
    # ... prowlarr configuration
  
  ygege:
    image: uwucode/ygege:latest
    container_name: ygege
    # ... ygege configuration

# They're automatically on the same network
# Use http://ygege:8715/ in Prowlarr

4. Test the Connection​

  1. Click Test in the indexer configuration
  2. Prowlarr should connect successfully
  3. Click Save

Usage​

  1. Go to Search in Prowlarr
  2. Enter your search query
  3. Ygégé will appear in the results

Synchronization with Sonarr/Radarr​

Prowlarr will automatically synchronize the Ygégé indexer with your connected *arr applications.

Supported Categories​

Ygégé supports all YGG categories:

Prowlarr CategoryYGG Mapping
MoviesFilms
TVTV Series
AudioMusic
PCApplications
XXXAdult
OtherOther

Troubleshooting​

Indexer Doesn't Appear​

  1. Verify that ygege.yml is in Definitions/Custom/
  2. Restart Prowlarr
  3. Check Prowlarr logs for errors

Connection Error​

  1. Verify that Ygégé is running: curl http://localhost:8715/health
  2. Check the URL configured in Prowlarr
  3. For Docker, verify containers are on the same network

No Results​

  1. Check Ygégé logs: docker logs ygege
  2. Verify your YGG credentials are valid
  3. Test the API directly: curl http://localhost:8715/api/search?q=test

Next Steps​