def parse_name(filename: str): # Expected pattern: studio YY MM DD performer title rating pattern = r'(?P<studio>\w+)\s+(?P<year>\d2)\s+(?P<month>\d2)\s+(?P<day>\d2)\s+(?P<performer>[\w\s]+)\s+(?P<title>[\w\s]+)\s+(?P<rating>\w+)' match = re.match(pattern, filename) if not match: return None parts = match.groupdict() # Convert two‑digit year to four‑digit parts['year'] = f'20parts["year"]' date = f"parts['year']-parts['month']-parts['day']" new_name = f"parts['studio'].title() - date - parts['performer'].title() - parts['title'].title() - parts['rating'].upper().mp4" return new_name

# Naming Guide

import re import os from pathlib import Path

passionhd 24 04 17 ellie nova good morning xxx it can be hard to know what each part means, how to sort it, and how to keep your library tidy. The following tutorial walks you through a systematic approach that works for any similarly‑structured name. | Segment | Likely meaning | How to treat it | |---------|----------------|-----------------| | passionhd | Production studio or source | Store as the studio tag | | 24 | Year (2024) or episode number | If it’s a year, use a date tag; otherwise a sequence tag | | 04 | Month (April) or part number | Combine with the previous segment for a full date ( 2024‑04 ) | | 17 | Day of month or another sequence | Together with month → full date 2024‑04‑17 | | ellie nova | Performer or main subject | Add as a performer tag | | good morning | Scene title or keyword | Use as the title field | | xxx | Content rating flag | Store as a rating tag ( XXX ) | Tip: If you’re unsure whether a numeric segment is a date or an episode number, check the source’s naming conventions or look at surrounding files for patterns. 2. Rename the file using a consistent pattern A clear, searchable format is:

When you receive a file name like

def rename_files(folder: Path): for file in folder.iterdir(): if file.is_file() and file.suffix.lower() == '.mp4': new_name = parse_name(file.stem) if new_name: new_path = file.with_name(new_name) file.rename(new_path) print(f"Renamed: file.name → new_name")

If your manager supports custom tags, you can also add a tag ( passionhd ) for extra granularity. 4. Automate the process with a script For large collections, a simple Python script can parse and rename files automatically.

- **Studio** – Capitalized, no spaces. - **Date** – `YYYY-MM-DD`. - **Performer** – First‑Last (or stage name) with each word capitalized. - **Title** – Short, descriptive, title‑cased. - **Rating** – Upper‑case (e.g., `XXX`, `R18`).