Publishing
This page / section pertains to BrightAuthor Classic, our legacy app. BrightSign Author is our latest app for managing content and players.
Development of BrightAuthor Classic has largely ceased and the app will eventually be deprecated and replaced with BrightSign Author.
Got “Unable to access a BrightSign at that IP address" in BA Classic?
If you get this message when attempting to publish to a Local File Networking player in BrightAuthor Classic, see the following possible reasons:
- The player has not been, or is no longer, configured for Local File Networking usage. To resolve this, apply new Local File Networking setup files to the player:
- For Series 3 (models ending in 3) and newer players, clear the content of the player's storage device
- Otherwise, write new setup files to the player's storage from BrightAuthor Classic (Tool > Setup BrightSign Unit) or deliver setup files to the player via the DWS.
- You're using DHCP addressing without an address reservation for the player and the router, or the DHCP server rebooted or changed the player address. To resolve this:
- Power up the player without storage to determine the current IP address from the information screen it displays.
- Replace the storage and reboot the player after you have noted the current IP address.
- Refresh the Networked Units list to see if you get a new/updated player entry.
- Add the player's new IP address to the Networked Units list.
- Definitely consider adding an address reservation to the DHCP server so the player's address is predictable
- The published presentation or content has put the player into a reboot loop. To resolve this:
- The easiest way to bring a player out of a reboot loop is to apply Setup files to the player's storage again. This will clear the player's presentation schedule so the presentation won't run and crash the player again. If you cannot physically access the player, you can still recover if the Diagnostic Web Server (DWS) is accessible:
- Keep trying to Disable Autorun from the Diagnostics tab of the player's local DWS (http://playerIPaddress/index.html - replace playerIPaddress with the player's LAN IP address) or remote DWS (from http://BSN.cloud or BrightAuthor:connected) until you get a response from the player.
- After you see the response, the player will reboot with the autorun disabled.
- Use the method described in this page to create, package, and deliver a new set of player setup files to the player. After setup is applied you should be able to publish to the player again.
- Check your presentation for invalid data feeds, out-of-spec media, and resource-hungry HTML sites before publishing again.
- Try updating the player firmware/OS.
- The player's storage device has been removed or is not readable. To resolve this, put the player's storage device in a PC and see if it can be recovered. Replace the storage device and write new Local File Networking configuration files to it via BrightAuthor Classic's Tools > Setup BrightSign Unit.
- The player has been disconnected from the network or power. To fix this, plug the player back in.
- Network access to the player on ports 80, 8008, and/or 8080 is blocked. To resolve this:
- Consult with IT to ensure the computer that BrightAuthor Classic is installed on can communicate with the player.
- See if you can open http://playerIPaddress:8080/GetID (replace playerIPaddress with the player's LAN IP address) from a web browser on the same network as the player.
- Access to ports 80, 8008, and/or 8080 is blocked. To resolve this:
- Consult with IT to ensure the the computer that BrightAuthor Classic is installed on can communicate with the player.
- Check any third-party antivirus / firewall / security software.
Why doesn’t my published presentation display?
If you're getting a blank screen after you publish your presentation and start up the player, you're most likely experiencing a problem either with your content or with the video resolution that the published project is set to.
- Check the Screen resolution of your project in File > Presentation Properties > Main. Some resolutions only work over HDMI or over VGA. If, for example, you set the resolution to 1920x1080, but your player is connected using VGA, you will not see anything on the display.
- Determine whether the Force Resolution option is enabled in File > Presentation Properties > Main (in BrightAuthor Classic 4.3 and later). When the Force Resolution option is enabled, the display will be blank if it doesn't support the specified Screen resolution. When this option is disabled, the player will negotiate with the monitor to find a supported video mode if the monitor doesn't support the specified Screen resolution.
- Check if the red error light is blinking. If it is, count the number of times it flashes. If the red error light flashes 10 times with your published project, it normally means that the published project tried to do something that the player doesn't support. See this page for a full description of error light codes.
- Determine if your project requires an Internet connection. For example, if you publish a project that only displays an RSS feed, MRSS feed, or Signchannel, and the player is unable to connect to the Internet, then the screen will be blank.
- If you are testing a synchronization or BrightWall project, and the master player does not have an Ethernet link, it may fail to start playback. Verify that the master player is connected via Ethernet and has a network connection. If you need to test the project without an Ethernet connection, publish a new copy without synchronization.
Why does the player keep rebooting after I publish my presentation?
If the player suddenly goes into a reboot loop after publishing a new presentation, most likely something in the presentation is causing the crash:
- The player's OS / firmware may be incompatible with your version of BrightAuthor:connected or BrightAuthor Classic. Upgrade the player to at least the minimum compatible OS / firmware version:
- In BrightAuthor:connected, see BrightSignOS Update in the Advanced tab of the Access the Remote DWS.
- In BrightAuthor Classic, do this in Device Setup via Specify Firmware Update, or when publishing the presentation schedule via Specify Firmware Update.
- Make sure that the data feed is an actual RSS/MRSS or simple XML structure, not a HTML page, image, or some other kind of content
- Make sure that your plugin (.brs) is not corrupt or invalid (you've downloaded the plaintext BrightScript .brs and not the HTML page). For Github downloads, you should be clicking the Raw link on the fancy source code view page.
- Note that when presentations change screen resolutions (e.g. from 1280x720x60p to 1024x768x60p), the player will reboot.
To fix this:
- BrightSign Network or Simple File Networking / Web Folder: Publish a working presentation and either wait for the player to update or reboot it manually.
- Standalone:
- Retrieve the player's storage device.
- Publish a working presentation to it.
- Replace the storage device in the player.
- Reboot the player.
- Local File Networking: Reapply player setup files to the player's storage to clear the player's presentation schedule so it won't run and crash the player again.
- If you cannot physically access the player, you can still recover as long as the Diagnostic Web Server is accessible.Keep trying to hit http://{{playerIPaddress}}/action.html?reboot=Reboot&disable=autorun (replace {{playerIPaddress}} with the player's LAN IP address) from a web browser until you get a response from the player.
- After you see the response, the player will reboot with the autorun disabled, then you can use the method described in Edit Player Network Settings to create, package, and deliver a new set of player setup files. After the new setup is applied you should be able to publish to the player again.
Why can’t BrightAuthor Classic find my files when I publish my presentation?
If you copy a presentation project from one computer to another, or move or rename files used in a project, BrightAuthor Classic cannot find the files and will produce an error when you try to publish. To resolve the error, you must remove the files from each zone’s playlist in the presentation and then add them again.
Why do I get an error when I try to publish my presentation?
Try the following:
- Publish to a local folder instead of a microSD card or network location.
- Try a different microSD card to verify that the card isn’t write protected.
- Confirm that the files in the media library are still present and haven’t been moved or renamed.
- Erase all files from your flash card and publish again.
If the problem still exists, try to duplicate it and then exit BrightAuthor Classic if it’s open. Locate the eventlog.txt file and forward it to [email protected], along with a description of the problem.
Why doesn’t my schedule work if I use multiple projects?
If scheduling one presentation to play all the time works but setting multiple presentations to play at different times of the day fails, the problem is likely caused by the date, time, or timezone setting on your player. To support day parting, the player needs to be connected to a network with a time server or needs to have a manually configured time:
- See this How-to for details on changing the default time server. If the player still has the incorrect time when connected to the Internet, try the solutions outlined in this FAQ.
- Make sure the player is set to the correct timezone. See this How-to for more details on setting the player time zone.
- If you can't connect the player to a network with a time server, you can manually configure the time on the player. See this How-to for more details.
The LS424 has a real-time clock (RTC) but does not have a supercapacitor to save the configured time after it power cycles. This player model must be able to communicate with a time server to play day-parted presentations reliably.
Why do I get an “Access to [ip address] denied” error when using Local File Networking?
When Access to [ip address] denied (for example, "Access to 10.1.1.10 denied") is reported in the Publish > Local Network tab, it is indicating that the username and password set on the player doesn't match what is expected when trying to access the player. This could be because the device setup process occurred on a different computer or because the computer has been replaced or had a clean OS re-install.
To enter the correct username and password:
- Right-click the "Access to [ip address] denied" item and select Specify Username and Password.
- Enter the username and password used to set up the player.
- If you don't know the username and password, reconfigure the player by performing the setup process again:
- Re-create the setup files for Local Networking under Tools > Setup BrightSign Unit. Don't enter User name and Password for the local web server (you should however enter a username and password for the diagnostic server - see the image below for settings).
- Save the setup files onto a blank SD card and insert the SD card into the player.
- Power up the player
- Go to the Publish tab, select Local Network, tick the Networked units radio button, press '+', and enter the IP address of the unit.
- If the problem persists, retrieve the eventlog.txt file and send it to us (see this FAQ if you are not sure where to find that file).
Why can’t I publish my autoplay.xml file using Local File Networking?
If your Local File Networking publish fails, and the error indicates that the autoplay.xml file could not be published, this may be caused by a corrupted userpreferences.xml file. To fix this problem:
- Clear your BrightAuthor Classic user preferences by deleting all the userpreferences.xml files contained in the %localappdata%\BrightSign\BrightAuthor subfolders, then reopen the app. You'll find the user preferences file in %localappdata%\BrightSign\BrightAuthor (type the address into the location/address bar). You may need to set your computer to show hidden files and folders to find this folder.
- Windows Vista, Windows 7, Windows 8, Windows 8.1, Windows 10 example: C:\Users\myusername\AppData\Local\BrightSign\BrightAuthor\2.0.0.44
- Windows XP example: C:\Documents and Settings\myusername\Local Settings\Application Data\BrightSign\BrightAuthor\2.2.0.37
- Uninstall and re-install BrightAuthor Classic.
- If this does not solve your issue, attempt to publish again and then exit BrightAuthor Classic. Submit a support ticket with the eventlog.txt file (see this FAQ to find that file). Be sure to retrieve the log before relaunching, since the log is rewritten on each boot.
Why isn’t my RSS feed updating or only updating when I publish a new project?
If an RSS/MRSS feed works when you start up the unit or publish a new presentation, but fails to update at other times, the problem is most likely with the RSS update frequency setting.
Go to File > Presentation Properties > Data Feeds and check the Update Interval: It may be set to 12 hours, 24 hours, or even "Once". You can use the dropdown list to shorten the update interval to as little as 30 seconds.
My BSN status is red after downloading an updated schedule
An empty schedule, out of date OS / firmware, corrupt content, unsupported media, or a partially failed download can cause the BSN status to turn red after downloading a scheduled project:
You may have to force a player into Recovery Mode to get it working again (instructions are at the end of this FAQ).
- The player's OS / firmware must be compatible with your version of BrightAuthor Classic. If you've updated to a new version of the app recently, or are publishing to a new player, the player may require a firmware update to support new presentations. To fix this:
- Publish an updated project with a firmware update attached:
- Select Specify Firmware Update in the Publish > BrightSign Network menu
- Select the production or beta version of firmware.
- Force the player into Recovery Mode.
- A corrupt or improperly encoded video can cause the player to continuously reboot before its normal call-in period. To fix this:
- Upload the updated project.
- Enable recovery.
- Check for "failed to download sync list" or other errors under Manage > Status > Info. Occasionally, the player may fail to download the current-sync.xml file after the schedule has been updated. To fix this:
- Try uploading the project to BSN again and republishing it.
- If that fails, rename the project, upload it, and then publish it again.
- Also check if the subscription of the player has expired, leaving it in suspended status.
- Check under Download Progress for files that failed to download. If any files from the last download session failed to download successfully, the player's status will change to red. To fix this:
- Go to Manage > Status, right-click the player, and select Download Progress. This will display the current status of player content downloads.
- Remove the files from the project and upload the project to BSN again.
- Upload problem files again to BSN if those files fail to download repeatedly.
- Check the length of time images are set to play, even if there's only one file in the playlist. Images set to three seconds or less can cause a red status on older BrightAuthor Classic versions. To fix this:
- Under Edit > Preferences, set the default Image timer to four seconds or more (you can edit individual image timers for states in your playlist).
- Publish the updated project.
- Enable recovery.
Forcing Recovery
If the player doesn't appear to be calling in or is in a reboot loop, you can force it to go through the recovery process the next time it boots up. There are two recovery modes: one will reformat the SD card and one will not. When the unit goes through recovery, it downloads the currently published project again, along with the updated schedule. If you choose "no reformat" recovery, then only new content files will be re-downloaded.
- Publish an updated project (including a firmware update if needed).
- Go to the Tools > Advanced menu.
- Click the Control tab.
- Paste or type in the serial number of the player. This number can be found by navigating to Manage > Status, right-clicking the player, and selecting Info--the serial number is listed in the Unit ID field.
- In the Action drop down menu, select Recovery - reformat or Recovery - don't reformat.
- Click Add Action.
- Reboot the player:
- Detach and reattach the power cable.
- Use the Reboot command if you have the Diagnostic server enabled.
- Wait for the unit to restart if it's in a reboot loop.
The player will check for the recovery flag when it powers up, before it tries to play the presentation on the SD card.
Why did BrightAuthor Classic fail to publish or save my project?
This is usually caused by permissions issues. Saving or publishing fails if BrightAuthor Classic can’t write to one or more files.
- If you are publishing to a microSD card, verify that it’s not write protected. For most microSD cards, sliding the notched tab toward the top of the card will disabled copy protection.
- Verify that your computer login has administrator access: Try logging in as administrator or as a different user.
- Quit BrightAuthor Classic and delete the UserPreferences.xml file. Then reopen the app. See the note below to locate the file.
The eventlog.txt and UserPreferences.xml file location for Windows Vista and Windows versions 7, 8, 8.1, 10 and 11 is %localappdata%\\BrightSign\BrightAuthor\version_number. For example:
- C:\Users\John Doe\AppData\Local\BrightSign\BrightAuthor\4.3.0.11 The eventlog.txt and UserPreferences.xml file location for Windows XP is: %appdata%\BrightSign\BrightAuthor\version_number. For example:
- C:\Documents and Settings\John Doe\Local Settings\Application Data\BrightSign\BrightAuthor\3.7.0.11 You may need to set your computer to show hidden files and folders to see this folder.
Why can’t I upload content via Local File Networking?
A known bug affects the upload/transfer of content to the player while publishing a presentation via Local File Networking. This issue affects some users that enabled authentication by entering a password for the Local Web Server via the User name and Password options in Tools > Setup BrightSign Unit > Unit Configuration. Follow these steps to resolve the issue:
- Close BrightAuthor Classic.
- Find and delete the BrightSignUnits.xml file for your BrightAuthor Classic version. The path should be similar to this: C\Users\[User_Name]\AppData\Local\BrightSign\BrightAuthor\[BA_Version_Number]
- Open BrightAuthor Classic.
- Go to Tools > Setup BrightSign Unit to create a new setup card without a password for the Diagnostic Web Server or Local Web Server.
- Insert the new setup card into the player.
- Connect the power cable (or Ethernet cable if using PoE).
- Go to the Publish tab, Select New Unit, select the "+" icon to add the new player IP address, and select OK.
If you don't know the IP address of your player, see this page for help.