Push2Run Help v2.0

  Welcome to the Push2Run version 2.0 Help page.  This page covers the following:
  An overview of Push2Run
  The Push2Run icon on your screen and in your systray
  The Main window
  The Options window
  The Add/Change window
  The Session log window
  The About/Help window
  Using Push2Run from the command line
Other topics:
   For first time setup, please see the Push2Run Setup page
  For an example of how to send a custom text, as words to be spoken, to your Google device please see this how to page
  For the community forum, please see the community support forum
  For the version history, please see the Push2Run Version History page.
An overview of Push2Run

Push2Run is free program which, with the help of IFTTT and Pushbullet, allows you to control your Windows PC or laptop using your Google Assistant (Google Home, Google Mini, Google Max, or smart phone running Google Assistant).

With IFTTT, Pushbullet and Push2Run setup, you will be able to say things like: "OK Google tell my computer to" ... "check the CBC news website", "open my budget", "print my shopping list", "run a quick backup", or whatever you like.

Also, as you can give these commands to your Google Assistant you don’t even need to be at your computer to do so.   Handy for giving certain commands, such as “OK Google tell my computer to shutdown”, from another room.

The Push2Run icon on your screen and in your systray
Push2Run iconTo start Push2Run you can click on the Push2Run icon on your desktop (if you have it there) or in the list of your Windows programs accessible from the Windows' start icon. 

The program may also be started automatically when you sign onto Windows based on your choice in the program's Options window.  

When running, the Push2run icon will appear in your systray (usually found in the bottom right hand side of your screen, near your system clock).  Double clicking on the Push2Run icon on your screen or in your systray will cause the Push2Run main window to open.  Left clicking on the Push2run systray icon the program will provide you quick menu of Push2Run windows to open.  Another option you will see when you left click on the Push2run systray icon is the option to Pause.  You can toggle the Pause option on or off - it is the same as turning the master switch off or on.

When Push2Run is running normally the background of the Push2Run systray icon will be white.  However, if the master switch is turned off, the systray Pause option is checked, or if the program is not connected to Pushbullet then the background of the Push2run systray icon will be red.
The Main window
Push2Run main window
The main window allows you to add, change and remove what Push2Run listens for and how it reacts to what it hears.  The main window also allows you to tailor what information is shown and how.  As well, it provides access to the session log and help / about windows.

What Push2Run listens for and how it reacts to what it hears

Push2Run listens for specific phrases, and when it hears them runs the commands / programs you tell it to.

From the main window you can toggle on and off the monitoring all at once or individually by command.

A Master Control Switch allows you to toggle on and off all monitoring, simply clicking the on/off switch to make this happen. 

When you toggle the Master Control Switch 'off' all monitoring is paused.  When you toggle the Master Switch 'on' all the commands which were being individual monitored the last time the switch was turned on will be turned on once again.

Monitoring of individual command can be turned on and off by clicking their associated switches.

Individual commands can be added, changed, and removed via the Actions item on the main windows' menu bar, this is described in more detail below.

What is shown on the main window

The main window also allows you to arrange/organize the order of what it is monitored, as well as the information displayed on each line.

Along the top of the main window there is a menu bar.  In the menu bar there are three main menu items: Actions, View, and Help.

Under the 'Actions' menu item you can:
Arrange the
order of the rows you see in the
main windows
  chose to have main window command line rows either automatically or manually arranged.  To make this choice either check or uncheck the option 'Sort by description'.  When this option is checked the command lines will be automatically sorted on an ongoing basis, when it is unchecked you will be able to arrange the command lines your self by moving them up and down, inserting blank lines, etc.
Set Options
  open the options window.
  change is Push to run is running with administrative privileges or not. Click on 'Actions - Give Push2Run administrator privileges' / 'Remove administrator privileges form Push2Run' to toggle between running Push2Run with or without administrator privileges.   If Push2Run is running with administrator privileges then it will be able to run other programs with administrator privileges without the Window's UAC notification prompt.
Exit the program   click 'Exit' to stop Push2Run from running.

Of note, clicking on the red 'X' in the top right of the main window will not cause the program to exit, rather it will simply be minimized to the systray (usually found at the bottom right of the primary screen - near the system clock).  The first time you do this, a pop-up window will appear to inform you of this.  There will be an option on that window that you can select to not be reminded of this again. 
Under the 'View' main menu item you can:
chose which
columns you
would like
to see
  click on any column name to toggle if you would like that column to be shown or not; you can hide any of the columns except for the switch.
chose to see a filter line near the bottom of the window    with the View - Filters option selected a line of filter boxes will appear near the bottom of the screen.  These will be aligned with the various columns of the Main window, for example: Description, Listen To, Open, etc..

