Difference between revisions of "Shutter:Workflow"

From den4b Wiki
Jump to navigation Jump to search
(Clarified the link between events and actions, and multiple independent schedules.)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{Up|Shutter}}  
 
{{Up|Shutter}}  
  
The workflow of [[Shutter]] is quite simple:  
+
The workflow of [[Shutter]] is a simple 3-step process:  
  
#Add [[Shutter:Events|events]] that are to be monitored, and
+
#Add [[Shutter:Events|events]] that are to be monitored, and  
#Add [[Shutter:Actions|actions]] that are to be executed when the specified events occur.
+
#Add [[Shutter:Actions|actions]] that are to be executed when the specified events occur.
 +
#Start monitoring for the specified events.
  
The details are as follows:
+
Shutter monitors for the events to be triggered according to the [[Shutter:Logic|selected logic]], then all actions will be executed one by one. Note that individual events are not directly linked to individual actions, but the lists of events and actions are linked.
  
=== Step 1: Events  ===
+
You can consider that a single instance of Shutter has a single active schedule (preset). If you need multiple active schedules, you need to start multiple instances of Shutter each with its own schedule.
 +
 
 +
=== Step 1: Add Events  ===
  
 
[[Shutter:Events|Events]] are usually based on periodic checking of a system state, execution state of a process, or system time.  
 
[[Shutter:Events|Events]] are usually based on periodic checking of a system state, execution state of a process, or system time.  
  
*You can add multiple events, and also set the logical relationship between them.
+
*You can add multiple events, and also set the [[Shutter:Logic|logical relationship]] between them.
*Check the order of the Actions: Any action must not affect the other actions listed below it.<br>Also ensure that the terminal action (if any) is listed at the end.<br>
+
 
 +
Note that this step only loads the events; Shutter will not start monitoring for the event till you press the [[Image:ShutterStartButton.png]] button (see '''Step 3''').
  
=== Step 2: Actions  ===
+
=== Step 2: Add Actions  ===
  
 
[[Shutter:Actions|Actions]] are executed ''one by one'', from top to bottom.  
 
[[Shutter:Actions|Actions]] are executed ''one by one'', from top to bottom.  
Line 21: Line 25:
 
You can add as many actions as you want, but please be aware of the following factors:  
 
You can add as many actions as you want, but please be aware of the following factors:  
  
*Each action can affect the execution of the other actions listed below it.
+
*Each action can affect the execution of the other actions listed below it. <br>To avoid that, you may have to change the order of the Actions by moving them up/down.  
*Some of these actions are ''terminal''. <br>(They will cause Shutter to stop processing the rest of actions or terminate application altogether. For example: the '''Shutdown''' action.)<br>Therefore, such Actions <u>must</u> be placed at the very <u>end</u> of the '''Actions''' stack.
+
*Some of these actions are ''terminal'': They close Shutter, log out the Windows user or shut down the PC. For example: the '''Shutdown''' action.<br>Therefore, such Actions <u>must</u> be placed at the very <u>end</u> of the '''Actions''' stack. Otherwise the actions listed below them will ''never'' be executed!
 +
 
 +
=== Step 3: Start monitoring  ===
 +
 
 +
Press the [[Image:ShutterStartButton.png]] button. Shutter starts monitoring for the events. The button changes to [[Image:ShutterStopButton.png]]. Press it if you want to stop Shutter in an emergency.
 +
 
 +
*Shutter also has a [[Image:ShutterNowButton.png]] button, which starts all actions without waiting for triggering the event-set.
 +
 
 +
:This is useful to check how the specified actions would actually work.
 +
 
 +
[[Category:Shutter]]

Latest revision as of 14:05, 15 April 2022

Arrow Return.png Shutter  

The workflow of Shutter is a simple 3-step process:

  1. Add events that are to be monitored, and
  2. Add actions that are to be executed when the specified events occur.
  3. Start monitoring for the specified events.

Shutter monitors for the events to be triggered according to the selected logic, then all actions will be executed one by one. Note that individual events are not directly linked to individual actions, but the lists of events and actions are linked.

You can consider that a single instance of Shutter has a single active schedule (preset). If you need multiple active schedules, you need to start multiple instances of Shutter each with its own schedule.

Step 1: Add Events

Events are usually based on periodic checking of a system state, execution state of a process, or system time.

Note that this step only loads the events; Shutter will not start monitoring for the event till you press the ShutterStartButton.png button (see Step 3).

Step 2: Add Actions

Actions are executed one by one, from top to bottom.

You can add as many actions as you want, but please be aware of the following factors:

  • Each action can affect the execution of the other actions listed below it.
    To avoid that, you may have to change the order of the Actions by moving them up/down.
  • Some of these actions are terminal: They close Shutter, log out the Windows user or shut down the PC. For example: the Shutdown action.
    Therefore, such Actions must be placed at the very end of the Actions stack. Otherwise the actions listed below them will never be executed!

Step 3: Start monitoring

Press the ShutterStartButton.png button. Shutter starts monitoring for the events. The button changes to ShutterStopButton.png. Press it if you want to stop Shutter in an emergency.

  • Shutter also has a ShutterNowButton.png button, which starts all actions without waiting for triggering the event-set.
This is useful to check how the specified actions would actually work.