Data Provider Manual

Complete reference for all available placeholders in buttons4twitch

← Back to Home

Quick Start

Use placeholders in your button messages to insert dynamic data. Placeholders follow the format:

{{provider.action.property}}

Example with Placeholders:

Currently streaming from {{location.getlocation.city}} where it's {{weather.getweather.temp}}°C!

Rendered Result:

Currently streaming from Berlin where it's 23°C!

Location Provider

Access location information using OpenStreetMap. All placeholders start with location.getlocation.

Basic Location Info

{{location.getlocation.display_name}} Full location name
{{location.getlocation.city}} City name
{{location.getlocation.country}} Country name
{{location.getlocation.country_code}} Country code (e.g., DE, US)
{{location.getlocation.state}} State/Province
{{location.getlocation.county}} County/Region

Address Details

{{location.getlocation.road}} Street name
{{location.getlocation.house_number}} House number
{{location.getlocation.postcode}} Postal code
{{location.getlocation.short_address}} Shortened address
{{location.getlocation.city_country}} City, Country format

Coordinates & Places

{{location.getlocation.coordinates}} Formatted coordinates
{{location.getlocation.lat}} Latitude
{{location.getlocation.lon}} Longitude
{{location.getlocation.amenity}} Nearby amenities
{{location.getlocation.tourism}} Tourism info
{{location.getlocation.leisure}} Leisure facilities

Weather Provider

Get current weather information using OpenWeatherMap. All placeholders start with weather.getweather.

Weather Overview

{{weather.getweather.summary}} Complete weather summary
{{weather.getweather.weather}} Weather description
{{weather.getweather.weather_main}} Main weather condition
{{weather.getweather.weather_emoji}} Weather emoji 🌤ī¸
{{weather.getweather.weather_icon}} Weather icon code

Available Weather Emojis:

☀ī¸ Clear Sky
🌤ī¸ Few Clouds
⛅ Scattered Clouds
☁ī¸ Broken Clouds
🌧ī¸ Shower Rain
đŸŒĻī¸ Rain
⛈ī¸ Thunderstorm
🌩ī¸ Thunder
❄ī¸ Snow
🌨ī¸ Snow Shower
đŸŒĢī¸ Mist/Fog
đŸŒĒī¸ Tornado
🌈 Rainbow
🌙 Clear Night
🌛 Partly Cloudy Night

Temperature

{{weather.getweather.temp}} Current temperature (°C)
{{weather.getweather.temp_feels}} Feels like temperature (°C)
{{weather.getweather.temp_min}} Min temperature (°C)
{{weather.getweather.temp_max}} Max temperature (°C)
{{weather.getweather.temp_range}} Temperature range

Atmospheric Conditions

{{weather.getweather.humidity}} Humidity (%)
{{weather.getweather.pressure}} Pressure (hPa)
{{weather.getweather.visibility}} Visibility (km)
{{weather.getweather.clouds}} Cloud coverage (%)

Wind & Sun

{{weather.getweather.wind_speed}} Wind speed (km/h)
{{weather.getweather.wind_direction}} Wind direction (N, NE, etc.)
{{weather.getweather.wind_deg}} Wind degrees (°)
{{weather.getweather.wind_info}} Complete wind info
{{weather.getweather.sunrise}} Sunrise time
{{weather.getweather.sunset}} Sunset time

Location Info

{{weather.getweather.city_name}} City name
{{weather.getweather.country_code}} Country code

Twitch Provider

Access your Twitch stream and channel data. Placeholders use different endpoints:

Stream Information (twitch.getstream)

{{twitch.getstream.summary}} Complete stream summary
{{twitch.getstream.is_live}} Live status (true/false)
{{twitch.getstream.viewer_count}} Current viewer count
{{twitch.getstream.viewer_formatted}} Formatted viewer count
{{twitch.getstream.status}} Stream status
{{twitch.getstream.thumbnail_url}} Stream thumbnail URL

Stream Timing (twitch.getstream)

{{twitch.getstream.started_at}} Stream start time (raw)
{{twitch.getstream.started_at_formatted}} Stream start time (formatted)
{{twitch.getstream.uptime_minutes}} Uptime in minutes
{{twitch.getstream.uptime_hours}} Uptime in hours
{{twitch.getstream.uptime_formatted}} Formatted uptime

Channel Information (twitch.getchannel)

{{twitch.getchannel.broadcaster_name}} Channel name
{{twitch.getchannel.broadcaster_id}} Broadcaster ID
{{twitch.getchannel.display_name}} Display name
{{twitch.getchannel.broadcaster_language}} Channel language
{{twitch.getchannel.channel_url}} Channel URL
{{twitch.getchannel.delay}} Stream delay (seconds)

Channel Content (twitch.getchannel)

{{twitch.getchannel.title}} Stream title
{{twitch.getchannel.title_short}} Shortened title
{{twitch.getchannel.game_name}} Current game/category
{{twitch.getchannel.game_id}} Game/category ID
{{twitch.getchannel.game_display}} Game display format

Channel Tags (twitch.getchannel)

{{twitch.getchannel.tags}} All channel tags
{{twitch.getchannel.tags_count}} Number of tags

Followers (twitch.getfollowers)

{{twitch.getfollowers.total}} Total follower count
{{twitch.getfollowers.total_formatted}} Formatted follower count
{{twitch.getfollowers.display}} Display format
{{twitch.getfollowers.summary}} Followers summary

Example Messages

Simple Location Message

Currently streaming from {{location.getlocation.city}}, {{location.getlocation.country}}! 🌍

Weather Update

It's {{weather.getweather.temp}}°C and {{weather.getweather.weather}} here! {{weather.getweather.weather_emoji}}

Stream Stats

We've been live for {{twitch.getstream.uptime_formatted}} with {{twitch.getstream.viewer_count}} viewers! 🎮

Combined Message

🌍 Currently streaming from {{location.getlocation.city}} where it's {{weather.getweather.temp}}°C and {{twitch.getstream.viewer_count}} viewers are watching!
← Back to Home