README.md

YAPO e+

Yapo e+ - Yet Another Porn Organizer (extended plus)

This is a branch of the original YAPO on which I'making improvements. Find the original readme at the bottom (delimited with a line of "=" signs).

There is a setup available for an easy install.

There is also a copy of the setup with pre-registered actors, websites and tags (thousands of them). It will be available on Patreon shortly.

ATTENTION - The program directory MUST be renamed to "YAPO" (upper case) as some functions depend on this!

There are a set of logos available for websites, thanks to @GernBlanston#0168 from Porn Organizing (https://discord.gg/6TvpGA) - get them here: http://yapo-eplus.sex-galleri.dk/websitelogos.zip - they should be unpacked to your YAPO root. YAPO simply matches the website name in your installation with a PNG image in videos/media/logos and if there's a name match, the logo will be shown on the website view. Currently, the filename MUST match the website name (not case-sensitive).

Requirements: FFMPEG, VLC and Python 3.6+ installed. Or use the installer which will even run from a USB stick, should you want to do that.

If you don't want to mess with Python and all the dependencies, there is an (old) installer (Windows only) located here: http://yapo-eplus.sex-galleri.dk/yapo-eplus.exe - this will be updated ASAP.

Discuss and share on Discord: https://discord.gg/ad5hjsA

NEW FEATURES:

• YAPO now supports the new Freeones site layout. The scraper now shows a 0-100% completion for each actor scrape.

• YAPO will let you know if there's a new version on Github.

• As mentioned, we now offer website/producer logos in the website view, if the logo exists in videos/media/logos. Thanks to GernBlanston for sharing them.

• New Python module requirements, it will be necessary to do "pip install --upgrade -r requirements.txt". If necessary, also "python manage.py makemigrations" and "python manage.py migrate"

• On startup, the total disk usage for the video collection is reported.

• YAPO e+ will now strip the measurements field for a bra cup size, tag the actor with the cup size, and also tag with a breast size grouping (fx large or huge).

• YAPO e+ will also tag an actor based on height. Actors of normal height (161-178 cm) won't be tagged.

• There was a field in the actor table for tattoos. This now works, and tatto information shows up in the actor details.

• A field has been added to register information about piercings. In addition, typical types of piercings are now sent to the actor tags.

• YAPO e+ scrapes actor information from IMDB first (best biographies), then from TMDB (best profile pictures) and then from Freeones (best all-round information). If there's a photo in the system and it's taken from TMDB or added by the user, the system no longer downloads a new one if forced to update the actor. This also ensures that your manually added photos won't be overwritten.

• YAPO e+ hashes all scenes (don't worry, it's FAST!) and adds the hash checksum to the scenes table. When requested in settings, it will perform a dupe check after confirmation, and delete all duplicates so only one copy remains.

• A lot of uninteresting console log text has been silenced.

COMING NEXT:

• Soon: Automated importing of Trizkat's actor photo library
• More scrapers
• Experimental scene scraping

PLANNED:

• Photo gallery section
• DVD section
• Additional actor photos (up to 5)
• Function to move all videos belonging to a website or actor so that they reside in the same folder and an ability to set this automatically
• An API for videohashes, tags and actors to avoid hundreds of people re-inventing the wheel

WHAT TO DO IF YOU'RE INSTALLING A NEW COPY OR UPGRADING YOUR EXISTING COPY OF ANOTHER YAPO INSTALLATION?

1. Download FFMPEG from https://ffmpeg.zeranoe.com/builds/ and move the files in the archive's bin/ folder to the subfolder videos/ffmpeg in the YAPO e+ root folder. The program looks for them there, if you're running Windows. If you're running Linux, install FFMPEG using your package manager.

2. Install all dependencies by executing: pip install -R requirements.txt from the main YAPO e+ folder. This installs Django and any other libraries in their minimum required versions.

