Skip to content

This is a little helper program for the excellent StashApp in Windows.

License

Notifications You must be signed in to change notification settings

philpw99/Stash_Helper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Notice #1: Stash Helper makes managing Stash and playing media directly in Windows easy, but it won't work for Quest 2 or other standalone VR headsets, neither does it work with Linux or MacOS media players.

Notice #2: If you put the installation package to the virustotal.com, it will show some anti-virus programs claim that it contains virus.

This is obviously false positive. You can try it yourself. Download and install the official AutoIt package from AutoItScript.com, then send the AutoIt3.exe from it to the VirusTotal.com, and you will see all the false negatives: AutoIt is virus AutoIt3.exe is the runtime program made by the good folks in AutoItScript.com. My program is nothing but an AutoIt script + AutoIt3.exe. So you decide it yourself for the risk of using my program.

Old news.

New Feature: Ctrl + Mid-Mouse-Button Or Ctrl + Mouse-Right-Button to show a mini-menu


When you click on the middle mouse button plus Ctrl key in the Stash browser, a mini-menu will show up like above. There are a few important features like play, add to playlist, send playlist ... etc. If you like some special buttons for certain features, please create an issue here and let me know.

Notice: Chrome and Edge users.


If Chrome or Edge crashed before, it might still run in the background. If you launch Stash Helper in default profile mode, you might get a "Http 500" error and the program will close down. To fix it, you just need to run Task Manager and end all the chrome and Edge remaining in the memory. Btw, the new Stash Helper v2.4.5 has an updated Webdriver, and it supports Opera now.

Notice: stash v17 compatibility


Because v17 is using a very different file structure, my Stash_Helper 2.3.12 and below will not work properly with it. To use v17 with Stash_Helper, you need Stash_Helper v2.4.1 and above.

To be perfectly clear:

  • If you are using Stash v16.1 or below, use Stash_Helper v2.3.12 or below.
  • If you are using Stash v17 or above, use Stash_Helper v2.4.1 or above.

Personally I don't recommend upgrade to v17 yet, because there is an issue needs to be addressed. The previous file scans from v12 will generate file paths like "g:my folder\my video.mp4" , instead of the normal "g:\my folder\my video.mp4". The upgrades from v12 to v16 didn't fix this problem at all, they just leave the path as it is. Now in V17 if you do a scan with file path like that, you will end with 2 file entries and 2 parent_folder_ids, because Stash v17 will think "g:my folder" and "g:\my folder" are different folders, thus the file paths are also different. I got over 900 duplicate entries because of it.

The easy fix for this is to revert the sqlite database to the v16 one then using a sqlite dabase program to run SQL like below to fix the small error in path. After that Stash v17 will handle the paths correctly.

UPDATE scenes SET path = substr(path,1,2) || '\' || substr( path, 3) WHERE substr( path, 2, 1) == ':' AND substr( path, 3, 1) != '\';

Stash_Helper

StashApp is a powerful content management program for your porn collections. It's cross-platform and comes with many website scrapers. It will make your whole video collection looks professional: with detail info about scenes, performers, studios...etc. It's like what Plex has done for your movie collections.
Though Stash is powerful. It comes with just a console window and not super easy to use for the beginners. This program is trying to improve that aspect and add some features to it.

Features of SH

Supports password protected Stash. Local or remote.
Merge 2 performers' information to reduce performer duplications.
Use Alt-P to easily play the Movie/Scene/Image/Gallery in the current browser tab.
(New) Light Gallery photos browsing. Watching images and galleries, well, like a gallery. Just browse to a gallery then hit Alt-P.
Allow you to choose which browser to run Stash: Firefox, Chrome or MS Edge. It will use the according webdriver to launch Stash web interface.
Provide 20 bookmark slots for each category: Scenes, Images, Movies...etc. You can give a short name for that bookmark, like "Good Video", "Nice Actress"...etc, so you can find and launch the page easily.
You can specify a media player to handle the videos/playlists/images. 6 built-in media player presets like VLC, PotPlayer...etc.
Easy to use scraper manager. Installing a new scraper is as easy as a mouse click. It will also check available updates for your installed scrapers, and ask your permission to update.
Create movies from scenes. It will copy the current scene data and create a new movie with it. Or it can create movies by studios.
CSS Magic to add/remove special CSS Snippets quickly. Usually it works right away, sometimes you need to close the browser to take effect.
Powerful playlist creation tool. You can set the scene filter and it will add the resulting files to the list, or you can browse to a scene/movie, hit "Ctrl-Alt-A" or Mid-Mouse-Button to add it to the list, whichever more convenient for you. You can save or load the play list in standard .m3u format. The playlist can be sent to the media player you chose.
Stash autoupdate (for v11 and above). Each time SH is launched, it will check the latest version of Stash. If it found the new released version, it will ask you about updating. You can choose to ignore it, update it or just cancel.
One button to scan for new files in your collection.
Open the current scene/movie/image's media folder so you can find the files easily.

