🎬

What is Stash?

Stash is a free, open-source, self-hosted media organiser for your video library. It runs locally on your machine, lets you tag, organise and browse your collection, and connects to community databases for metadata. If you have a large video library, Stash is the best way to manage it — and our plugin brings your downloaded metadata straight into it.

🔌
Info JSON Importer
Stash Plugin — Python
Ready

The Info JSON Importer is a Stash plugin that reads the .info.json files saved by Video Fetcher and MetaFetch, and imports the metadata — titles, dates, descriptions, tags and studio — directly into your Stash library.

Once installed, it appears as a task inside Stash under Settings → Tasks → Plugins. Run it once to batch-import all your existing metadata, or run it any time you've downloaded new videos.

🔍
Scans All Scenes
Gets every scene from Stash via GraphQL and finds the file path for each one.
📄
Reads .info.json
Looks for a matching .info.json file alongside each video file.
📥
Imports Metadata
Pushes title, date, description, tags and studio into Stash via the GraphQL API.
🔁
Dry Run Mode
Preview what would be imported before making any changes to your library.
⬇ Download Plugin
⚙ Installation
1
Download the plugin
Download and unzip the plugin folder above.
2
Install stashapp-tools
The plugin requires the stashapp-tools Python library. Install it with:
pip install stashapp-tools
3
Copy to your Stash plugins folder
Copy the infoJsonImporter folder into your Stash plugins directory — usually:
~/.stash/plugins/
4
Generate a Stash API Key
In Stash go to Settings → Security → API Key → Generate. Copy the key.
5
Configure the plugin
Open infoJsonImporter.py and paste your API key where indicated at the top of the file.
6
Reload plugins in Stash
In Stash go to Settings → Plugins and click Reload Plugins. The Info JSON Importer will appear in the list.
7
Run it
Go to Settings → Tasks → Plugins → Info JSON Importer → Run. Optionally run Dry Run first to preview.
💡 Tip — Stash version

This plugin was developed and tested on Stash v0.31.1. It should work on recent versions. If you have issues, check that stashapp-tools is up to date: pip install --upgrade stashapp-tools