PornPics Importer

Plugins
,
1
:placard: Summary Browse, review and import full-size PornPics images into Stash.
:link: Repository https://github.com/bprpisync/stash/tree/main/plugins/stash-ppics
:information_source: Source URL https://bprpisync.github.io/stash/main/index.yml
:open_book: Install How to install a plugin?

PornPics Importer

Browse PornPics.com from inside Stash, select the photos you want, review the metadata, and import full-size images directly into your library.

Requires Stash App Drawer to be installed (install via the same index.yml above)

ppics_detail2
ppics_detail21920×854 159 KB

What it does

PornPics Importer adds a complete PornPics browser to Stash.

You can search for performers, studios, tags, or scenes, open PornPics galleries without leaving Stash, select individual photos or entire galleries, review the metadata, and import the full-size images into your configured Stash library.

It also adds a PornPics tab to performer pages, so you can immediately browse matching PornPics galleries for the performer you are viewing.

Highlights

  • Global PornPics search inside Stash

  • Search performers, studios, tags, and scene keywords

  • Supports PornPics gallery, performer, studio/channel, tag, and category URLs

  • Dedicated PornPics tab on Stash performer pages

  • Full-screen spotlight viewer: Zoom, pan, keyboard navigation, thumbnails, and mobile swipe navigation

  • Select individual photos or add an entire gallery at once

  • Detects previously imported photos

  • Detects files that were removed from the output folder

  • Prevents duplicate imports across performer, studio, and tag searches

  • Full metadata review before import

  • Performer, studio, and tag matching

  • Map PornPics metadata to existing Stash entities

  • Optional gallery cover selection

  • Optional linking to an existing Stash video scene

  • Optional organized status

  • Live import progress

  • Manual cache and session reset tasks

ppics_main
ppics_main1920×941 166 KB

Browsing PornPics

Open PornPics from the main Stash navigation.

The search field accepts normal search terms such as:

Pornstar
Studio
Category/tag

You can also paste a PornPics URL directly

Performer integration

When viewing a performer in Stash, the plugin adds a PornPics tab alongside the normal performer tabs.

That view uses the same browser, selection, spotlight, imported-status, and import system as the global PornPics page.

Easy searching

Use the image spotlight to easily preview images and select them for importing.

ppics_spotlight
ppics_spotlight1920×950 88.2 KB

Selecting photos

Open a PornPics scene to select individual images, or use Add all photos directly from the scene list.

Your current selection is available through the Selected button, where photos are grouped by scene.

ppics_import
ppics_import1920×952 95.9 KB

Review before import

Before anything is imported, PornPics Importer opens a review screen.

Depending on the gallery, you can review and adjust:

  • Performers
  • Studio
  • Tags
  • Existing Stash entity matches
  • Metadata mappings
  • Gallery cover
  • Related Stash video scene
  • Organized status

Missing PornPics performers, studios, and tags are not silently created. You decide whether to create them or map them to an existing Stash entity.

ppics_import2
ppics_import21920×881 66.3 KB

Import progress

Imports show live progress while images are downloaded, scanned by Stash, and updated with metadata.

For larger selections the importer also shows an estimated time remaining.

If an individual image fails, the entire import does not have to fail. Successfully imported photos continue normally and failed photos can be retried afterward.

ppics_importing
ppics_importing1920×939 62.6 KB

Result

See the created gallery instantly after importing. All files are downloaded to the output folder you provide in plugin settings and automatically scanned into stash.

ppics_result
ppics_result1920×939 98 KB

2 Likes
2

Good but this is one of those

imagewebsite

3

seems cool but it’s not working. search just keeps going forever and ever with no results. if I open the browser console, I see a ton of 404s

4

I did not even know that was a thing. At least not in the Netherlands. Sorry.

5

Could you check the stash log for me to see what error comes up? And also maybe look in the developer console with F12.

I’ll look into it once I know the issue

6

I get a “The request took to long”

I get the following from F12:
”javascript:158 GET http://localhost:9999/plugin/stash-ppics/assets/cache/4c90242….progress.json 404 (Not Found)

fetchCacheFile @ javascript:158
waitForCache @ javascript:213
undefined -— -— -—
await in waitForCache
requestData @ javascript:427
undefined -— -— -—
await in requestData
loadPerformerPage @ javascript:7389
undefined -— -— -—
startBrowseContext @ javascript:7480
undefined -— -— -—
startPerformerSearch @ javascript:7484
undefined -— -— -—
(anonymous) @ javascript:8774
undefined -— -— -—

”

“javascript:7414 Error: Timeout while waiting for PornPics results.
at waitForCache (javascript:230:15)
at async loadPerformerPage (javascript:7389:26)
at async startBrowseContext (javascript:7480:9)
at async startPerformerSearch (javascript:7484:9)
at async HTMLAnchorElement. (javascript:8774:13)”

Stash Log:

26-08-10 17:08:36Error Plugin returned error: exit status 1

2026-08-10 17:08:36Info [Plugin / PornPics Importer] ModuleNotFoundError: No module named ‘stashapi’

2026-08-10 17:08:36Info [Plugin / PornPics Importer] from stashapi.stashapp import StashInterface

2026-08-10 17:08:36Info [Plugin / PornPics Importer] File “C:\Users\simon\.stash\plugins\stash-ppics\stash.py”, line 4, in

2026-08-10 17:08:36Info [Plugin / PornPics Importer] from stash import Stash

2026-08-10 17:08:36Info [Plugin / PornPics Importer] File “C:\Users\*****\.stash\plugins\stash-ppics/ppics.py”, line 13, in

7

Thank you for your detailed log!

I found the issue and I’m currently working on a fix. The plugin has a dependency on the python lib “stashapi” its currently not found in your installation.

I’m working on a hotfix that removes this dependency all together. But in the mean time you can start using it by doing this:

  1. Go to Stash > Settings > System > Python Executable Path
  2. Note the Python path. If there is no path do the following, otherwise go to step 4:
  3. Open a terminal/cmd window and enter “py” followed by enter, then enter this:
import sys
print(sys.executable)

and hit enter. It will list your python path.

  1. When you got your python path, execute the following in a cmd/terminal:
<C:\your\python\exe\path\here> -m pip install stashapi
  1. Now restart stash and reload plugins. It should work now.

The fix will be ready as quickly as possible, you could also wait on the fix if you don’t want to do these steps!

Please let me know if it works now or if you need any more help!

8

It was easy to fix. Here is the changelog:

PornPics Importer v1.0.1

Small compatibility and stability update.

Fixed

  • Removed the external stashapi dependency.
  • Fixed plugin startup errors on clean Stash installations.
  • Improved Stash GraphQL connection and authentication handling.

The update has already been pushed to GitHub. You can update the plugin via stash > settings > plugins > check for updates.

Please let me know if the issue is fixed now! If there is anything else I can help with please tell me!

Note: I have a bit more spare time to work on more plugins. If you have any ideas for me to make or maybe a new feature for this plugin, please tell me!

9

Update 1.0.2.2

Stash App Drawer integration

A new place for all plugins with a full screen UI like pornpics, but also Binge, StashGifs and more.
If you are a developer of a plugin of this type. Please be a part and read more here.

The app can now be found in the app drawer located in the top right of the screen.

Please update your plugin via plugin settings