{"id":19587290,"url":"https://github.com/leocolman/petals","last_synced_at":"2025-04-05T08:06:50.632Z","repository":{"id":39719080,"uuid":"426180570","full_name":"LeoColman/Petals","owner":"LeoColman","description":"🌻 The Open Source app Petals aims to help its users to either quit weed, reduce usage or simply know how much they're using.","archived":false,"fork":false,"pushed_at":"2024-10-29T19:15:02.000Z","size":33801,"stargazers_count":84,"open_issues_count":22,"forks_count":33,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-10-29T21:29:18.715Z","etag":null,"topics":["agplv3","android","cannabis","damage-reduction","drugs","hacktoberfest","kotlin","privacy","weed"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LeoColman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"leocolman","github":"leocolman"}},"created_at":"2021-11-09T10:13:59.000Z","updated_at":"2024-10-29T19:15:06.000Z","dependencies_parsed_at":"2024-01-10T15:41:18.378Z","dependency_job_id":"884d63be-5087-4884-a381-cbede7456cf4","html_url":"https://github.com/LeoColman/Petals","commit_stats":null,"previous_names":[],"tags_count":125,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LeoColman%2FPetals","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LeoColman%2FPetals/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LeoColman%2FPetals/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LeoColman%2FPetals/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LeoColman","download_url":"https://codeload.github.com/LeoColman/Petals/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247305934,"owners_count":20917208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agplv3","android","cannabis","damage-reduction","drugs","hacktoberfest","kotlin","privacy","weed"],"created_at":"2024-11-11T08:03:04.983Z","updated_at":"2025-04-05T08:06:50.611Z","avatar_url":"https://github.com/LeoColman.png","language":"Kotlin","funding_links":["https://ko-fi.com/leocolman","https://github.com/sponsors/leocolman"],"categories":[],"sub_categories":[],"readme":"# Petals\n\n[![License](https://img.shields.io/github/license/LeoColman/Petals)](https://github.com/LeoColman/Petals/blob/main/LICENSE)\n[![Unit Tests](https://github.com/LeoColman/Petals/actions/workflows/unit-tests.yaml/badge.svg)](https://github.com/LeoColman/Petals/actions/workflows/unit-tests.yaml)\n[![Detekt](https://github.com/LeoColman/Petals/actions/workflows/detekt.yaml/badge.svg)](https://github.com/LeoColman/Petals/actions/workflows/detekt.yaml)\n[![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)\n[![Weblate](https://hosted.weblate.org/widgets/petals-app/-/svg-badge.svg)](https://hosted.weblate.org/engage/petals-app/)\n[![GitHub Repo stars](https://img.shields.io/github/stars/LeoColman/Petals?style=plastic)](https://star-history.com/#LeoColman/Petals\u0026Date)\n[![Gitmoji](https://img.shields.io/badge/gitmoji-%20😜%20😍-FFDD67.svg?style=plastic)](https://gitmoji.dev/)\n[![Git Secrets](https://img.shields.io/badge/git%20secrets-enabled-green)](https://github.com/sobolevn/git-secret)\n[![F-Droid](https://img.shields.io/f-droid/v/br.com.colman.petals)](https://f-droid.org/packages/br.com.colman.petals/)\n[![GitHub Release](https://img.shields.io/github/v/release/LeoColman/Petals?label=github)](https://github.com/LeoColman/Petals/releases)\n[![IzzyOnDroid Release](https://img.shields.io/endpoint?url=https://apt.izzysoft.de/fdroid/api/v1/shield/br.com.colman.petals)](https://apt.izzysoft.de/fdroid/index/apk/br.com.colman.petals)\n[![GitHub All Releases](https://img.shields.io/github/downloads/LeoColman/Petals/total?label=Downloads%20All%20Time%20(GitHub))](https://github.com/LeoColman/Petals/releases)\n[![GitHub Release Downloads](https://img.shields.io/github/downloads/LeoColman/Petals/latest/total?label=Downloads%20Latest%20Release%20(GitHub))](https://github.com/LeoColman/Petals/releases/latest)\n![Coverage](https://leocolman.github.io/Petals/coverage-badge.svg)\n![Maintenance](https://img.shields.io/maintenance/yes/2025)\n\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n    \u003cimg  src=\"https://repobeats.axiom.co/api/embed/fc784a940119497476ba4d6694b88876e01aecbc.svg\"\u003e\n\u003c/p\u003e\n\n------\nThe Open Source app Petals aims to help its users to either quit weed, reduce usage or simply know how much they're\nusing.\n\n[\u003cimg src=\"https://user-images.githubusercontent.com/1577251/236347752-5c312036-27d1-4515-ab86-dc2aa9a09e66.png\" alt=\"Get it on GitHub\" height=\"80\"\u003e](https://github.com/LeoColman/Petals/releases)\n[\u003cimg src=\"https://fdroid.gitlab.io/artwork/badge/get-it-on.png\" alt=\"Get it on F-Droid\" height=\"80\"\u003e](https://f-droid.org/packages/br.com.colman.petals/)\n[\u003cimg src=\"https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png\" alt=\"Get it on IzzyOnDroid\" height=\"80\"\u003e](https://apt.izzysoft.de/fdroid/index/apk/br.com.colman.petals)\n[\u003cimg src=\"https://www.openapk.net/images/openapk-badge.png\" alt=\"Get it on OpenAPK\" height=\"80\"\u003e](https://www.openapk.net/petals/br.com.colman.petals/)\n[\u003cimg src=\"https://www.androidfreeware.net/images/androidfreeware-badge.png\" alt=\"Get it on AndroidFreeware\" height=\"80\"\u003e](https://www.androidfreeware.net/download-petals-apk.html)\n[\u003cimg src=\"https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png\" alt=\"Get it on Play Store\" height=\"80\"\u003e](https://play.google.com/store/apps/details?id=br.com.colman.petals)\n\n### ⚠️ The Google Play Store version contains advertisements\n\nFor an ad free experience download the app from other release channels.\n\n## 🌐 Contributing Translations\n\n[![Translation status](https://hosted.weblate.org/widgets/petals-app/-/287x66-grey.png)](https://hosted.weblate.org/engage/petals-app/)\n\nPetals welcomes community contributions for translations! To contribute translations, please follow these guidelines:\n\n- ✨ **New Languages**: If you are adding a new language, translations must be 100% complete before submission.\n- ⚠️ **Minimum Completion**: Translations that fall below 60% completion will be removed to maintain quality.\n- 🤝 **Contribution Methods**:\n  - 🌍 Non-programmers are encouraged to collaborate via [Weblate](https://hosted.weblate.org/engage/petals-app/).\n  - 🖥️ Programmers may contribute translations via pull requests directly on GitHub.\n\n[![Translation Status](https://hosted.weblate.org/widgets/petals-app/-/multi-red.svg)](https://hosted.weblate.org/engage/petals-app/)\n\nTranslations are hosted at Weblate. You can contribute to your language [here](https://hosted.weblate.org/engage/petals-app/).\n\n\n## Screenshots\n\n\u003cdetails\u003e\n\u003csummary\u003eOpen to see screenshots\u003c/summary\u003e\n\n![](fastlane/metadata/android/en-US/images/phoneScreenshots/1.png)\n![](fastlane/metadata/android/en-US/images/phoneScreenshots/2.png)\n![](fastlane/metadata/android/en-US/images/phoneScreenshots/3.png)\n\n[More Screenshots](fastlane/metadata/android/en-US/images/phoneScreenshots/)\n\u003c/details\u003e\n\n## Building\n\nYou can assemble both debug and release versions of the app for different variants (F-Droid, Playstore, GitHub) using\nthe corresponding Gradle tasks. Here's how to do that:\n\n### Debug Version\n\n- F-Droid: `./gradlew assembleFdroidDebug`\n- PlayStore: `./gradlew assemblePlaystoreDebug`\n- GitHub: `./gradlew assembleGithubDebug`\n\n### Release Version\n\nFor the release version, you must first decrypt secrets using `git secret reveal`. The release version can be assembled\nas follows:\n\n- F-Droid: `./gradlew assembleFdroidRelease`\n- PlayStore: `./gradlew assemblePlaystoreRelease`\n- GitHub: `./gradlew assembleGithubRelease`\n\n## Git Secrets\n\nThe **Keystore**, **Keystore Properties**, and **Google Play deploy json** files are included in the repository using\n[git secret](https://sobolevn.me/git-secret/). The current secret owners are:\n\n- Leonardo Colman Lopes\n    - Fingerprint `B3A5 9909 9ECC 4DB4 FD40 896F 7706 1922 C587 2792`\n    - Original Author\n\n- GitHub Actions\n    - Fingerprint `882E 409C 71F4 565B 1698 B947 A992 5FF4 75B3 5E07`\n    - Auto-publishing signed app to GitHub\n    - Expires on 2027-04-05\n    - Available on environment secret `GPG_KEY`\n\n## Releasing\n\nRelease to all our channels is made automatically after a tag is released. The workflow responsible for doing this\nis [release.main.kts](.github/workflows/release.main.kts).\n\n### Google Play Store\n\n1. Decrypt all git secrets\n2. Run `./gradlew bundlePlaystoreRelease`\n3. Publish to playstore by running\n   `cd fastlane \u0026\u0026 bundle config path vendor/bundle \u0026\u0026 bundle install --jobs 4 --retry 3 \u0026\u0026 bundle exec fastlane playstore`\n\n### F-Droid\n\nF-Droid builds automatically from the repository whenever a new tag is published. The definitions for how to build the\napp are\nin [F-Droid's data repository](https://gitlab.com/fdroid/fdroiddata/-/blob/master/metadata/br.com.colman.petals.yml). If\nmodifications are required, the place to change is there.\n\n### Releases Page\n\n1. Decrypt all git secrets\n2. Run `./gradlew assembleGithubRelease`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleocolman%2Fpetals","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleocolman%2Fpetals","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleocolman%2Fpetals/lists"}