Documentsassets

Assets

The assets tab is where you can upload your content.

PiSignage handles content of multiple types from images, videos to even complex livestreams, HTML pages, web-links, etc. All of your content is managed in the assets pane with the ability to configure category filters, folder views, validity and more.

Pasted image

Adding an asset

Adding an asset is as simple as dragging and dropping your assets from your file system to the assets page. Alternatively you can click on the + Add Asset button at the top of the assets page.

Pasted imageYou will see individual tiles to upload every type of asset. Choose the appropriate tile to begin adding the same. Bulk Upload is a great option if you want to select multiple files of varying types and upload them at once.

Step 1 → Choosing an Asset Types

This section covers the various types of assets available in PiSignage.

If there is an asset type that you do not see here but would like us to support please write to support@pisignage.com.

Bulk upload

Bulk upload lets you upload files and documents of various types from your filesystem directly to PiSignage.

Pasted imagePress shift + click or cntrl/cmd + click to select your assets before uploading them. You could alternatively drag and drop your assets to the main window.

There is a 3GB limit per upload

Image

Upload and display image files. Supports common formats like JPG, PNG, GIF, and SVG.

Pasted imageYou can upload multiple images at once as well.

Some formats like HEIF, WebP may need to be converted to optimize performance on other hardware

Video

Upload and play video files. Supports common formats like MP4, WebM, and AVI.

Pasted imageYou can upload multiple videos at once as well.

All videos are converted to MP4 to optimize for all hardware

Audio

Upload and play audio files. Supports common formats like MP3, WAV, and OGG.

Pasted image

Document / HTML

Upload and display document/HTML files. Supports PDF, DOC, DOCX, TXT, and HTML formats.

Pasted imagePiSignage can handle and render HTML files as interactive pages. You can either choose to upload an

  1. Individual HTML file

  2. Or a HTML based project folder as a .ZIP file. Please ensure that this folder contains an index.html file for the platform to know what to render first.

PDF

Upload and display pdf files. Supports the standard PDF format (single or multi-page).Pasted image

Message

Create custom text messages with optional styling. Perfect for announcements or information displays.

Pasted imageIt renders on a TV as shown below. You can choose to also add optional CSS value to style it as needed.

Pasted image

Notice

Create notices with title, body text, and optional image. Ideal for important announcements or alerts.

Pasted imageIt renders on a TV as shown below. You can choose to also add optional CSS value to style it as needed.

Pasted image

Embeddable web page shown in an iframe. Use this for simple web content that doesn't require CORS support.

Pasted imageTo check if your link works as a weblink or if it needs a webpage look for the preview to determine the same. if you see a red screen it indicates that you may need to use the webpage asset type for your link instead of the weblink type asset.Pasted image

Webpage

Opens a new browser window for web content. Best for pages that require CORS support or need full browser capabilities.

Pasted imageYou will also see several options in this asset type

  1. Zoom Level: Adjust your zoom level by changing the multiplier. eg: 1.2 is 1.2x the zoom level

  2. Send keystrokes: Configure a set of keys to be pressed automatically as the page loads. Simply type the keystroke value as indicated in https://developer.mozilla.org/en-US/docs/Web/API/UI\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\Events/Keyboard\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\event\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\key\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\values with , to seperate the same

  3. Delay for sending keystrokes: Choose the number of seconds before the keystroke values configured in (2) are sent. Great when you want to ensure the page fully loads, etc.

  4. Auto Scroll: Auto scrolls until the end of the page

  5. Optional headers: Use this if you have authorisation, prefills, values, etc that need be sent via the URL header

Weblinks vs Webpages → An explanation

Weblinks are links opened in iframe that is embeded in the current instance of the browser. This would make it fairly gapless with the previous content and reduce load time.

Webpages on the other hand open a new window in a new browser instance and load the page which while more powerful does impact how seamless all of it is.

Livestream

Display live video content from YouTube or other streaming services. Perfect for real-time broadcasts.

