Web Folder

8 min

Web Folder Setup (formerly known as Simple File Networking) allows you to publish content to a player from an internal or external HTTP/web server. This server is the dedicated storage location for your presentation files, which the player then downloads via HTTP and plays. Setting up an HTTP server can be complex and BrightSign does not provide support for it. You may need to seek professional assistance or managed hosting services that handle server set up and maintenance.

How do I play a different presentation on each player?

To play a different presentation on each player, make sure that they each refer to a unique URL.

My presentation schedule is not downloading

To ensure that your players can download presentation schedules successfully, make sure that your web server has the following MIME type definitions declared.

MIME Type Definitions

These definitions should be added, because they are usually not predefined:

File extension	Type Definition	Purpose
.rok	application/octet-stream	Firmware update for legacy Series 0 (HDx10) players
.bsfw	application/octet-stream	Firmware update for Series 1 and newer BrightSign players
. (no file extension)	application/octet-stream	Asset pool files
.brs	text/plain	BrightScript files - autorun, plugins, etc

These MIME types are usually already defined, but should be added if they are not:

File extension	Type Definition	Purpose
.json	application/json	Data files for player operation
.xml	text/xml	Sync specification files for player operation

Can I use cloud services for Web Folder publishing?

Dropbox, Google Drive, OneDrive and other similar cloud services can not be used for Web Folder publishing due to current authentication implementations.

How can I troubleshoot my Web Folder Setup?

Before troubleshooting the Setup or network, publish a test presentation directly to the player via a microSD card and verify that it displays properly.

When a player connects to your web server:

It checks for a current-sync.json file (if you are running BrightSign Author) or a current-sync.xml file (if you are running BrightAuthor Classic) and downloads it.

It downloads all files listed in the current-sync.json/current-sync.xml file that are not already on local storage, including schedule, playlists, and media files.

It plays presentations according to the downloaded schedule.

My display is blank/presentations don't update

If your display is blank or the player hasn’t switched to the latest scheduled presentation, check the following:

The storage device (e.g., microSD card) must remain installed / attached to the player for it to play any presentations. With the Web Folder setup, content is not streamed from the Web Folder. Rather, content is retrieved / downloaded from the Web Folder to the player's storage device and played from the storage device.

When publishing your first presentation or any updated presentations, you must select Web Folder after selecting the Publish tab. Verify that Web Folder is selected and that your Web Folder URL matches the URL you used when setting up the player.

Test the web folder URL from your web browser. If your computer is also the web server, test the link from another computer. Assuming your server is http://www.mysite.com/downloads/, test the following (you can get the pool folder URL from the current-sync.json or current-sync.xml file):

http://www.mysite.com/downloads/current-sync.json or current-sync.xml

http://www.mysite.com/downloads/autorun.brs (to confirm that your MIME types are set up correctly)

http://www.mysite.com/downloads//pool/sha1-6963EC2B20954C48716E9CEF96FC11F53DA3BBAA (to confirm that your MIME types are set up correctly) Your web browser should be able to open/download the files from your web server using HTTP or HTTPS URLs. Check that you have enabled the MIME types if these files are not accessible.

If you are using BrightAuthor Classic:

Go to Tools > Setup Unit, and confirm that Simple File Networking (the BrightAuthor Classic name for Web Folder) was enabled for the Setup files you created.

In the same location, check that the URL for the web folder is correct and that it includes the correct port number for the web server, if applicable.

If you haven't already done so, publish the Setup files to a microSD card and insert the microSD card into the player.

Including a trailing slash in your URL may cause downloads to fail because BrightAuthor Classic automatically adds a slash to URLs. Some web servers don’t process URLs with a double slash. For example, if you originally entered http://www.myfiles.com/downloads/ as the URL for Web Folder, try http://www.myfiles.com/downloads instead.

If you are using FTP to transfer the published files to your web server, verify that your FTP software is set to transfer using binary mode, and not auto or ASCII mode. Files may fail to download from your server if they are transferred using ASCII mode.

When a player encounters errors when downloading files, it will not restart and play the new content and the errors will not be displayed on the screen. You may encounter errors if you moved or renamed files in the web folder after you published the presentation, or if the files you uploaded were changed by the transfer process. To view an error log, you can connect the player to your computer using a serial cable or, if you checked Enable diagnostic logging during player set up, retrieve the log file from the microSD card.

If your project is scheduled to play all day every day, your project will play even if the player has no valid time set or if the time or time zone is incorrect. However, if you are using day parting (i.e., playing different presentations depending on the time or day), then nothing will play if the time isn’t valid.

Verify that the player has the correct time and that it can connect to the network. You can do this by creating a simple project that displays the time (via a Clock zone) and an RSS feed. If the player can connect to both the network and the Internet, you will see the RSS feed, and if you can reach the time server, you will see the time.

If UDP port 123 is blocked on the network, the player won't be able to set the time over the Internet.

If the player fails to resolve the name of the web server, then it will fail to download the current-sync.json/current-sync.xml file. If your server URL is something like http://myserver/brightsign/downloads, then you may need to add the domain to the server name for updates to function properly: http://myserver.universityshop.net/brightsign/downloads

How do I set up my player/publish content?

Once your HTTP server is ready, see Web Folder Setup to set up your player or Quick Publish to publish content.