3. Since the database has changed a bit, it is necessary to migrate (it is, even if it's a new install, because that's how the database is generated).

   Execute: "python manage.py makemigrations" This will look over the new code and take note of the adjustments that needs to be made to the database.

   "python manage.py migrate" This will actually make the adjustments to the database it took note of in the previous step.

   If you get this error when you're done: "You are trying to add a non-nullable field 'date_added' to folder without a default; we can't do that (the database needs something to populate existing rows)." When asked to select a fix, select option 1 and type in "datetime.datetime.now()" (without quotes) and press enter.

4. Enjoy!

===================================================================================

YAPO

YAPO - Yet Another Porn Organizer

Greetings fellow pervs!

TL;DR

YAPO is a software I made to organize and manage porn collections. It's not finished yet, but if you want to try it anyway, at the bottom of the page there are videos that will have you running YAPO in less than 15 minutes. There are also screenshots at the bottom of the page as well.

Demo/Tutorial video of YAPO usage:

Background

About a year ago an EMP (Empornium) user named ''julesx'' created an app called Pornganizer. It's basically a cataloging software fine tuned for cataloging porn. It has actors, tags, websites etc. I thought it was a wonderful idea, because in my mind, the first and most limiting factor in any collection is the extent to which the collector is aware of it.

For example: Let's say you may have a collection of 300 clips but you don't really remember or are not aware of what each one contains. So let's say you want to watch a clip with a redhead, your collection may have 50 clips with redheads in them, but you are limited only to the clips that you remember having redheads in them which is a fraction of that number. So effectively you don't have a collection of 300 clips, you only have a collection of the clips you are aware of, unless you actively go though your clips each time you want to watch something OR if you use a cataloging software like Pornganizer.

If you do use a cataloging software, you can just tag all the 'redhead' clips with the appropriate tag and whenever you want to watch a redhead clip, you just click that tag and you have all of the clips that contain redheads, immediately.

Of course the benefits of cataloging and tagging don't end there, you can have multiple tags on multiple actors and multiple categories so your queries could become extremely specific like: "redheads who have green eyes and were born after 1990 and are taller than 160 cm".

Another benefit of such a software is that it stores all the entries in a database and not in a folder structure. Imagine that you have 2 folders, one for Stoya and one for James Deen. It's entirely possible that there are scenes in the Stoya folder that have both Stoya and James Deen in them but are missing from the James Deen folder, so when you go to the James Deen folder, you miss out on all those scenes. In a cataloging software on the other hand, when you search for Stoya, you get all the scenes that are tagged with her name, across all folders and drives.

There are more benefits to cataloging, but I think you can get the picture.

So I started to use Pornganizer and it was great, but I had a few issues with it. The most pressing one for me as a software student was that its code was closed source for some reason. So every time I had an idea of how to improve it, instead of downloading the code and making modifications I had to try and convince the developer to add those changes. Another thing, is that Pornganizer is for Windows only.

So I decided that I'll make my own Pornganizer, with Blackjack and hookers.

What is YAPO?

Basically YAPO is a product of me wanting to learn Python and wanting to create a cataloging software similar to Pornganizer. Two birds, one stone... I thought. Ironically enough, as of writing this YAPO can't do any of the things I wanted ''julesx'' to put in Pornganizer, YET.

I chose to implement the whole thing as a web app that runs on a local server. My vision was it being a kind of a Netflix thing. So I used Python's Django as the server and AngularJS as the client.

I hope some people who know Python, HTML, AngularJS and CSS will find it interesting enough to add some code of their own to this. I'm really crap at CSS and styling that is why YAPO's interface leaves a lot to be desired. But the good thing is that the interface is just CSS and HTML and anyone with even the most rudimentary CSS/HTML knowledge can add something, and make it better.

What can YAPO do as of now?

• It can import scenes to it's database and create screenshots for them (later I want to make an option to create a screenshot contact sheet like we have on EMP (Empornium) for each torrent, and for the user to be able to open the video at the specific time where he/she clicks on the contact sheet).

• It can optionally create a sample video for the imported scenes, a sample is about 10MB in size and is between 30 and 90 seconds long. For now the length and the number of segments of the sample videos are extrapolated from the source duration, but eventually the user will be able to make their own sample videos.

• It can tag actors, websites and tags for the scenes, and for actors.

• It can navigate folders (the folders that were added to the database)

