API keys

GitHub releases contain default API keys of the project that make all weather sources work by default (until API limits are reached).

If you want to self-build, you can add your own API keys in local.properties for sources to be configured by default in the build:

breezy.accu.portal=developer
breezy.accu.key=myapikey
breezy.accu.days=15
breezy.accu.hours=120
breezy.atmoaura.key=myapikey
breezy.atmofrance.key=myapikey
breezy.atmograndest.key=myapikey
breezy.atmohdf.key=myapikey
breezy.atmosud.key=myapikey
breezy.baiduip.key=myapikey
breezy.eccc.key=myapikey
breezy.geonames.key=myapikey
breezy.here.key=myapikey
breezy.mf.jwtKey=myapikey
breezy.mf.key=myapikey
breezy.openweather.key=myapikey
breezy.pirateweather.key=myapikey

You can omit any of the following properties to let the user configure their own API key in the settings, or only use API-key-less sources (such as Open-Meteo).

By default, the app is compiled unbranded and you will have to complete a few properties located in gradle.properties.

If you have no plans to distribute releases and you only build the app for yourself ONLY, you can just pass the parameter breezy to the command line. Example: ./gradlew assembleBasicDebug -Pbreezy

In Android Studio, this can be set up in the configuration of the app module, in the Before launch section, remove existing and add a Gradle task: choose app module, add assembleBasicDebug or assembleFreenetDebug as command, and -Pbreezy as Arguments.

Release management

Instructions for members of the organization.

1. Test your debug build.
2. Run tests ./gradlew testBasicDebugUnitTest and ./gradlew testDebugUnitTest.
3. Try to assemble a release ./gradlew assembleBasicRelease -Pbreezy. /!\ Only the Breezy Weather organization can distribute releases with the breezy parameter. Forks must not include this parameter when building, and use their own branding.
4. Update versionCode and versionName in app/build.gradle.
5. Write changelog in CHANGELOG.md.
6. Commit all changes.
7. Tag version beginning with a v (example: git tag v6.1.4 -m "Version 6.1.4").
8. Push with git push --tags
9. GitHub action will run and sign the release.
10. Update GitHub release notes draft and publish.
11. Update GitHub templates in .github/ to show the new latest version.

If anything goes bad (such as reproducibility issue), you can remove the tag using git push origin :v6.x.y && git tag --delete v6.x.y and trigger a new build.

Reproducibility

APKs are generated by a GitHub action from the public source code, guaranteeing they are always generated in the same conditions.

As of 2025-11-11, the environment used is Ubuntu 24.04 (x64), with 4 CPU cores and 16 GB RAM.

If you have more than 4 CPU cores, you may need to run the following to ensure the CPU cores match with the GitHub runner, or you may end up with differences in the baseline.prof file:

export CPUS_MAX=16 # Replace with your number of CPU cores
export CPUS=4
for (( c=$CPUS; c<$CPUS_MAX; c++ )) ; do echo 0 > /sys/devices/system/cpu/cpu$c/online; done

Adding a new source

After merging a new source, the following things need to be done:

1. Update CHANGELOG.md
2. Update docs/SOURCES.md
3. Update docs/COVERAGE.md
4. Update fastlane/metadata/android/{*}/full_description.txt (bulk replace in all languages)
5. Update the regex on Weblate

Decode crash logs from users

1. Save crash log in a text file stacktrace.txt and remove things like 2023-08-14 21:28:58.229 12804-12804 View org.breezyweather.debug if they are present.
2. From the release page, download mapping-vX.Y.Z-standard.tar.gz or mapping-vX.Y.Z-freenet.tar.gz depending on the flavor used by the user.
3. Unzip mapping.txt.
4. ~/Android/Sdk/cmdline-tools/latest/bin/retrace mapping.txt stacktrace.txt

Translations

Updated translations

When translations are updated from Weblate, if there are new contributors, add them in app/src/main/java/org/breezyweather/settings/activities/AboutActivity.kt.

Added translations

When a translation is added, add the CLDR data for this locale in the weather-unit library.

Dependencies

Update Gradle

Gradle must always be updated that way (replace with new version number):

./gradlew wrapper --gradle-version=9.5.0 --gradle-distribution-sha256-sum=553c78f50dafcd54d65b9a444649057857469edf836431389695608536d6b746

You can find the newer checksum of the binary-only (-bin) ZIP on https://gradle.org/release-checksums/

Dropping support for an Android version

1. In org.breezyweather.background.updater.AppUpdateChecker, uncomment the relevant lines to trigger a notification on the unsupported Android versions
2. In org.breezyweather.background.weather.WeatherUpdateJob, uncomment the relevant lines to always enable “check for update” on these unsupported Android versions, to ensure that freenet users and users who disabled update check correctly receive the notification. No actual update check will be performed, so it’s safe to force it enabled.

Adding a new Material Icon

You can find many Material Symbols and Icons here.

Weather sources API

Weather sources API can change: some versions may become deprecated, new endpoints may be added, new countries may be supported (when documented, we filter countries in app to avoid unnecessary calls on unsupported countries).

This section keep track of endpoints and when they were last checked.

Open-Meteo

Last checked: 2024-04-16

Future additional endpoints/improvements for existing endpoints:

• Reverse geocoding, see open-meteo/geocoding-api#6
• Alerts, see open-meteo/open-meteo#351
• Moon rise, set and phases, see open-meteo/open-meteo#87
• Normals, see open-meteo/open-meteo#361

AccuWeather

Last checked: 2024-04-16

https://apidev.accuweather.com/developers/

MET Norway

Last checked: 2024-04-16

https://api.met.no/

Not yet implemented in app:

No location search endpoint exists, it uses Open-Meteo instead.

OpenWeather

Last checked: 2024-04-16

https://openweathermap.org/api

Pirate Weather

Last checked: 2025-10-30

https://github.com/Pirate-Weather/pirateweather

We should check regularly for additional fields we could use. Latest version checked is written above, everything more recent requires to check changelog.

Météo-France

Last checked: 2024-02-13

Not used:

Uses Open-Meteo for location search.

DMI

To be documented

China

Legacy source, undocumented

National Weather Service (NWS)

To be documented

GeoSphere Austria

To be documented

Bright Sky

Last checked: 2024-04-16

ECCC

Last checked: 2024-01-26

Israel Meteorological Service

To be documented

SMHI

Last checked: 2024-01-26

MET Éireann

To be documented