sintonia/docs/_docs/widgets.md

32 lines
1.4 KiB
Markdown
Raw Normal View History

2020-11-10 05:19:28 +01:00
---
title: Widgets
category: interface
layout: article
---
2020-12-02 21:06:10 +01:00
Bring your Libretime broadcast to your website with embeddable widgets! Libretime comes with two widgets: a streaming player and a schedule. Both widgets use iframes to display and can be placed wherever embeddable code can on a website.
2020-11-19 17:59:27 +01:00
2020-12-02 21:06:10 +01:00
## Getting Started
Before using the widgets, make sure Libretime's Public API is enabled in **Settings** > **General**.
![](/img/widgets_settings.png)
2021-05-27 16:20:34 +02:00
> **Note:** Your Libretime instance needs to be accessible to the public _without the use of a VPN or SSH tunneling_ in order for the widgets to work.
2020-12-02 21:06:10 +01:00
## Streaming Player Widget
The streaming player widget inserts your Libretime stream into your website. One example is from [WRCS Community Radio](http://wcrsfm.org/) in Columbus, Ohio, USA.
<iframe frameborder="0" width="400" height="235" src="http://broadcast.wcrsfm.org/embed/player?stream=auto&title=Now Playing"></iframe>
![](/img/widgets_player.png)
From **Widgets** > **Player**, enter a title for your streaming widget and select what stream you'd like to use. All selectible streams must first be configured in **Settings** > **Streams** (see [Settings](/docs/settings)). **Auto detect** should be fine for most.
## Show Schedule Widget
![](/img/widgets_schedule.png)
2021-05-27 16:20:34 +02:00
The show schedule widget displays the upcoming shows for the next seven days. There are no customizable settings for this widget.