2022-10-24, 20:15
AdultScraper Right-Click NFO Tools for Kodi
I am posting my scripts here to help people convert the movie NFOs created by AMM/AdultScraper into episode NFOs that can be used to make your XXX library look and behave like regular TV Shows with episodes.
I will post 2 versions of the tools.
Links for Executables used in Tools:
Installation (Full zip)
*Under Streaming Videos, i did include the script for Remove Duplicate Frames From Video because it may come in handy for some...
Installation (Scripts Only)
*Under Streaming Videos, i did include the script for Remove Duplicate Frames From Video because it may in come handy for some...
Usage
This is the suggested workflow... Everyone has their way of doing things but be aware that my scripts assume a certain file naming convention and folder structure. Folder structure doesn't change but if you don't like my file naming convention, you can always reload the final result in EMM/AMM/TMM as a TV Show and rename your stuff any way you like. The workflow is:
Renaming Files
I have included Rename Master scripts to rename and organize the files. You can use them in the Rename Master GUI or right-clicking on the root folder containing your freshly downloaded XXX scene releases. If you download directly from the site yourself, i suggest this naming convention
Site Name - Release Date - Actress - Title.ext
Site Name - Release Date - Actress or Title.ext
Site Name - SeasonxEpisode - Title.ext
Say you have a folder called Adult and if contains scene releases like so:
You can then Right-Click again and select Delete Empty Folders
Your folder should now look like this:
Now you can go into each individual site folder and right-click each season folder and select Add Episode Numbers to XXX Releases.
A season folder that looks like this:
Now looks like this:
You are now ready to fire up AMM or EMM w/AdultScraper and start scraping!
Scraping with AdultScraper
In order for the Adult Scraper to pick up the filenames properly and be able to search by site name and title, you need to let AMM/EMM know how to parse the files.
You can configure this under Settings | Movies | General | Folder/File Name Filters.
(?i)\s\-\s[0-9]{4}\-[0-9]{2}\-[0-9]{2}\s\-\s[0-9]{4}x[0-9]{2}\s\-\s.*\s\-(?i)
(?i)\s\-\s[0-9]{4}\-[0-9]{2}\-[0-9]{2}\s\-\s.*\s\-(?i)
(?i)\s\-\s[0-9]x[0-9]{2}\s\-.*(?i)
These Regex will be able to detect the site name and title of the episode for files named like so:
Nuru Massage - 2022-01-07 - 2022x01 - Gizelle Blanco - Confidence Boost.mp4
Pure Taboo - 2018-02-27 - Ashley Adams - Daddy Diddler.mp4
Fuck or Fired - 1x02 - She Wants a Job and Likes It Up Her Ass.mp4
Modifying AdultScraper generated NFOs
WARNING: This step will modifying your NFO files. Because i cannot anticipate all file naming conventions or illegal characters, this may mess up you NFOs. Please back them up until you are sure the script works for you or you may need to rescrape everything from scratch.
Once the data has been scraped, you should also rename all *-fanart.jpg to *-thumb.jpg. You can do this via the command line or load up the Rename Master GUI. If you don't know how, let me know.
You can now run my scripts to convert the NFOs and add the season information.
You can open one of the NFOs to see if the <movie> element has been converted to <episodedetails>
If all is well, now add the Episode details...
You will get a prompt asking you to enter an episode number to start with. To start at 1, enter 0. If you are adding to an existing show, run the scripts outside the final folder where the episodes reside and say you have 3 new episodes that start at #46, put 45 as to where you want to start. This seems stupid but is the best i could do with basic windows batch files. Someone smarter may have better knowledge of windows batch commands (not PowerShell)
Open the files again and verify all files now have <season> and <episode> elements.
Preparing for import into Kodi
All you need now is the tvshow.nfo
You can create one manually or load your folder containing the site folders into the TV Shows section of you favorite media manager and manually input the information for the "TV Show". You can also edit the following as your template inside Notepad++ and save it as tvshow.nfo in the root of each site folder.
tvshow.nfo template:
Now i am sure i messed something up while packaging this and i probably forgot to mention something so please make backups of you data before playing with this and just post in this thread for questions, issues or tips.
Hope someone finds this useful...
P.S. If you don't want to use the folder C:\Utils\Scripts, you can edit the Settings File to Import.ini in Notepad++ before importing and find and replace all occurrences of C:\Utils\Scripts with wherever you want to place them.
You will need to add said folders to your path environment variable and you also need to edit ren_xxx.cmd and ren_xxx_add.cmd to point to the location of Rename Master and the .rmscr files
I am posting my scripts here to help people convert the movie NFOs created by AMM/AdultScraper into episode NFOs that can be used to make your XXX library look and behave like regular TV Shows with episodes.
I will post 2 versions of the tools.
- Full version including all executable files
- Scripts only version for people who don't trust me . I will provide the source links for the executables.
Links for Executables used in Tools:
- FileMenu Tools by LopeSoft (Download v7.0.5, the last freeware version, here)
- Rename Master by JoeJoe
- FFmpeg by a bunch of geniuses
- FileTouch by SoftTree Technologies
- Xidel by Benito van der Zander
- XMLStarlet by Mikhail Grushinskiy
Installation (Full zip)
- Extract the zip to the root of your C: drive. You need admin privileges. It will create a folder called Utils with other folders below.
- Add C:\Utils and C:\Utils\Scripts to your PATH environment variable. Instructions here (No need to reboot)
- Run Register FileMenuTools.exe from the C:\Utils\FMT folder
- Run FileMenuTools.exe from same folder
- Click File | Import Settings and browse to C:\Utils\FMT to import the file called Settings to Import.ini
- Delete the Comics, Streaming Videos*, Emulation and Android Menu/Submenu entries as i did not include these scripts. They are for other things obviously
- Apply Changes (Green Checkmark) and Exit FileMenu Tools
*Under Streaming Videos, i did include the script for Remove Duplicate Frames From Video because it may come in handy for some...
Installation (Scripts Only)
- Extract the zip to the root of your C: drive. You need admin privileges. It will create a folder called Utils with other folders below.
- Add C:\Utils and C:\Utils\Scripts to your PATH environment variable. Instructions here (No need to reboot)
- Copy ffmpeg.exe, FileTouch.exe, xidel.exe and xml.exe to C:\Utils
- Copy RenameMaster.exe to C:\Utils\RM
- Run FileMenuTools-portable_v7.0.5.exe. Point it to C:\Utils\FMT and click Install
- Check the Run FileMenu Tools box and click Finish.
- Click File | Import Settings and browse to C:\Utils\FMT to import the file called Settings to Import.ini
- Delete the Comics, Streaming Videos*, Emulation and Android Menu/Submenu entries as i did not include these scripts. They are for other things obviously
- Apply Changes (Green Checkmark) and Exit FileMenu Tools
- Run Register FileMenuTools.exe from the C:\Utils\FMT folder
*Under Streaming Videos, i did include the script for Remove Duplicate Frames From Video because it may in come handy for some...
Usage
This is the suggested workflow... Everyone has their way of doing things but be aware that my scripts assume a certain file naming convention and folder structure. Folder structure doesn't change but if you don't like my file naming convention, you can always reload the final result in EMM/AMM/TMM as a TV Show and rename your stuff any way you like. The workflow is:
- Rename Files
- Move files to appropriate folders
- Scrape data with AdultScraper
- Rename *-fanart.jpg to *-thumb.jpg
- Convert movie NFOs to episode NFOs
- Add Season and Episode data to NFOs
- Rename files again (optional)
- Scrape with Kodi using Local Information Scraper
Renaming Files
I have included Rename Master scripts to rename and organize the files. You can use them in the Rename Master GUI or right-clicking on the root folder containing your freshly downloaded XXX scene releases. If you download directly from the site yourself, i suggest this naming convention
Site Name - Release Date - Actress - Title.ext
Site Name - Release Date - Actress or Title.ext
Site Name - SeasonxEpisode - Title.ext
Say you have a folder called Adult and if contains scene releases like so:
- Right-Click on the folder called Adult and go to Kodi XXX Renamer
- Click Rename XXX Scene Releases
You can then Right-Click again and select Delete Empty Folders
Your folder should now look like this:
Now you can go into each individual site folder and right-click each season folder and select Add Episode Numbers to XXX Releases.
A season folder that looks like this:
Now looks like this:
You are now ready to fire up AMM or EMM w/AdultScraper and start scraping!
Scraping with AdultScraper
In order for the Adult Scraper to pick up the filenames properly and be able to search by site name and title, you need to let AMM/EMM know how to parse the files.
You can configure this under Settings | Movies | General | Folder/File Name Filters.
- Add the following 3 Regex and move them to the top, in this order (You only need to do this once):
(?i)\s\-\s[0-9]{4}\-[0-9]{2}\-[0-9]{2}\s\-\s[0-9]{4}x[0-9]{2}\s\-\s.*\s\-(?i)
(?i)\s\-\s[0-9]{4}\-[0-9]{2}\-[0-9]{2}\s\-\s.*\s\-(?i)
(?i)\s\-\s[0-9]x[0-9]{2}\s\-.*(?i)
These Regex will be able to detect the site name and title of the episode for files named like so:
Nuru Massage - 2022-01-07 - 2022x01 - Gizelle Blanco - Confidence Boost.mp4
Pure Taboo - 2018-02-27 - Ashley Adams - Daddy Diddler.mp4
Fuck or Fired - 1x02 - She Wants a Job and Likes It Up Her Ass.mp4
- Add or refresh your sources and scrape.
Modifying AdultScraper generated NFOs
WARNING: This step will modifying your NFO files. Because i cannot anticipate all file naming conventions or illegal characters, this may mess up you NFOs. Please back them up until you are sure the script works for you or you may need to rescrape everything from scratch.
Once the data has been scraped, you should also rename all *-fanart.jpg to *-thumb.jpg. You can do this via the command line or load up the Rename Master GUI. If you don't know how, let me know.
You can now run my scripts to convert the NFOs and add the season information.
- Right-Click on a video file inside a yearly season folder and select Clean XXX Episode NFOs under Kodi XXX NFO Tools for AMM
You can open one of the NFOs to see if the <movie> element has been converted to <episodedetails>
If all is well, now add the Episode details...
- Right-Click on the same video file and select Add XXX Episode Details to NFOs under Kodi XXX NFO Tools for AMM
- This is for filenames with the actress and title. If you only have one of the two, use the one saying One Token and if there is no date, the use... wait for it... No Date
- This is for filenames with the actress and title. If you only have one of the two, use the one saying One Token and if there is no date, the use... wait for it... No Date
You will get a prompt asking you to enter an episode number to start with. To start at 1, enter 0. If you are adding to an existing show, run the scripts outside the final folder where the episodes reside and say you have 3 new episodes that start at #46, put 45 as to where you want to start. This seems stupid but is the best i could do with basic windows batch files. Someone smarter may have better knowledge of windows batch commands (not PowerShell)
Open the files again and verify all files now have <season> and <episode> elements.
Preparing for import into Kodi
All you need now is the tvshow.nfo
You can create one manually or load your folder containing the site folders into the TV Shows section of you favorite media manager and manually input the information for the "TV Show". You can also edit the following as your template inside Notepad++ and save it as tvshow.nfo in the root of each site folder.
tvshow.nfo template:
Code:
<?xml version="1.0" encoding="utf-8"?>
<tvshow xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<title>Pure Taboo</title>
<tag>Taboo</tag>
<tag>Big Budget</tag>
<genre>XXX</genre>
<premiered>2017-09-08</premiered>
<studio>Gamma Entertainment</studio>
<plot>Presented by Gamma Films, Pure Taboo is an award-winning porn studio unlike any other. We take taboo porn seriously, exploring the darkest corners of sex and desire in hardcore, taboo sex videos that you need to see to believe. Scenes are shot with gritty, film-like productions with a cinematic feel and feature today’s top pornstars in their most challenging roles. Our videos tackle forbidden subject matters like step-family fantasies, perverted doctors, submission porn and sneaky voyeurs, where nobody is considered innocent and everyone is willing to test their limits.</plot>
</tvshow>
Now i am sure i messed something up while packaging this and i probably forgot to mention something so please make backups of you data before playing with this and just post in this thread for questions, issues or tips.
Hope someone finds this useful...
P.S. If you don't want to use the folder C:\Utils\Scripts, you can edit the Settings File to Import.ini in Notepad++ before importing and find and replace all occurrences of C:\Utils\Scripts with wherever you want to place them.
You will need to add said folders to your path environment variable and you also need to edit ren_xxx.cmd and ren_xxx_add.cmd to point to the location of Rename Master and the .rmscr files