# namer

> Namer is a self-hosted, open-source tool that renames adult video files and embeds metadata from ThePornDB for Plex, Jellyfin, and Emby.

- **Category:** File Management
- **Licence:** MIT
- **Latest version:** v1.19.20
- **Open source:** oss
- **Languages:** Python
- **Platforms:** Docker Compose, Unraid, pip
- **Tags:** File Manager, Plex, Emby, Jellyfin, Self Hosted, Watchdog, Adult Video, Nfo Generator, File Renamer, Metadata Tagger, Stash, Theporndb, Perceptual Hash

## Description

Namer renames adult video files and tags MP4 files with metadata from ThePornDB, enabling Plex, Jellyfin, and Emby plugins to identify content automatically. It runs as a folder watchdog that monitors a directory for new files, matches them using filename parsing and perceptual hashes, and moves matched files to a destination folder with structured names. A web UI on port 6980 lets users manually resolve unmatched files. It can also run as a one-shot CLI command to rename individual files or batches. Installation options include Docker (ghcr.io/theporndatabase/namer), pip install, and Unraid templates. The project is MIT-licensed and requires a free ThePornDB API token.

## Links

- [Homepage](https://github.com/ThePornDatabase/namer)
- [Website](https://theporndb.net)
- [Docker](ghcr.io/theporndatabase/namer)
- [Installation Instructions](https://github.com/ThePornDatabase/namer/blob/main/install_instructions.md)
- [Default Configuration](https://github.com/ThePornDatabase/namer/blob/main/namer/namer.cfg.default)
- [GitHub Repository](https://github.com/ThePornDatabase/namer)

---
Source: https://selfhost.directory/project/namer