Module: Weather

Allows you to view weather forecasts for up to 7 locations in a style similar The Weather Channel's WeatherStar III system from the 1980s

Contributors: anthonycaccese

Acknowledgements

• Design inspired by WeatherStar 3000+ by netbymatt and The Weather Channel's WeatherStar III system
• Iconography from Open-Meteo
• Default background music from the Weatherscan Music - Complete Collection

Features

• Integrates with Open-Meteo to provide weather forecasts for worldwide locations
• Integrates with NWS to provide current conditions for US locations
• For your main location it displays Current Conditions and Extended (3-day forecast)
• Can display forecast data for 6 additional locations
• Supports background music, US/Metric Units and 12-hour/24-hour time display
• Supports Remote/Keyboard: [Left/Right] moves through screens, [Enter] pauses/unpauses screen rotation, [Down] mutes/unmutes background music, [ESC/Back] exits the module)

Settings

Option	Values	Info
Enabled	On/Off	Sets if the module should display in the main module list when you start 240-MP.
Displays	Multiselect	Choose which screens you'd like to display in the rotation
Music	On/Off	Choose if background music should be played while the module is open
Units	Metric/US	--
Screen Time	10/30/60	Sets how long each screen will display for before moving to the next one
Hours Format	24-Hour/12-Hour	--

To Enable

1. Create a weather_location.txt file in the 240-MP data directory
   • On RaspberryPi/SteamOS/Linux: ~/.local/share/240-MP/weather_location.txt
   • On macOS: ~/Library/Application Support/240-MP/weather_location.txt
2. And add the locations you'd like to view forecasts for (one location per line) into that file.
   • The first line will act as your primary location and is what will be used to display current conditions and extended (3-day) forecast. This is the only required line.
   • If you would like to view forecasts for additional locations you can add up 6 additional (one per line). They will display on the Other Locations screen in the module
   • Lines starting with # are ignored
   • To set a location you can provide a Lat/Lon (recommended) or just a name
   • Example:

   40.756211, -73.923964, New York
   Seattle, WA, USA
   Toronto, Canada
   London, England
   Paris, France
   Stockholm, Sweden
   Tokyo, Japan
   

3. Then go to Settings > Weather and set Enabled to On

Background Music

The module has background music on by default and will shuffle a set of songs from the Weatherscan - Complete Collection on archive.org

You can mute background music at any time by pressing the down button on your remote/keyboard

You can also customize the background music with your own tracks:

1. create a weather_music.txt file in the 240-MP data directory
   • On RaspberryPi/SteamOS/Linux: ~/.local/share/240-MP/weather_locations.txt
   • On macOS: ~/Library/Application Support/240-MP/weather_locations.txt
2. And add the music tracks/playlists you'd like to use as background music (one per line) into that file.
   • Each line can be a relative path to a music file/playlist, an absolute path to the same thing, or a remote URL
   • Lines starting with # are ignored
   • at start up all lines from this file will be picked up and shuffled for playback as background music
   • Example:

   # relative path from 240-MP's config directory
   ambient/HUM - You'd Prefer an Astronaut.m3u
   # absolute path
   /Users/anthony/Documents/Mountaintop/Scenes/Ocean/audio.m4a
   # youtube audio track
   https://www.youtube.com/watch?v=jJAEy-fvVIs
   # youtube playlist
   https://www.youtube.com/playlist?list=PLLEnbi5KRv6aQ4k_isTi5DurcM8qxmca2