What is typed in a filter box is used to narrow down the rows displayed in the main window.  For example if you want to see only entries with the word 'calculator' in the description, just type 'calculator' (without the quotes) in the filter box below the 'Description' column. 

The 'Clear filters' button clears all filters.

Note: when the filter is on various menu options - such as add, delete, and undo will be disabled.  These will however be re-enabled when the filters are cleared.
chose to
see the
Session Log
  click on 'Session log' to toggle viewing of the Session log.
Under the 'Help' main menu item you can:
chose to
see the
About/Help window
  click on 'About/Help' to toggle viewing of the About/Help window.
Dragging and Dropping:
You can drag and drop both to and from the Main window.

What you can drag into the main window:

You  can hold the left mouse button down and then drag program icons and shortcuts (including shortcuts to websites) into the Main window.  When you drag a program icon or shortcut into the Main window Push2Run will automatically open and fill out the Add/Change window with as much information as it can gather from the program icon or short cut.  You can then update the Add/Change window information as needed and click 'OK' to save it (or 'Cancel' to cancel the update).  The original program icon or short cut that you dragged into the Main window will remain unchanged.

You  can also hold the left mouse button down and then drag the '<Body>' line from the Session log window onto any entry in the Main window.  In doing this the spoken words associated with the '<Body>' line will be added to the Push2Run 'Listen for' words for that Main window entry.

What you can drag out of the main window:

Additionally, you can also left single click and with the mouse button down the drag any of the entries in the main window onto your Windows desktop.  This will create an exported Push2Run card entry.  The exported Push2Run card entry will have a file extension of .p2r and if double clicked on or dragged into to Push2Run main window will open up the Add/Change window with the same information as was in the original entry. Push2Run .pr2 files are generally quite small, not encrypted and can be shared.

The Options window

In the Options window there are two panels.  You can select the option you want to work with in the first (left) panel, and then adjust their settings in the right panel (for all but the Settings and Database files option).

Most of the options are self explanatory.  However, some call for a bit of an explanation / context:

Pushbullet - Access Token
- you get this from Pushbullet website - Settings - Access Tokens 

Pushbullet - Title Filter - this is the phrase you use when setting up IFTTT, it separates pushes to be handled by Push2Run from all other pushes.

For Push2Run to process a request on a specific PC or laptop all the words used in the Push2Run Options Pushbullet Settings window must be included in the words entered in the IFTTT Push a note window. 

In the simplest case, where you are using Push2Run on only one PC or laptop, the words in the Push2Run Options Pushbullet Settings window match the words in the IFTTT Push a note window.  The default words are 'Push2Run YourComputerName'.  

If you want to have a Google Home/Mini command processed on more that one PC or Laptop all at once, you can.   An example of where you might want to do this, is you saying "OK Google tell all my computers to shut down".

To do this you would set up a separate IFTTT command, generally as described in the setup instructions, with the following two updates:
   1.  the IFTTT entry for what you want to say should be something like 'Tell all my computers to $'
  2. the IFTTT Push a note Title would be something like 'Push2Run ROBSPC  KAYSLAPTOP BASMENTPC'.

Startup - Password required - if checked this will require a password to start Push2Run and to access your Push2Run commands.   The password is case sensitive.   If you set a password and later no longer know it, neither you nor Push2Run will be unable to use your Push2Run related data - and effectively you will need to start over in terms of configuring it.   By default the password feature is turned off.  If you turn it on, you can turn the it off again - but to do that you will need to know the password which you had last set.

Settings and Database files - the location of the Settings and Database files are shown but can't be changed.   Clicking on the associated buttons that appear, opens the folders in which the files are kept.

User Access Controls (UAC)  - some programs require administrative privileges to run correctly.  With Windows if you have UAC notification turned on then either:
    Push2Run will need to itself be running with Administrative privileges for it to run programs without Windows UAC prompts,
    your will need to click on the 'Yes' button when prompted by the Windows UAC notification window to allow a program to run when Push2Run requests it to be run.  In this case, if you click 'No' to the UAC notification prompt, or if don't click the 'Yes' within two minutes of the UAC notification prompt being presented, Windows will automatically terminate the run request - effectively before what ever you had wanted to have run starts running.

The Add/Change window
  Add / Change window  
The Add/Change window is where Push2Run is setup to listen for commands and to react to them.  The following describes the Add/Change window:

Description   The description is shown as the first column to the right of the switch on the main window, it is used to help identify what a particular entry is all about
Listen for   This is where the phrase Push2Run will listen for and react too are entered.  The program automatically sorts these for you, removes duplicate entries, and unnecessary white spaces.  All words are also automatically converted to lower case and spell checked with words underlined in red when they are unknown to the spell checker.

