An organizer for your porn, written in Go
Go to file
alexandra-3 87cea80e7b
Fix a bunch of scanning / tagging bugs (#3154)
* Fix possible infinite loop/stack overflow with weird/broken zip files
* Fix path length calculation using bytes instead of characters (runes)
* Fix bug where oshash gets buffers with size not actually multiple of 8
* Add oshash tests

Co-authored-by: WithoutPants <53250216+WithoutPants@users.noreply.github.com>
2022-12-01 16:48:04 +11:00
.github Upgrade to go 1.19 only (#3087) 2022-11-09 14:41:23 +11:00
.idea Cut over to v2.5 UI (#433) 2020-04-03 08:46:23 +11:00
cmd/stash Don't show dialog box when run from terminal (#2560) 2022-05-05 11:30:10 +10:00
docker Remove python3/python link 2022-11-23 14:52:23 +11:00
docs add `pre-ui` to default make target and update documentation (#3030) 2022-10-26 09:18:02 +11:00
graphql Performer disambiguation and aliases (#3113) 2022-12-01 13:54:08 +11:00
internal Performer disambiguation and aliases (#3113) 2022-12-01 13:54:08 +11:00
pkg Fix a bunch of scanning / tagging bugs (#3154) 2022-12-01 16:48:04 +11:00
scripts Fix test database generator (#3112) [skip ci] 2022-11-10 15:01:47 +11:00
ui Performer disambiguation and aliases (#3113) 2022-12-01 13:54:08 +11:00
vendor Upgrade to go 1.19 only (#3087) 2022-11-09 14:41:23 +11:00
.dockerignore Replace packr with go embed (#1751) 2021-09-22 13:08:34 +10:00
.gitattributes Refactor build (#493) 2020-04-29 12:13:08 +10:00
.gitignore Stash rating system (#2830) 2022-11-16 09:31:44 +11:00
.golangci.yml [Files Refactor] Fix lint github action error (#2853) 2022-09-06 07:04:52 +00:00
.gqlgenc.yml Fix submission of scene drafts without performers (#2515) 2022-04-18 10:43:27 +10:00
LICENSE
Makefile Remove netgo build tag from Windows builds (#3170) 2022-11-23 09:10:39 +11:00
README.md I18N: Add Estonian, Russian first-level langs, add many preview langs (#3176) 2022-11-22 18:27:47 -05:00
go.mod Upgrade to go 1.19 only (#3087) 2022-11-09 14:41:23 +11:00
go.sum Upgrade to go 1.19 only (#3087) 2022-11-09 14:41:23 +11:00
gqlgen.yml File storage rewrite (#2676) 2022-09-06 07:03:42 +00:00
tools.go [Files Refactor] Performance tuning (#2819) 2022-09-06 07:03:42 +00:00

README.md

Stash

https://stashapp.cc

Build Docker pulls Go Report Card Discord

Stash is a self-hosted webapp written in Go which organizes and serves your porn.

demo image

  • Stash gathers information about videos in your collection from the internet, and is extensible through the use of community-built plugins for a large number of content producers and sites.
  • Stash supports a wide variety of both video and image formats.
  • You can tag videos and find them later.
  • Stash provides statistics about performers, tags, studios and more.

You can watch a SFW demo video to see it in action.

For further information you can read the in-app manual.

Installing Stash

Windows MacOS Linux Docker
Latest Release
Development Preview
Latest Release (Apple Silicon)
Development Preview (Apple Silicon)
Latest Release (Intel)
Development Preview (Intel)
Latest Release (amd64)
Development Preview (amd64)
More Architectures...
Instructions
Sample docker-compose.yml

First Run

Windows Users: Security Prompt

Running the app might present a security prompt since the binary isn't yet signed. Bypass this by clicking "more info" and then the "run anyway" button.

FFMPEG

Stash requires ffmpeg. If you don't have it installed, Stash will download a copy for you. It is recommended that Linux users install ffmpeg from their distro's package manager.

Usage

Quickstart Guide

Stash is a web-based application. Once the application is running, the interface is available (by default) from http://localhost:9999.

On first run, Stash will prompt you for some configuration options and media directories to index, called "Scanning" in Stash. After scanning, your media will be available for browsing, curating, editing, and tagging.

Stash can pull metadata (performers, tags, descriptions, studios, and more) directly from many sites through the use of scrapers, which integrate directly into Stash.

Many community-maintained scrapers are available for download at the Community Scrapers Collection. The community also maintains StashDB, a crowd-sourced repository of scene, studio, and performer information, that can automatically identify much of a typical media collection. Inquire in the Discord for details. Identifying an entire collection will typically require a mix of multiple sources.

StashDB is the canonical instance of our open source metadata API, stash-box.

Translation

Translate 🇧🇷 🇨🇳 🇩🇰 🇳🇱 🇬🇧 🇪🇪 🇫🇮 🇫🇷 🇩🇪 🇮🇹 🇯🇵 🇰🇷 🇵🇱 🇷🇺 🇪🇸 🇸🇪 🇹🇼 🇹🇷

Stash is available in 18 languages (so far!) and it could be in your language too. If you want to help us translate Stash into your language, you can make an account at translate.stashapp.cc to get started contributing new languages or improving existing ones. Thanks!

Support (FAQ)

Answers to other Frequently Asked Questions can be found on our Wiki

For issues not addressed there, there are a few options.

  • Read the Wiki
  • Check the in-app documentation, in the top right corner of the app (also available here
  • Join the Discord server, where the community can offer support.

Customization

Themes and CSS Customization

There is a directory of community-created themes on our Wiki, along with instructions on how to install them.

You can also make Stash interface fit your desired style with Custom CSS snippets.

For Developers

Pull requests are welcome!

See Development and Contributing for information on working with the codebase, getting a local development setup, and contributing changes.