Program Runner Source
Compatible apps: Decisions, Trends, Artistic
Program Runner allows you to run custom commands to launch programs in an X window session. For example, it allows you to run custom-installed software programs to accomplish objectives such as connecting to Citrix environments, using VLC to play uncommon media types, or launching LibreOffice to display documents and presentations.
Program Runner is a very powerful tool with the potential to cause system damage and loss of data if an improper command is entered. It is strongly recommended to test command strings on a non-production system before implementing production sources. Userful cannot guarantee support for all possible uses and applications that run with Program Runner. Linux administration experience is strongly recommended before using this source
Create a Program Runner Source
In your Userful Infinity account, navigate to Sources and Destinations.
Click Sources in the left pane.
Click Create Source at the top right corner. A panel appears.
Add a name and description for your Source.
Optional: Select or create a tag for easy access to the Source.
To create a Tag, click on the Tags drop-down menu. A cursor appears.
Enter the name of the tag and press the Enter key. The Tag gets created. Tags help sort Sources when there are multiple Sources.
Select the Source Type as Program Runner.
Select a thumbnail.
Add the Linux command for the Program Runner Source including the arguments.
Select the display layout.
Enable the Hide mouse pointer option if you want.
Select whether you want to retain or discard the session data if the program is stopped.
Enter Framerate (available from Userful Infinity version 12.9).
To add more settings, go to the next step. Else click Save.
Click the Advanced tab.
Enter the Resolution at which the Source should be streamed to the Destination.
Select Scaling option from the drop-down menu.
Scale to Fit The source is scaled so that the border of the image and the entire image are visible inside the display. This most often results in black bands above and below the image.
Stretch Full Screen The source is scaled so that the entire image is visible on the display. This means the video's aspect ratio is stretched horizontally and vertically to match the display's aspect ratio.
Zoom Full Screen The source is scaled so that some image is outside the display (cropped). This eliminates the black banding on the display, but it means that either the horizontal or vertical outside edges of the video will not be visible to the user.
Enable the Shareable option if you wish to reduce resource utilization. When the Source is used for streaming content, and the Shareable option is enabled, the server generates one Source instance and shares it across applications. For example, if you create two Sources with the same parameters and map the sources to the Canvas/Mapping Group, the server only creates one running instance of the Source reducing resource utilization.
To restrict access to selected apps and user groups, click the Permissions tab and select the apps and user groups.
Click Save.
Last updated