You can also add a dollar sign ('$') at the end of the phrase to listen for and Push2Run will pass the end part of your command to the open and parameters fields below.   For example if you can enter "to search for $" in the 'Listen For' phrase, say 'OK Google tell my computer to search for bunny rabbits" and have "bunny rabbits" passed along into the Open and Parameters fields for processing (see below for more information).
Open   Open is the program, batch file, script file, file, or website that Push2Run will open when it hears the 'Listen for' phrase. 

If the program, batch file, or script file is in a directory in your Windows system path then you do not need to enter the full path and filename.  In the above example the program "shutdown.exe" is, by default, found in most systems in the directory C:\Windows\System32 folder which is on most systems a directory in the system path.  Accordingly, just entering the name of the program will suffice.   If the program is not in a directory within your system path, then you should enter its full path and filename - for example: C:\Program Files\A Ruler for Windows\aruler

If the file ends with an extension which your system knows, then you can just enter the file name in the open field to have Push2Run open it.  For example, if you have MS Office installed, you could just enter   C:\Users\your user id\Documents\Budgets\My Budget.xlsx   to have Push2Run open it.

As your system also knows how to deal with websites, you can also enter the name of a website, such as www.Push2Run.com

If the 'Listen For' phrase ends with a dollar sign ('$') you can also include the '$' sign to represent the end part of the phrase that Push2Run heard (as described above).  For example in the 'Open' field you can enter https://google.com/search?q=$  . 

Another example is https://www.google.com/search?tbm=isch&q=$ if your 'Listen to' phrase was "to search for pictures of $"  and/or  "to search for images of $".

The '$' can be placed anywhere in the url, including at the very end.

As the $ will be replaced by the words you speak each word will separated by a space.  For example "dog cat mouse".  If you would like the spaces between words to be replace by something else then you can identify that something else by surrounding it with square brackets following directly after the $.  For example if you want the spaces between words replaced by commas between words, you would use $[,] . If you would like the spaces between words removed entirely you would use $[]
Start directory   Some programs need to be run out of the directory they are found in, others do not.  If the program you want to run requires starting from a particular directory, this is where you can enter that directory - for example:   C:\Program Files (x86)\CallClerk
Parameters   Some programs also allows parameters to be passed into them.   For example, the Windows Shutdown command allows this.  The screenshot above shows an example of what you might want to enter.

Of note, some programs that take path and file names as parameters need those path and file names surrounded by quotes if they contain spaces.  Accordingly, you may need to enter quotes around the path and file name you enter in this field.

If the 'Listen For' phrase ends with a dollar sign ('$') you can also include the '$' sign to represent the end part of the phrase that Push2Run heard.

This works in the same way as is described for the 'Open' field above, including support for the $[something else] syntax to replace the spaces between words by something else.
Start with administrative
  If your program requires administrative privileges to run, check this check box.

Please also see the note above on User Access Controls (UAC).
Of note: to help fill this screen out you can drag and drop a program, file, or website short cut into one of the empty text fields on the Add/Change window.  If you do this, Push2Run will automatically fill in the empty fields in the window with what it thinks is best.
The Session log window
Push2Run Session log
The Session log window keeps a running report of Push2Run's activities since the program was last started.  As new activity happens new entries are automatically added to the bottom of the log.  The Session log holds up to 10,000 lines.  After the maximum limit of lines has been reached, the oldest entries are removed to make room for the newest ones.

A button at the bottom of the window allows Auto Scrolling to be turned on or off.  With Auto Scrolling turned on the window will automatically scroll itself to keep pace with new activities, with Auto Scrolling turned off you control the scrolling using the scroll bar on the right.

Another button at the bottom of the window allows you to copy the contents of the Session Log into your Windows clipboard.  Just click the 'Copy to clipboard' button to do that.

The About/Help window
  push2run main window
On the About / Help window you can click on various links to be opened in your default browser. 

These include:
  the Push2Run home page,
  this About/Help webpage,
  the Push2Run Community Support Forum,
the Creative Common's Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0) license which applies to Push2Run, and
  a webpage where you can make a donation in support of Push2Run.
The Push2Run command line

You can run Push2Run itself from the command line and pass into the program, even if it is currently running, a phrase that Push2Run has been set up to listen for.  For example, from the windows cmd window, from the Push2Run program directory, you can enter:

c:\Program Files\Push2Run> Push2Run open the calculator

You're welcome to download and use Push2Run for free on as many computers as you like!

Click here to download Push2Run

PayPal donations are very much appreciated
  info@push2run.com   Copyright 2018 Rob Latour.
All Rights Reserved.
  Other great software by Rob Latour:
   A Ruler for Windows   CallClerk   A Form Filler   Concentration  FixMyLocation 
  MyArp   Reporting for Rackspace   UDPRun