THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. Original Author: Jeffrey Nygaard Company: Northern Lights Electronic Design, LLC Date: March 7, 2022 Software Version: 3.1.2 Contact: JNygaard@NLEDshop.com Written in Javascript, NodeJS, and Electron JS Tested OS Support: Windows 10, Windows 7, Mac OS(High Sierra 10.13.6, Mac Mini 2011), Linux(Unbuntu 18.04.4 LTS) Copyright© 2022 by Northern Lights Electronic Design, LLC. All Rights Reserved ============== www.NLEDShop.com/nledaurora ============= ============= www.NorthernLightsElectronicDesign.com ============ Please contact us with any bug reports, issues or feature requests. support@NLEDshop.com This software was created by a lone developer. Any and all help or comments(good or bad) are appreciated. Need a customized device that runs NLED Auora Magician? We are avaialable for custom design work please contact sales@NLEDshop.com Please read the included PDF manual for additional details on how to use the software. Aurora version 1 and 2 save files(.auroraseq and .txt) are compatible, but some data nually convert imay be lost so please check all settings and sequences. If your save file errors, please send the file to support@NLEDshop.com and we will mat and provide an updated file. If your controller is listed, all updates for NLED hardware and controllers visit: https://www.nledshop.com/deviceupdates/ Supported Controllers(requires minimum firmware version): NLED Pixel Controller Electron - firmware v.2h NLED Pixel Controller Ion - firmware v.2h NLED 30 Channel High Current Controller - firmware v.2e NLED Pixel Controller Proton - firmware v.2a NLED Pixel Controller Quark - firmware v.2b NLED Pixel Controller Photon - firmwarev.2a Not Yet Supported: 16-Bit Lamp Controller NLED Four Channel Mini NLED 4 Channel Wash Controller NLED Quad Constant Current Controller NLED WPIXDMX Many more to be added, contact for details For documents, updates, video tutorials. Please visit https://www.NLEDShop.com/nledaurora Please visit https://www.nledshop.com/nledpatcher/ to get the software for creating pixel map files for use with Aurora Please visit https://www.nledshop.com/nledallpixmatrix/ for software to make content/videos for low-resolution LED matrices ================================================== HOT KEYS ============================================================= ctrl+s - quick save to the "Save As" target file ctrl+z - undo action - Note: does not work with all actions yet. ctrl+y - redo action escape - closes overlay menus, message log, selects the 'no' option in the confirm menu enter - 'applies' color picker, closes message terminal, ends tool actions, enters values into text boxes Hold shift and mouse wheel to scroll side over the frame buttons *On MacOS the 'cmd' key is used instead of 'ctrl' ============================================ NOTICE ======================================================== This application connects to the internet to retrieve version information for software and NLED devices. No user data of any kind is collected or shared with anyone. This application generates log files to the program directory to the /logs folder. Logs are only stored on the local machine and are not shared. Formatted: log-hour-minute-second-day-month-year.txt If this folder gets too large, log files can be deleted. Do not delete the folder /logs. If you have a bug or issue to report, please provide the log file(s) by email. ============================================ MAJOR TODO ======================================================== Localization, Spanish will be added and fully supported. Other languages may also be supported in the way future. All NLED device support. Including 16-bit color data. Video based POV(Point of Vision) sequences. Need to work out lossless codec video loading in HTML5(if anyone has any tips) More accessibility settings. More advanced sequence effects that are applied over the current sequence format. Example: Sparkle, breathe, masking, sawtooth, sine, etc. Device simulation. Use the software and create files for a specific NLED device without it connected. 3D Pixel Mapping/Patching ============================================ INSTALL INSTRUCTIONS ======================================================== Windows 7 and Windows 10 Install: (32-bit or 64-bit) ---------------------------------------------------------------------- Note: Only offering 32-bit version but it also works on 64-bit windows. Note: This program may warn of being form an unknown developer as there is no security cert. 1. Open the ZIP file and extract the 'nled-aurora-300' folder. Place it where ever you want. No install required, runs from folder. 2. Open folder and run "nled-aurora.exe" - no actual installation is required, it runs from the folder. 3. Some devices may require additional installation of drivers. See other documenation or search online. 3a. Windows 10 can find the drivers online, no other user actions should be required. 3b. Windows 7 or other versions may require driver install, the driver files are found in the Aurora folder /drivers 4. For convience a short cut to the executable can be to the start menu or to your desktop. Right click the .exe file and create a shortcut. MacOS Install: (El Capitan or newer, tested on High Sierra) -------------------------------------------------------------------- 5/10/2020: MacOS applications may not work if you download the software(ZIP) directly to the Mac from the internet. Probably has to do with security being and 'unidentifed developer'. Along with not distrubuting through the app store. If the software opens and the window is grey and unresponsive, or prompts about an unidentified developer this is the problem. See the below workarounds, option#1 is easy and should *work* Please contact jnygaard@NLEDshop.com if you know what the issue is and if there are any solutions. Work Arounds: Option 1. Download the software to the mac, unzip, right click the 'nled-aurora' app, navigate to contents/macOS, then click 'nled-aurora'. The software should start without errors. If that does not work, check System Prefrences -> Security & Privacy -> General -> Check app settings Option 2. Download software to a PC and then transfer to the Mac over network or flash drive. Then launch the app normally. Install: 1. Open the ZIP file and extract the 'nled-aurora-300' folder. Place it where ever you want. No install required, runs from folder. 2. Run 'nled-aurora' application - no actual installation is required, it runs from the folder 3. MacOS may not allow the app to be ran since it was downloaded from the internet from an 'unidentified developer' 4a. Search online for work arounds. Look for "Allow apps downloaded from:" under Security and Privacy 4b. If the software launches and shows a grey screen, or no text. It is the downloaded file security issue described above. 4c. Or if you can't or won't try those solutions, use Windows or Linux versions instead. 4d. Easiest way is to follow work around described above, option #1 is easiest. Linux Install And Run: (32-bit or 64-bit) ------------------------------------------------------------------------------------ Note: You must use the correct 32-bit or 64-bit version. Or not all functions will work correctly. 1. Extract ZIP file to any file location. 2. Open Terminal and navigate to folder location using "cd extracted-folder-path" Ex: cd /home/owner/Downloads/nled-aurora-linux-x64-v300 3. Once terminal is in the folder, launch the app with "./nled-aurora" 4. If terminal indicates permissioned denied. Run "sudo chmod u+x nled-aurora" 5. Device drivers should be included with the kernel and do not require installation. But your Linux OS may require permissions to access the USB based serial port. NOTE: On some linux distros(Unbuntu 18.04.4 LTS for sure) the controller must be plugged in before launching software. If not the USB device will be listed but won't be able to connect. But still may be listed and may say "Serial Port In Use" A: If software does not connect to the serial ports("Serial Port In Use" message) close and launch with "sudo ./nled-aurora" B: If software still does not connect to serial port: Run command "sudo chmod a+rw /dev/ttyUSB0" or "sudo chmod a+rw /dev/ttyACM0" Change "USB0"/"ACM0" to whatever the assigned name of the device serial port. Run "dmesg | grep tty" for serial port listing That command requires being run everytime the OS boots up. Otherwise add to group permissions, check online. C: In software, ignore all the serial port buttons except the top ones with in "ACM" or USB" in the name.