Sources and Destinations
Last updated
Last updated
Copyright © 2024 Userful Corporation. All rights reserved.
After configurations, the next step is to set up your content sources, assets, and destinations (Userful clients). This module helps you maintain your sources and destinations all in one place. This screen is divided into three sections:
A Source is a player for a specific type of content. The source is mapped to the destination to stream content. This section details different types of sources. For a list of all Sources and the apps in which you can use them, go to Sources and supported apps.
HDMI input is connected to a server capture card.
Click on the Create Source option. The Create Source menu appears.
Enter the Name and Description.
Select the Source Type as HDMI Capture.
Select a thumbnail.
Select the port for BM connection. It is the capture connection port.
Enable the Use XClient option. It creates a separate back-end process for each Blackmagic capture stream, running each inside a windowed app. This option improves the stability and scalability of Blackmagic capture sources, allowing more consecutive sources to run, i.e., up to twenty-four 1080p 60.
Crop options allow you to crop pixels from all borders in case the media file has extra margins.
Enter the resolution. It is the resolution of the destination the content is streamed at.
Select the Scaling ratio. 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 Sharable Option When the source is used for streaming content, and the Sharable option is enabled, the server generates one source instance and shares it across applications. For example, if you create 2 sources with the same parameters and map the sources to the canvas/ mapping group, the server only creates 1 running instance of the sources. This helps in resource utilization.
Permissions Tab
Select the Apps to share the source with.
Select or Create a Tag for easy access to the Source. To create a Tag, click on the Tag drop-down menu. A cursor appears. Enter the name of the Tag and press the Enter key. The Tag gets created. Tags help sort the source when there are multiple sources.
Enable User Permissions for the source. These user permissions are set using the Clearance Level feature. Use the Page navigation feature to view other permissions.
Click . The source appears in the Sources panel.
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 more uncommon media types, or launching LibreOffice to display documents and presentations.
Note:
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 the Program Runner. Linux administration experience is strongly recommended before using this source.
In your Userful Infinity account, navigate to Sources and Destinations > Sources.
Click Create Source at the top right corner. A panel appears.
Add a name and description for your Source.
Add tags to find the Source easily later when you need it.
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. It is the resolution of the destination the content is streamed at.
Select Scaling. 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 to make the entire image 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 Source sharing if you want. When the source is used for streaming content, and the Source sharing is enabled, the server generates one source instance and shares it across applications. For example, if you create 2 sources with the same parameters and map the sources to the canvas/ mapping group, the server only creates 1 running instance of the sources. This helps in resource utilization.
To share the Source and add permissions, go to the next step. Else, click Save.
Click the Permissions Tab.
Select the apps in which you want to make the Source available.
Select the users who should have access to the Source.
Click Save.
From Userful Infinity version 12.9, Media Sources (previously Video and Images Source) can include audio, video and image files.
Click on the Create Source option. The Create Source menu appears.
Enter the Name and Description.
Select the Source Type as Media Source.
uClients: .gif, .png, .ppm, .tif, .tiff, .jpe, .jpg, .jpeg, .webp.
Web OS: .png, .ppm, .tif, .tiff, .jpe, .jpg, .jpeg, .webp. Supported audio formats (Audio files are supported from Userful Infinity version 12.9) .mp3, .opus, .ogg, .flac, .alaw, .mulaw
Select a thumbnail.
Enter the interval value in the Slideshow interval(s) field. Its default value is 5 seconds.
Enable Software Decoder (available from version 12.9).
A software decoder uses more CPU resources and a hardware decoder uses more GPU resources. If you have issues with your hardware decoder, you can enable this option and use a software decoder instead.
Enter the resolution. It is the resolution of the destination the content is streamed at.
Select the Scaling ratio. 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 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 Sharable Option When the source is used for streaming content, and the Sharable option is enabled, the server generates one source instance and shares it across applications. For example, if you create 2 sources with the same parameters and map the sources to the canvas/ mapping group, the server only creates 1 running instance of the sources. This helps in resource utilization.
Permissions Tab
Select the Apps to share the source with.
Select or Create a Tag for easy access to the Source. To create a Tag, click on the Tag drop-down menu. A cursor appears. Enter the name of the Tag and press the Enter key. The Tag gets created. Tags help sort the source when there are multiple sources.
Enable User Permissions for the source. These user permissions are set using the Clearance Level feature. Use the Page navigation feature to view other permissions.
Troubleshooting: White screen after mapping a Source
HDMI
HDMI input connected to a server capture card.
Decisions
Artistic
Media
Audio, video and image files
Decisions
Artistic
Network streamer
Network streams supporting RTSP, HTTPS and HTTP protocols
Decisions
Program runner
Linux programs
Decisions
Trends
Artistic
Remote desktop
Windows remote desktop sessions
Decisions
Trends
Artistic
VNC viewer
Desktop streaming using the VNC protocol
Decisions
Trends
Artistic
Spaces Screencast
Cast your screen into a specific inset in Decisions as in a meeting
Decisions
Web Browser
Web pages with a URL
Decisions
Trends
Artistic
YouTube
YouTube videos
Decisions
Artistic
Epic
Time charts and bed occupancy rates that come with Epic systems integration.
Decisions
Trends
Power BI
Dashboards that come with Power BI integration
Decisions
Trends
Tableau
Dashboards that come with Tableau integration
Decisions
Trends
It is an end-point on which content is displayed. It can range from a single display to multiple displays arranged and calibrated to stream content. The Destinations screen lists all the connected clients.
The App Permissions column shows the application icons to which the destination has access. Modify this access by clicking on the three-dot menu > Settings option. The Settings menu appears, showing the list of applications. Select/ deselect the applications and click Save Changes.
Refer to the Manage Video Wall article to learn how to create and calibrate a video wall.
Each destination has an ID (a number) that helps you identify it.
To view destination IDs on display screens:
In your Userful account, navigate to Sources & Destinations.
In the left pane, click Destinations.
Select one or more destinations.
Click the Actions drop-down menu at the top.
Select Show ID. The IDs will be displayed on the selected Destinations.
Alternatively, click the three-dot menu on individual Destination cards within each app and select Show ID.
Note: Starting from version 12.9, Destinations are searchable using Display IDs or Destination names.
An asset is a piece of content that a source can play. This can include media files and web links. You can either upload an asset or create one.
In your Userful Infinity account, navigate to Sources and Destinations.
Click Assets in the left pane.
Click Upload Files at the top right corner. Note: If you have special characters in the names of files you add in the Video Wall Asset Processor, it will throw an error. Please remove special characters from the name of the file and add it again to overcome this issue.
Drag and drop your file or select a file and click Open in your local window.
Click Upload File option.
In your Userful Infinity account, navigate to Sources and Destinations.
Click Assets in the left pane.
Click Create Asset at the top right corner.
Enter the Asset Name and Description. Note: If you have special characters in the names of files you add in the Video Wall Asset Processor, it will throw an error. Please avoid special characters in the names of assets.
Select the Asset Type. Media File: Enter a valid file path. URL: Enter a valid URL.
Select the apps to which you want to make this Source available.
Click Save changes.
A video wall comprises multiple screens that facilitate viewing content on a larger canvas for better visualization. The Video Wall Asset Processor helps chop content and enables neat composition on the video wall with local playback utilizing Userful’s uClient players. The asset file created through this feature is added as a source to the uClient Players mapping group for forwarding the processed files and local playback in video wall mode.
Navigate to the Video Wall Asset Processor in the left-hand side menu.
Select the GPU. It is recommended to use a secondary GPU if available since asset processing utilizes GPU resources.
Select the asset(s) to process. Only image and video files should be selected. Image files are processed and converted into a video file. Note: If you have special characters in the names of files you add in the Video Wall Asset Processor, it will throw an error. Please remove special characters from the name of the file and add it again to overcome this issue.
Enter the Image Duration(s) value. It is the time duration of the video for the processed images in seconds. It is only applicable to image asset format files. Its default value is 30, and the minimum and maximum value ranges from 3 to 3600 seconds.
Select the video wall destination.
Click Start Process. A notification to confirm process initiation appears.
Navigate to Artistic application > uClient Players mapping group.
Create a Source
Click on the Create Source option. The Create Source menu appears.
Source Setting Tab
Enter the Name and Description.
Select the Source Type as Videos and Images Source.
Advanced Tab
Enter the resolution. It is the resolution of the video wall. Note that Scaling does not take effect since the processed asset is processed for the video wall.
Permissions Tab
Assign a Tag to the source for easy identification. To create a new 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.
Optional- Assign user permissions to the selected user roles.
Switch to the Destinations panel and drag and drop the destination to the mapping group.
After a brief while, the content streams on the video wall destination.
All video wall destinations should always be online for streaming content. If destinations are unmapped from the server or the video wall, please remap the destination to the mapping group to restart playback.
Please process the asset file before assigning it to the mapping group if any changes are made to the video wall geometry.
Click . The source appears in the Sources panel.
Click . The source appears in the Sources panel.
Upload a file or browse one from your computer. You can simply drag and drop a file from your computer in the Add File box for a quick upload. Click on the option, and the file gets uploaded. To upload multiple files Click on the option. A drop-down menu showcasing the uploaded files appears. Click on the files, and it gets added to the Playlist. Click on the option to remove the file from the playlist.
Click . The source appears in the Sources panel.
Click . The source appears in the Sources panel.
Click . The source appears in the Sources panel.
Click . The source appears in the Sources panel.
On the destination card, the Warning icon denotes that the destination is currently streaming content. Hover over the icon for more details. Please re-assign only after due diligence, as reassigning content stops the playback of the previous mapping.
Click on the Start Process option. The platform initiates asset processing and chops the content per the geometry of the screens in the video wall. This process can take a few minutes based on the quantity and type of assets selected once the process completion notification appears after successful asset processing. Note- The media files are processed separately for each video wall geometry. Every processed file is listed in the Finished Processes list.
Click on the View Assets option. The Processor Asset List appears.
Click on the Add Assets option. The list of assets appears.
Select the processed asset files. Click on the option to close the asset list.
Click .