forked from Github/Axter-Stash
90 lines
5.6 KiB
Markdown
90 lines
5.6 KiB
Markdown
# FileMonitor: Ver 0.7.2 (By David Maisonave)
|
|
FileMonitor is a [Stash](https://github.com/stashapp/stash) plugin which updates Stash if any changes occurs in the Stash library paths.
|
|
It also has a scheduler which can be used to schedule reoccurring task.
|
|
|
|
### Starting FileMonitor from the UI
|
|
From the GUI, FileMonitor can be started as a service or as a plugin. The recommended method is to start it as a service. When started as a service, it will jump on the Task Queue momentarily, and then disappear as it starts running in the background.
|
|
- To start monitoring file changes, go to **Stash->Settings->Task->[Plugin Tasks]->FileMonitor**, and click on the [Start Library Monitor Service] button.
|
|
- 
|
|
- **Important Note**: At first, this will show up as a plugin in the Task Queue momentarily. It will then disappear from the Task Queue and run in the background as a service.
|
|
- To stop FileMonitor click on [Stop Library Monitor] button.
|
|
- The **[Run as a Plugin]** option is mainaly available for backwards compatibility and for test purposes.
|
|
|
|
|
|
### Using FileMonitor as a script
|
|
**FileMonitor** can be called as a standalone script.
|
|
- To start monitoring call the script and pass --url and the Stash URL.
|
|
- python filemonitor.py --url http://localhost:9999
|
|
- To stop **FileMonitor**, pass argument **--stop**.
|
|
- python filemonitor.py **--stop**
|
|
- The stop command works to stop the standalone job and the Stash plugin task job.
|
|
- To restart **FileMonitor**, pass argument **--restart**.
|
|
- python filemonitor.py **--restart**
|
|
- The restart command restarts FileMonitor as a Task in Stash.
|
|
|
|
### Reoccurring Task Scheduler
|
|
To enable the scheduler **Stash->Settings->Plugins->Plugins->FileMonitor** and enable the **Scheduler** option.
|
|
|
|
|
|
To configure the schedule or to add new task, edit the **task_reoccurring_scheduler** section in the **filemonitor_config.py** file.
|
|
```` python
|
|
# The reoccurring scheduler task list.
|
|
# Task can be scheduled to run monthly, weekly, hourly, and by minutes. For best results use the scheduler with FileMonitor running as a service.
|
|
# The frequency field can be in minutes or hours. A zero frequency value disables the task.
|
|
# For weekly and monthly task, use the syntax as done in the **Generate** and **Backup** task below.
|
|
"task_reoccurring_scheduler": [
|
|
{"task" : "Clean", "hours" : 48}, # Maintenance -> [Clean] (every 2 days)
|
|
{"task" : "Auto Tag", "hours" : 24}, # Auto Tag -> [Auto Tag] (Daily)
|
|
{"task" : "Optimise Database", "hours" : 24}, # Maintenance -> [Optimise Database] (Daily)
|
|
|
|
# The following is the syntax used for plugins. A plugin task requires the plugin name for the [task] field, and the plugin-ID for the [pluginId] field.
|
|
{"task" : "Create Tags", "pluginId" : "pathParser", "hours" : 0}, # This task requires plugin [Path Parser]. To enable this task change the zero to a positive number.
|
|
|
|
# Note: For a weekly task use the weekday method which is more reliable. The hour section in time MUST be a two digit number, and use military time format. Example: 1PM = "13:00"
|
|
{"task" : "Generate", "weekday" : "sunday", "time" : "07:00"}, # Generated Content-> [Generate] (Every Sunday at 7AM)
|
|
{"task" : "Scan", "weekday" : "sunday", "time" : "03:00"}, # Library -> [Scan] (Weekly) (Every Sunday at 3AM)
|
|
|
|
# To perform a task monthly, specify the day of the month as in the weekly schedule format, and add a monthly field.
|
|
# The monthly field value must be 1, 2, 3, or 4.
|
|
# 1 = 1st specified weekday of the month. Example 1st monday.
|
|
# 2 = 2nd specified weekday of the month. Example 2nd monday of the month.
|
|
# 3 = 3rd specified weekday of the month.
|
|
# 4 = 4th specified weekday of the month.
|
|
# Example monthly method.
|
|
{"task" : "Backup", "weekday" : "saturday", "time" : "01:00", "monthly" : 2}, # Backup -> [Backup] 2nd saturday of the month at 1AM
|
|
|
|
# The following is a place holder for a plugin.
|
|
{"task" : "PluginButtonName_Here", "pluginId" : "PluginId_Here", "hours" : 0}, # The zero frequency value makes this task disabled.
|
|
# Add additional plugin task here.
|
|
],
|
|
````
|
|
- To add plugins to the task list, both the Plugin-ID and the plugin name is required. The plugin ID is usually the file name of the script without the extension.
|
|
- The frequency field can be in minutes, hours, or days.
|
|
- The freuency value must be a number greater than zero.
|
|
- The scheduler feature requires `pip install schedule`
|
|
- If the user leaves the scheduler disabled, **schedule** does NOT have to be installed.
|
|
- The scheduler will **NOT** work properly when FileMonitor is run as a plugin.
|
|
- The current scheduler code does **NOT** work persistently. That means the schedule always restarts when the program restarts. This may be fixed in future FileMonitor versions.
|
|
|
|
### Requirements
|
|
- pip install -r requirements.txt
|
|
- Or manually install each requirement:
|
|
- `pip install stashapp-tools --upgrade`
|
|
- `pip install pyYAML`
|
|
- `pip install watchdog`
|
|
- `pip install schedule`
|
|
|
|
### Installation
|
|
- Follow **Requirements** instructions.
|
|
- In the stash plugin directory (C:\Users\MyUserName\.stash\plugins), create a folder named **FileMonitor**.
|
|
- Copy all the plugin files to this folder.(**C:\Users\MyUserName\\.stash\plugins\FileMonitor**).
|
|
- Click the **[Reload Plugins]** button in Stash->Settings->Plugins->Plugins.
|
|
|
|
That's it!!!
|
|
|
|
### Options
|
|
- Main options are accessible in the GUI via Settings->Plugins->Plugins->[FileMonitor].
|
|
- Additional options available in filemonitor_config.py.
|
|
|
|
|