• It can scrape actor information from TMDb and freeones.com

• And other things I don't remember or can't articulate...

What are the limitations of YAPO?

Due to the limitation of web-apps it's currently impossible to play the videos inside the browser window (though it will be possible in the future using ffmpeg to transcode the video, exactly in the way Emby Media Center does it). Right now YAPO can only show the sample videos inside the browser window and relies on an external player (VLC) to play the full scenes, (just like Pornganizer).

What is YAPO's potential in the future?

• Well, because it's a local server, it can do neat things. For instance it can be accessed from your phone over the local network. Actually not only phones, anything with a browser. Though my main goal right now is not making YAPO mobile-friendly, but because the client side is built with AngularJS and HTML bootstrap it's kind of mobile-friendly already.

• Again, because it's a client-server thing, in the future it will be possible to cast video streams to other devices. It can even be possible over the Internet, not only on the local network. Kind of like your own personal Pornhub.

• Though the reliance on VLC is a drawback for now, it's possible to do pretty nifty things with the VLC player, for example it's possible to create a video wall, programmatically opening up 4 VLC players simultaneously.

• I want to also add support for image sets.

Screenshots:

Scene Detail view:

Actor List view (all the meta-data you see here like height, nationality and so on is tagged automatically from TMDb and Freeones without manual input):

Actor Detail view (an example of adding an actor tag, all the red fields are editable and can be changed by the user):

Folder view:

Currently YAPO is under heavy development and as far as I see it, it's not anywhere near being ready for end user distribution mainly because of the slightly tedious installation process. In the end I want it to be 1 portable .EXE for Windows and whatever executable Linux and Mac OS use. But for now if you want to try it, there are a few hoops you need to jump through, namely install the dependencies and download the code from GitHub. It's not as hard as it seems and it takes less than 15 minutes to set everything up, though I understand if people find it intimidating.

Installation:

I made a few videos that describe exactly what you need to do if you want to try YAPO out:

YAPO's dependencies:

YAPO's dependencies are:

• Python 3
• FFMPEG
• NodeJS
• Bower

YAPO installation:

(Watch the video above for a walkthrough of the installation.)

1. Create a virtual environment for YAPO's installation.
2. With the virtual environment activated, create a folder for YAPO and pull it from Git: C:\YAPO\> git clone https://github.com/cooperdk/YAPO-e-plus.git
3. Install YAPO dependencies: pip install -r requirements.txt
4. Navigate to C:\YAPO\videos\static\bower and install JS dependencies by running: bower install
5. Create YAPO database from C:\yapo\YAPO run: python manage.py migrate
6. (On Windows) Place ffmpeg.exe and ffprobe.exe in the C:\YAPO\videos\ffmpeg folder
7. Start the server from C:\YAPO run: python manage.py runserver 127.0.0.1:8000

PS: A few words about non-Windows OSes. YAPO is made using Python and JavaScript, both are OS agnostic. That being said, I only tested it on Windows and even though it should work on Linux and Mac, I think minor changes to the code needs to be made for it work just as well as on Windows. Specifically changes to functions using VLC and FFMPEG. I would be very happy if people running Linux or Mac would test it out and report back.

Update instructions:

YAPO is a WIP (work in progress) and as such the code will change often, to sync with the latest changes on Git this is what you have to do:

(py3virtualenv) C:\YAPO\> git pull This will pull the latest updates for YAPO from the Git repository.

(py3virtualenv) C:\YAPO\> python manage.py makemigrations This will look over the new code and take note of the adjustments that needs to be made to the database.

(py3virtualenv) C:\YAPO\> python manage.py migrate This will actually make the adjustments to the database it took note of in the previous step.

(In this case py3virtualenv is the name of your virtual environment and C:\YAPO is your YAPO install dir )

Notes:

When updating YAPO, if you get the following error:

You are trying to add a non-nullable field 'date_added' to folder without a default; we can't do that (the database needs something to populate existing rows).

Please select a fix:

1. Provide a one-off default now (will be set on all existing rows)
2. Quit, and let me add a default in models.py Select an option:

You should select option 1 and type in datetime.datetime.now() and press enter.

---