Media JSON lets your screens show images and videos from a JSON feed that you host. Point a layer at the feed and the CMS downloads its media and keeps it in sync: when you change the feed, your screens update by themselves, with no uploads. It works like MRSS , with JSON instead of XML.
Use it for content that another system already produces, such as promotions, announcements, menus or product images.
How to Add a Media JSON Feed
- Open the playlist, then click the layer. See Playlist Media Management .
- If the layer is empty, the content apps open. If it already has media, click Add New.
- Click General Apps, then Media JSON. It is also in Video Apps and News Apps.
- In Enter URL, paste the address of your feed. To try it first, use the example feed:
https://files.cloud-digitalsignage.com/media-json/media-json.json - Set Media count: the number of items to take from the feed, from 1 to 50 (20 by default). Items are taken from the top of the feed.
- In Only Sync, choose All Media, Videos Only or Images Only. A new app shows
all, which means all media. - Click Save.
- The CMS downloads the media from the feed and adds the items to the layer. Click Publish changes of this playlist to send them to your screens.
Feed Format
The feed must be a JSON file or API response that is publicly reachable over HTTPS. Media files must be public HTTPS links too.
{
"channel": {
"items": [
{
"title": "Image 1",
"mediaContent": {
"url": "https://files.cloud-digitalsignage.com/mrss/files/1.jpg",
"type": "image/jpeg",
"medium": "image",
"duration": "10",
"changeKey": "a077ae97dfe45af878f0e0fafdc05c85"
}
},
{
"title": "Video 1",
"mediaContent": {
"url": "https://files.cloud-digitalsignage.com/mrss/files/a.mp4",
"type": "video/mp4",
"medium": "video",
"duration": "10",
"changeKey": "f11b8c8d750d2087e0a6c0478840063d"
}
}
]
}
}
Download the example feed: https://files.cloud-digitalsignage.com/media-json/media-json.json
Fields
| Field | Required | Description |
|---|---|---|
channel.items | Yes | The list of media items |
title | Yes | The name of the item |
mediaContent | Yes | The media file details, below |
mediaContent
| Field | Required | Description |
|---|---|---|
url | Yes | Direct HTTPS link to the image or video file |
type | Yes | The file’s MIME type, for example image/jpeg or video/mp4 |
medium | Yes | image or video. Items with any other value are skipped |
duration | Recommended | How long the item plays, in seconds. If it is missing, the item uses the duration set for the app in the CMS |
changeKey | Recommended | A unique value for the file, for example its MD5 hash. Change it whenever you replace a file at the same URL |
How Updates Work
- The feed is checked about every 5 minutes. When the feed has changed, the CMS syncs it again and updates your screens.
- Files are downloaded to cloud storage and then to your screens, so they keep playing offline.
- Items that are already downloaded, with the same
changeKey, are not downloaded again. - If you replace a file but keep its URL, change its
changeKey. Otherwise the screens keep the old file.
Tips
- Use common formats that your screens can play, such as JPG or PNG images and MP4 videos.
- Keep files small and host them on a fast server or CDN.
- Put the items you want to show first at the top of the feed: Media count takes them from the top.
Need help with your feed? Contact the EasySignage support team.