Petals

---

The Open Source app Petals aims to help its users to either quit weed, reduce usage or simply know how much they're using.

⚠️ The Google Play Store version contains advertisements

For an ad free experience download the app either from F-Droid or from the Releases Page.

Translations

Translations are hosted at Weblate. You can contribute to your language here

Screenshots

Open to see screenshots

More Screenshots

Building

Signed

The signed version (the one published to GitHub and PlayStore) can be built with:

./gradlew packageGithubReleaseUniversalApk

You must first decrypt secrets using git secret reveal

Unsigned

If you're building an unsigned version, build the same one that goes to FDroid (as FDroid signs the app themselves).

./gradlew packageFdroidReleaseUniversalApk

This approach doesn't require secrets.

Git Secrets

The Keystore, Keystore Properties and Google Play deploy json files are included in the repository using git secret. The current secret owners are:

• Leonardo Colman Lopes

  • Fingerprint B3A5 9909 9ECC 4DB4 FD40 896F 7706 1922 C587 2792
  • Original Author

• GitHub Actions

  • Fingerprint 882E 409C 71F4 565B 1698 B947 A992 5FF4 75B3 5E07
  • Auto-publishing signed app to GitHub
  • Expires on 2027-04-05
  • Available on environment secret GPG_KEY

Releasing

Release to all our channels are made automatically after a tag is released. The workflow responsible for doing that is release.main.kts.

Google Play Store

1. Decrypt all git secrets
2. Run ./gradlew packageGithubReleaseUniversalApk
3. Publish to playstore running bundle config path vendor/bundle && bundle install --jobs 4 --retry 3 && bundle exec fastlane playstore

F-Droid

F-Droid builds automatically from the repository whenever a new tag is published. The definitions for how to build the app are in FDroid's data repository. If modifications are required, the place to change is there.

Releases Page

1. Decrypt all git secrets
2. Run ./gradlew packageGithubReleaseUniversalApk