Skip to content

Latest commit

 

History

History
152 lines (135 loc) · 13.1 KB

README.md

File metadata and controls

152 lines (135 loc) · 13.1 KB

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 this:

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

to fix the small error in path. After that Stash v17 will handle the paths correctly.

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" 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.
Ctrl-Enter is the boss coming key. Hit it and it will immediately close the browser and the media player.
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