mirror of
https://github.com/stashapp/CommunityScripts.git
synced 2026-02-04 10:49:10 -06:00
Update README.md
Added readme with project description and execution instructions
This commit is contained in:
parent
5cecd9d1dc
commit
29ab7190be
@ -1,2 +1,55 @@
|
||||
# stash-inotify
|
||||
inotify service for stash
|
||||
# Stash Watcher
|
||||
Stash Watcher is a service that watches your Stash library directories for changes and then triggers a Metadata Scan when new files are added to those directories. It then waits a period of time before triggering another scan to keep Stash from constantly scanning if you're making many changes. Note that updates are watched during that window; the update is merely delayed.
|
||||
|
||||
## Configuration {#configuration}
|
||||
Modify a [config.toml](config.toml) for your environment. The defaults match the Stash docker defaults, so they may work for you. You are likely to have to update `Paths` and possibly `ApiKey`. Check out [default.toml](default.toml) for all configurable options. You can configure:
|
||||
* Url (host, domain, port)
|
||||
* Api Key (if your Stash is password protected)
|
||||
* Paths
|
||||
* Timeout - the minimum time between Metadata Scans
|
||||
* Scan options - The options for the Metadata Scan
|
||||
|
||||
## Running Stash Watcher
|
||||
You can run Stash Watcher directly from the [command line](#run-python) or from inside [docker](#run-docker).
|
||||
|
||||
### Running directly with python {#run-python}
|
||||
The directs below are for linux, but they should work on other operating systems.
|
||||
#### Step 0: Create a Virtual Environment (optional, but recommended)
|
||||
```
|
||||
python -m venv venv
|
||||
. venv/bin/activate
|
||||
```
|
||||
#### Step 1: Install dependencies
|
||||
```
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
#### Step 2: Create/Modify Configuration
|
||||
Following the directions in [Configuration](#configuration), modify [config.toml](config.toml) if necessary.
|
||||
|
||||
#### Step 3: Execute
|
||||
```
|
||||
python watcher.py path_to_config.toml
|
||||
```
|
||||
That's it. Now when you make changes to watched directories, Stash Watcher will make an API call to trigger a metadata scan.
|
||||
|
||||
### Running with docker {#run-docker}
|
||||
There is currently no published docker image, so you'll have to build it yourself. The easiest way to do this is with docker compose:
|
||||
```
|
||||
version: "3.4"
|
||||
services:
|
||||
stash-watcher:
|
||||
container_name: stash-watcher
|
||||
build: <path_to_stash-watcher_directory>
|
||||
volumes:
|
||||
#This is only required if you have to modify config.toml (if the defaults are fine you don't have to map this file)
|
||||
- ./config.toml:/config.toml:ro
|
||||
#This is the path to your stash content. If you have multiple paths, map them here
|
||||
- /stash:/data:ro
|
||||
restart: unless-stopped
|
||||
```
|
||||
|
||||
Then you can run
|
||||
```
|
||||
docker compose up -d --build
|
||||
```
|
||||
To start the watcher.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user