Shortcomings of SH

  • Windows only.
  • Some anti-virus programs don't like AutoIt scripts (.a3x). So far no one told me an virus alarm was triggered yet.
  • Poor handling of multi-tab browsing due to the limit of webdriver. I recommend using Stash_Helper with single tab browser only.

Installation

Get the latest release here and just run it. Basically the installer has nothing need to change.

Running it the first time

After installation now you have this item in your start menu:


Click on it, and this welcome screen will show up:

Now it's time to browse for that stash-win.exe you downloaded from the "Stash" link above. Or you can click on the "Website" button and go there.

The second question is about which browser you want to use to see the content provided by Stash. I recommend Chrome and Edge. Firefox will give you a robot head and a red address bar. Doesn't look good that way.

Then it's all set. There are some extra info I provided for the first time Stash user, and you will see why you need to know them later. Right now just launch it already!

Now you should comes to the Stash Wizard screen:

Complicated? Hard to understand? Don't be. Just click on "In the current working directory". That's the correct answer 99.9999% of the time.

The next screen seems less intimidating, just click on the "Add Directory" button, tell Stash where your carefully curated collections are. Then click on "Next"

This screen is even easier, just click on "Confirm"

Once again, it says blah,blah,blah and your instinct is to click on "Finish", right?

WRONG Notice it tells that you need to "...clicking on Tasks, then Scan..."??? Yeah, I did miss that part, and it took me quite a while to figure it out.

Now you are staring at an empty Stash database and still don't know what went wrong. Didn't you just tell Stash where your em... collections were?

No, this is actually your fault. You need to follow the instructions. Go to the "Settings", click on "Task" then "Scan", like the screen shown here.

Then just like magic, all your video collections are now showing up in the "Scenes","images" and "Galleries"(if you have zipped jpgs).

Because those screens are not "Work Place Safe". So I won't show them here. Just want to congratulate you on your first baby step toward the almighty Stash ! And where is my program fit in? It's hiding in the corner! Look here:

It's ready to help. Click on it and you will see:

So what's so special about it? Well, go to the settings, please.

You see? Besides you can use your own media player to play your scenes, there is a "Boss Coming Key" for you, in case your boss is really coming toward you at the worst moment. :D

Now the most powerful feature is customizing the menu. Click on "Scenes->Customize...", and you will see this:

This is like the bookmark or favorite list. You can give it an descriptive title, then paste the link copied from Stash, like I've shown above. Next time you can get to the same page easily by using my helper:

The next topic is about "Scraper Manager". This is a very important feature in both Stash and my helper.

If you know the website where your downloaded your video, a scraper will help you to retrieve the video information by "scraping" that video's URL.
A scraper will save you tons of time. You don't need to manually type in things like performers, studio, production date, description, video duration...etc. A scraper get those information for you, but you need to know which scraper to get. Some scrapers get you great accurate info, some don't. So you need to do the experiments for them. Since I provide you an easy way to install/remove scrapers, it should be a piece of cake.

To use an installed scraper, you choose a scene, click on "Edit" and fill in the "URL" blanket. If that URL fits the scraper's website, an white scraper icon will come up next to URL. Click on that and the scraper will start its work.

Some scrapers don't need URLs, like Performer's scrapers. They just need a name, and they will search a website for that name, and give you the performer's info in return. Stash comes with a performer's scraper: freeones, which is quite good in looking up the performer's info, but personally I like Babepedia scraper more.

One more thing, why Stash has "Movies" that people rarely used? Well, movies are used for Japanese videos, in which one movies usually contains multiple scenes. There is nothing wrong to create a movie for a single-scene video. The movies have front and back cover, and they look really cool on my screen.

Well, I guess this concludes the readme. There will be more features coming, both in Stash and my little helper. I hope you will find "pleasure" in using them. :D