Any stream can be played as long as it follows the RTSP protocol (reference: https://developer.mozilla.org/en-US/docs/Glossary/RTSP)

Pasted image

Audio Stream

Stream live audio content from internet radio stations or other audio streaming sources.

PROTIP: Its a great source especially when you want this audio playing in the background as defined in Playlists 

Pasted image

Local Files and folders

Access and display files from a local folder on the Pi device. Useful for offline content. This is great especially when you have a large set of files to choose from and you do not want to transfer them via the internet to save on data transfer charges.

Pasted image

Apps and integrations

We do have a wide array of apps and integrations which can help bring your content from elsewhere straight to your screen.

Pasted image

Media RSS

Display dynamic content from Media RSS feeds. Great for automatically updating content like news, images, or announcements.

Pasted imageYou will also see several options in this asset type

  1. Media RSS link: The RSS link available on most websites and News Sources

  2. RSS Type: Choose what you would like to load from the RSS

  3. Number of Items: How many items would you like to load. This loads the items by most recent.

  4. Duration: Duration that each item will show

  5. Optional CSS: CSS to alter the styling of the asset

Below is an example of how this asset shows with Image + title selected and the Wired, Culture RSS feed.

Pasted image

Power Bi

To Show your Power BI dashboard, Some setup actions need to be done in Azure Portal and Power BI Admin Portal.

Ensure you are using the same user account on both to login. An Entra app has to be set up in Azure Portal as the service principal. Then, an app secret must be created for the same app. The user account of PowerBI must have Power Administrator rights.

The account needs to enable service principal access to Fabric APIs (no Fabric license necessary, only PowerBI license will do) in the Power BI admin portal.

Add or create PowerBI reports in a Power BI Workspace. Add Entra app in the Power BI workspace "Manage Access" area.

Get the Workspace ID and Report ID from the URL of the Power BI report/dashboard.

https://learn.microsoft.com/en-us/power-bi/developer/embedded/embed-sample-for-customers?tabs=node-js is a great resource to refer to.

Pasted imageYou can then proceed to fill in each of the field values by clicking the ‘i’ icon to know where to fetch the value from.

Pasted image

Canva

On Canva create a public view link and use the same link to create your asset.

This is a variant of the Webpage asset type as Canva links require CORS support

Pasted imagePasted imageOnce you create the link, paste the same in the dialog.

Pasted image

Google Slides

You need to publish your slideshow to share slideshows from Google Slides, please click on

File > Share > Publish to the web

Pasted imagePasted imageOnce you click publish you should receive the link.
Pasted imageOnce published use the link generated here to use the Google slideshow.

PS: All settings on duration per slide, transitions, etc are handled by google slides and have to be configured on the platformPasted image

Youtube

To add a youtube video just copy the share link in the video and paste the same in PiSignage.

Do make sure to use the share link and NOT the URL from your browser

Pasted imagePasted image

Google Sheets

Display Google Sheets in your digital signage. Perfect for showing dynamic data, schedules, or any spreadsheet-based content.

You need to publish your Spreadsheet to share Sheets from Google Sheets, please click on

File > Share > Publish to the web

Pasted imagePasted imageOnce you click publish you should receive the link.

Pasted imageOnce published use the link generated here to use the Google Sheets.

PS: All settings are handled by google sheets and have to be configured on the platform

Pasted image

Instagram

Display Instagram feeds or posts in your digital signage. Great for showing social media content and keeping your displays fresh.

Pasted image

Twitter/X

Display Twitter/X feeds or posts in your digital signage. Perfect for showing social media updates and real-time content.

Pasted image

Facebook

Display Facebook pages or posts in your digital signage. Great for showing social media content and community engagement.

Pasted image

Appstore (Coming soon)

Step 2 → Assigning validity and categories

Once you upload your asset you should see a dialog to help add categories and validity to your uploaded asset(s).

Categories

Categories are tags that help organise and categorise your assets. They are present throughout the platform (even in playlists, groups, etc) to help categorise everything. Adding categories is as simple as clicking the relevant category to apply the same.

Pasted imageYou can find more information on categories in the Categories page.

Add and manage categories

You can add, edit or delete categories by clicking on the manage categories button

Pasted imageThis should open the Manage category menu.

Pasted image

Category view

By clicking on folders, you can view your assets as organized by the category they belong to. Categories is a great way to organise and filter through your assets.

Pasted imagePasted image

Validity

Validity is used to determine if the asset is fit to play. By default all assets have no validity assigned to them. However if you assign either a start date or end date then the asset will not play on any date/time outside of the validity period.

This is a great option for limited time offers, etc.

Pasted imageValidity also appears in the asset list with tags to help identify what has expired, valid, etc

Pasted imageThe example above is of an expired asset.


Renaming an asset

To rename an asset click on the pencil icon

Pasted imageOnce you click the same, all asset names will become editable. Click on the check icon to save your changes or the ‘x’ icon to discard them.Pasted image

Search and filter

Click on the search icon to filter through your assets

Pasted image

Sort

You can sort your assets in any order by toggling the sort options

Pasted image

Filter

Filter through your assets by opening the filter dialog by clicking on the filers. You can choose any combination of filters below:

  1. Asset type

  2. Validity

  3. Categories

Pasted image

Views

The assets page has 3 distinct views accessible in the 3 tabs below.

Pasted image

Table view

All assets as a table to get the maximum amount of information on any asset.

Pasted image

Grid view

All assets can be viewed as tiles. Great when you rely on the asset preview

Pasted image

Folder view

Here the assets are grouped together by categories into folders. This is great for a more native file manager view.

Asset actions

Each asset has a few actions associated with the same.

Pasted imageView asset

Click on the 👁️ icon to view the asset, with both a preview and details on the asset specifications.

Pasted image

Add to playlist

Add an asset directly to your favourite playlist. You have two options

  1. Purge & add: clears the entire playlist and adds the asset as the only asset in the playlist

  2. Add to end: Adds the asset with default values to the end of the playlist

You can add an asset directly into a playlist as indicated in Playlists 

Pasted image

Download

Downloads the asset to your system

Pasted image

Delete

Deletes the asset permanently from your account.

Pasted image

Storage per account

Pasted imageIn PiSignage we add 1GB of storage per player license active. i.e if you have 10 active players, your account storage is 10GB. You can always choose to expand your storage by following the instructions present in Subscriptions and Licenses .