How to set up theporndatabase/namer on synology

How to Set Up ThePornDatabase/Namer on Synology NAS: A Step-by-Step Guide

ThePornDatabase (TPDB) is a popular metadata scraper for adult entertainment, providing extensive information on performers, scenes, and movies. Combined with a renaming tool like Namer, you can efficiently organize your adult content library. Synology NAS devices, known for their robust features and user-friendly interface, make an excellent platform for hosting this setup. This article provides a detailed, step-by-step guide to installing and configuring ThePornDatabase/Namer on a Synology NAS.

1. Prerequisites

Before setting up ThePornDatabase/Namer on your Synology NAS, ensure you meet the following prerequisites:

• A Synology NAS Device: Ensure it is powerful enough to run Docker containers.
• DSM Installed: Synology DiskStation Manager (DSM) 6.2 or higher is recommended.
• Docker Package: Available on most Synology models (except certain budget models).
• An Account on ThePornDatabase (TPDB): Sign up for a free or premium API key at https://metadataapi.net.
• Namer Software: Namer is a renaming tool that uses TPDB for metadata. You’ll need to download or configure it for your NAS.
• Internet Connection: Required for downloading Docker images and accessing TPDB API.
• Basic Knowledge of NAS Configuration: Familiarity with DSM and Docker basics.

2. Understanding TPDB and Namer

• ThePornDatabase (TPDB): A centralized metadata API for adult content, providing details like performer names, scene descriptions, tags, and more. TPDB is especially useful for organizing large libraries.
• Namer: A renaming tool that integrates with TPDB to structure your files into a consistent naming convention.

By combining TPDB and Namer, you can turn a disorganized folder of files into a well-organized library.

3. Installing Docker on Synology NAS

Docker is essential for running TPDB/Namer efficiently on your NAS. Follow these steps to install Docker:

1. Log in to DSM: Open your Synology NAS web interface.
2. Install Docker:
   • Go to the Package Center.
   • Search for Docker.
   • Click Install and wait for the process to complete.

Once Docker is installed, you’re ready to set up TPDB/Namer.

4. Setting Up TPDB/Namer on Synology

Step 4.1: Installing TPDB/Namer via Docker

1. Open Docker:
   • Navigate to Docker in the DSM interface.
2. Search for TPDB/Namer Image:
   • Go to the Registry tab.
   • Search for tpdb or namer.
   • Select the appropriate image (e.g., ghcr.io/namerbot/namer) and click Download.
3. Download the Image:
   • Choose a version (latest is recommended).
   • Wait for the image to download.
4. Create a Container:
   • Go to the Container tab.
   • Click Create and select the downloaded image.
   • Assign a name to the container (e.g., tpdb-namer).
5. Configure the Container:
   • General Settings:
     • Name: tpdb-namer.
     • Enable Auto-restart.
   • Advanced Settings:
     • Enable resource limits if needed (e.g., memory or CPU usage).
     • Map Volumes:
       • Add a volume for the source files (e.g., /downloads).
       • Add a volume for the output folder (e.g., /organized).
     • Set up Environment Variables:
       • TPDB_API_KEY: Add your API key from ThePornDatabase.
       • NAMER_CONFIG: Path to your Namer configuration file.
6. Launch the Container:
   • Click Apply to save the settings.
   • Start the container from the Container tab.

Step 4.2: Configuring TPDB/Namer

1. Access the Container:
   • Open the container’s terminal via the Docker interface.
2. Set Up Namer Configuration:
   • Locate or create the Namer configuration file (namer.yml).
   • Define your file renaming rules, including:
     • Desired naming structure.
     • Metadata fields (e.g., performer, scene title).
   • Example configuration:
     yaml

     CopyEdit

     api_key: YOUR_TPDB_API_KEY
rename_template: "{performer} - {title} ({date})"

3. Save the Configuration:
   • Place the namer.yml file in the mapped configuration folder.

5. Integrating TPDB/Namer with Your Library

Step 5.1: Organizing Files for TPDB/Namer

Before running the renaming process, organize your files into a source folder:

• Source Folder: Place all unorganized files here.
• Output Folder: TPDB/Namer will move renamed files to this folder.

Step 5.2: Running the Renaming Process

1. Start the Process:
   • Run the command in the container’s terminal:
     bash

     CopyEdit

     namer /downloads /organized

   • Replace /downloads and /organized with your mapped volumes.
2. Monitor Progress:
   • Check the logs to verify the renaming process is running smoothly.

6. Optimizing Your Setup

1. Schedule Renaming:
   • Use DSM’s Task Scheduler to automate the renaming process.
   • Create a scheduled task to run the Namer command periodically.
2. Enable Notifications:
   • Configure DSM to send email or push notifications for Docker container status updates.
3. Regular Updates:
   • Keep the Docker image updated to ensure compatibility with TPDB.

7. Troubleshooting Common Issues

• API Key Errors:
  • Ensure your API key is correctly configured in namer.yml.
• Container Won’t Start:
  • Check volume mappings and environment variables.
• Renaming Issues:
  • Verify the file names match TPDB’s database.

8. FAQs

Can I run TPDB/Namer on non-Synology devices?

Yes, TPDB/Namer works on any device that supports Docker.

Is a premium TPDB API key necessary?

A free API key works, but a premium key provides higher usage limits.

Can I customize the renaming template?

Absolutely! Modify rename_template in namer.yml to suit your preferences.

9. Conclusion

Setting up ThePornDatabase/Namer on a Synology NAS allows you to efficiently organize your adult content library. By leveraging Docker, you can automate the metadata retrieval and renaming process, saving time and effort. Follow this guide to transform a chaotic collection into a well-structured library. If you encounter issues, consult the troubleshooting section or reach out to TPDB’s support community for assistance.