stash-empornium 0

Backend server for EMP Stash upload helper userscript

stash-empornium

This script by user humbaba allows torrent files and associated presentations to be created for empornium based on scenes from a local stash instance.

Installation

Using Docker

The docker version is recommended as it comes bundled with all required and recommended backend dependencies. To run the backend as a docker container, copy and paste the following commands:

docker pull bdbenim/stash-empornium:latest
docker run -d \
--name stash-empornium \
-p 9932:9932 \
--mount type=bind,src=/path/to/config,target=/config \
--mount type=bind,src=/path/to/save/torrents,target=/torrents \
--mount type=bind,src=/media,target=/media \
bdbenim/stash-empornium:latest

[!NOTE] Make sure that the target for your /media mount matches what stash sees. You may have to change the target, not just the source, to achieve this.

You can configure additional mount points by copying the same syntax as above. This may be useful if your stash library uses multiple directory locations. When in doubt, refer to the File Info tab of the scene in stash to get the file path as stash sees it:

Without Using Docker

The backend can also be run directly by intalling its dependencies and running the python script.

Backend Dependencies

• Python3
  • flask
  • requests
  • vcsi
  • configupdater
  • cairosvg
  • waitress (optional)
• ffmpeg
• mktorrent

Run the following commands to install the backend and dependencies (may vary slightly by OS):

git clone https://github.com/bdbenim/stash-empornium.git
cd stash-empornium
pip install -r requirements.txt
sudo apt-get install -y ffmpeg mktorrent

You can optionally install waitress as a production WSGI server:

pip install waitress

Userscript

Dependencies

• Tampermonkey

Currently the script does not work with other userscript managers, though this may change in the future.

The userscript can be installed here. Place the other files on the same machine as your stash server and ensure dependencies are installed.

Configuration

1. Visit upload.php and open the Tampermonkey menu. Set the backend URL, stash URL, and API key (if you use authentication).

2. Update config file located at config/config.ini:

[backend]
## name of a file in templates/ dir
default_template = fakestash-v2
## where torrents are placed
torrent_directory = /home/foobar/torrents
## port that the backend listens on
port = 9932

[stash]
## url of your stash instance
url = http://localhost:9999
## only needed if you set up authentication for stash
# api_key = 123abc.xyz

The port above corresponds to the backend URL in step 1, so if you change one you must change the other.

Usage

1. Run emp_stash_fill.py
2. Get scene ID (it's in the url, e.g. for http://localhost:9999/scenes/4123 the scene id is 4123)
3. Go to upload.php and enter the scene ID in the "Fill from stash" box
4. Select the file you want if you have multiple files attached to that scene, tick/untick the generate screens box, pick template if you have defined others
5. Click "fill from" and wait as the tedious parts of the upload process are done for you. Status messages should appear and instructions for final steps. Performer tags like pamela.anderson will be generated for you, along with resolution tags and url tags of the studio, e.g. 1080p and brazzers.com
6. You still need to load the torrent file (the location on your filesystem will be given to you) into the form, set a category, optionally check for dupes if you didn't do so manually. Also load the torrent file into your client (you can configure the torrent output directory to be a watch dir for your torrent client) and make sure the media file is visible to your torrent client
7. When you're satisfied everything is ready, upload

Templates

This repository includes default templates which can be used to fill in the presentation based on data from stash. Currently there are two, however more may be added in the future.

Adding Templates

To add a new template, save it in the templates directory alongside your config.ini file. Then add it to your configuration with the following format:

[templates]
filename = description

Templates are written using Jinja syntax. The available variables are:

• audio_bitrate
• audio_codec
• bitrate
• contact_sheet
• container
• cover
• date
• details
• duration
• framerate
• image_count
• performers
  • name
  • details
    • image_remote_url
    • tag
• resolution
• screens
• sex_acts
• studio
• studio_logo
• title
• video_codec

Refer to the default templates for examples of how they are used.

Custom Lists

In addition to the template variables described above, additional tag lists may be added to the empornium config section by following the format of the sex_acts variable. These will automatically be parsed and made available to any custom templates as comma-separated lists. For instance, you may wish to add a section called performer_attributes to describe characteristics of performers in the scene.

Titles

Similarly to templates, the title has a few options for formatting. This uses python's builtin string formatter, so variable names are enclosed in braces ({}) within the string. The default title format is:

[{studio}] {performers} - {title} ({date})[{resolution}]

This would result in something like this:

[Blender Institute] Big Buck Bunny, Frank, Rinky, Gimera - Big Buck Bunny (2008-05-10)[1080p]

The available variables that can be used are:

• codec
• date
• duration
• framerate
• performers
• resolution
• studio
• title