https://github.com/LeoColman/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.
https://github.com/LeoColman/Petals

agplv3 android cannabis damage-reduction drugs hacktoberfest kotlin privacy weed

Last synced: 4 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/LeoColman/Petals
• Owner: LeoColman
• License: agpl-3.0
• Created: 2021-11-09T10:13:59.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-09T16:39:42.000Z (8 days ago)
• Last Synced: 2025-04-09T17:43:00.331Z (8 days ago)
• Topics: agplv3, android, cannabis, damage-reduction, drugs, hacktoberfest, kotlin, privacy, weed
• Language: Kotlin
• Homepage:
• Size: 61.5 MB
• Stars: 99
• Watchers: 3
• Forks: 33
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• Awesome-Android-Open-Source-Projects - Petals

README

        
# Petals

[![License](https://img.shields.io/github/license/LeoColman/Petals)](https://github.com/LeoColman/Petals/blob/main/LICENSE)

[![Unit Tests](https://github.com/LeoColman/Petals/actions/workflows/unit-tests.yaml/badge.svg)](https://github.com/LeoColman/Petals/actions/workflows/unit-tests.yaml)

[![Lint](https://github.com/LeoColman/Petals/actions/workflows/lint.yaml/badge.svg)](https://github.com/LeoColman/Petals/actions/workflows/lint.yaml)

[![Dependency Analysis](https://github.com/LeoColman/Petals/actions/workflows/dependency-license-analysis.yaml/badge.svg)](https://github.com/LeoColman/Petals/actions/workflows/dependency-analysis.yaml)







[![GitHub Repo stars](https://img.shields.io/github/stars/LeoColman/Petals?style=plastic)](https://star-history.com/#LeoColman/Petals&Date)

[![Gitmoji](https://img.shields.io/badge/gitmoji-%20😜%20😍-FFDD67.svg?style=plastic)](https://gitmoji.dev/)

[![Git Secrets](https://img.shields.io/badge/git%20secrets-enabled-green)](https://github.com/sobolevn/git-secret)

[![Fdroid](https://img.shields.io/f-droid/v/br.com.colman.petals)](https://f-droid.org/packages/br.com.colman.petals/)

[![GitHub Release](https://img.shields.io/github/v/release/LeoColman/Petals?label=github)](https://github.com/LeoColman/Petals/releases)



[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/K3K62Y2GB)

------

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

using.

[](https://github.com/LeoColman/Petals/releases)

[](https://f-droid.org/packages/br.com.colman.petals/)

[](https://play.google.com/store/apps/details?id=br.com.colman.petals)

### ⚠️ 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](https://hosted.weblate.org/engage/petals-app)
















## Screenshots

Open to see screenshots

![](fastlane/metadata/android/en-US/images/phoneScreenshots/1.png)

![](fastlane/metadata/android/en-US/images/phoneScreenshots/2.png)

![](fastlane/metadata/android/en-US/images/phoneScreenshots/3.png)

[More Screenshots](fastlane/metadata/android/en-US/images/phoneScreenshots)

## 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](https://sobolevn.me/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](.github/workflows/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](https://gitlab.com/fdroid/fdroiddata/-/blob/master/metadata/br.com.colman.petals.yml). If

modifications are required, the place to change is there.

### Releases Page

1. Decrypt all git secrets

2. Run `./gradlew packageGithubReleaseUniversalApk`