Chandler's Digital Signage feature allows you to create web-based slideshows, info displays, and the like. The way it works is that every Group has a special slideshow view, which can be loaded in a browser, allowing that browser to become a media display for the group. Every cue can have a "slide", a audio, video, or image file to play in the slideshow view page. It can also have text. By default, cue text shows in a sidebar that only appears if there is text, but you can customize everything. ## Setup a kiosk the easy way on a headless Pi! Get a fresh RasPi OS image. Use the raspi imager tool to set up the network stuff. SSH in and run these commands. They reconfigure a whole lot of stuff, including protecting the disk against excessive writes, so only run this on a fresh image dedicated to the cause. As the default user, run: ```bash sudo make root-install-system-dependencies sudo make root-use-pipewire-jack # Note: These root functions assume that everything will run under the # default user. If installing as a different user, pass KAITHEM_USER to make. sudo make root-install-sd-protection sudo make root-install-linux-tweaks sudo make root-install-kiosk make user-max-volume-at-boot make user-start-kaithem-at-boot sudo reboot now ``` Now it will boot into a fullscreen kiosk browser pointed at Kaithem's home page. If you want it to show some other content instead pass KIOSK_HOME=URL to `sudo make root-install-kiosk` Log in at PIHOSTNAME.local:8002/index using your RasPi username and Password. To update, do git pull --rebase in the folder you orginally cloned, then run `make user-install-kaithem`. ### Let's Add some Content! Visit the modules page and create a module. In v0.80.0+ almost everything lives in a module. In that module, use the button in the resouces list to create a Chandler Board See [Chandler Editor Docs](https://github.com/EternityForest/KaithemAutomation/wiki/Basic-Tutorials) for more info. Enter your media folders on the Chandler Board's settings page. Head back to the main editor(All the links will be found under the board you just made in the module), create a Group, then click the group's name. Open the "Cue Sound/Media" section and use the file browser to find your images and videos. Click new(slide) to make a new cue with the selected file set to the slide. In the cue list up top, hit jump to cue, and in a new tab visit the Web Media Display for that group(The link is in the Cue Media section). Whatever the current cue's slide is, will be shown on the web media display. Add more cues with slides, and the cue lengths(A length can also be something line @5pm if to have that cue end at 5pm every day, or even something like "@5pm on Tuesday") to build your slideshow. Set the last cue's "Next Cue" back to the first one, to make it loop! Remember to save your settings with the save button in the top bar, and also remember that when you reboot, groups start in the default cue. ### Play your slideshow in the Kiosk Browser If you want to change that default page, go to the Kaithem Global Settings, under the "tools" tab up top, and set the homepage to redirect to your URL of choice(Visit PIHOSTNAME.local:8002/index to get back to the real homepage). Find that Web Media Display link, do Copy Link Address in the browser menu, and paste as the homepage redirect, then reboot. Now when the kiosk browser goes to PIHOSTNAME.local:8002, it will see your slideshow. ### Instant digital signage If you are trying to do digital signage, go to Settings > File Manager(Public webserver files) and upload a .mp4 file. It will detect that the file is in the public folder and give you a digital signage link button. Set your homepage to redirect to that link, you should be done! #### Signage with audio Audio is managed through the Kaithem mixer. It should work out of the box if you're using the headphone jack. Otherwise if using HDMI, or if you want to remotely adjust volume, go to the mixer and make sure that channel has the output you want selected, and that the input matches Chromium's name. You can also add effects like EQ from this page. Don't forget to save the setup as the default! ## Custom Layouts Customizing the layout is done with basic HTML. The slides will show in the media-player element. Using the attribute v-html="cueText" fills that element with whatever the current cue text is. ## Variables You also have access to special variables. {{clock}} shows the server's time, {{countdown}} shows time left in the current cue, if the current cue is a timer. These variables can be used in both the cue text itself and the layout. You can also define new variables. In your cue logic, you can use setSlideshowVariable commands to send these variables to any group. Custom ones must start with "var" and they cannot be read. For simplicity, slideshow variables only go from logic to screen. ## Telemetry From the Chandler Editor page, you can see all currently connected web media displays. You can assign them a friendly name to help keep track of them. You can command them to play a test sound to identify and test them, and remotely refresh them. If media playback is blocked and needs manual interaction you will see an error. Usually this just means someone didn't enable autoplay in the settings and someone needs to turn it on or click the page. If they are running Chrome, you will also be able to see the battery and charge status.