{"id":13638637,"url":"https://github.com/ammargitham/WallFlow","last_synced_at":"2025-04-19T18:31:00.736Z","repository":{"id":184639796,"uuid":"644135905","full_name":"ammargitham/WallFlow","owner":"ammargitham","description":"Wallpaper app for Android using Jetpack Compose","archived":false,"fork":false,"pushed_at":"2024-08-12T12:09:25.000Z","size":127680,"stargazers_count":363,"open_issues_count":21,"forks_count":21,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-12-13T09:03:23.718Z","etag":null,"topics":["android","compose","jetpack-compose","kotlin","material-design"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ammargitham.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2023-05-22T22:33:50.000Z","updated_at":"2024-12-10T04:37:36.000Z","dependencies_parsed_at":"2023-07-29T13:03:31.940Z","dependency_job_id":"5ddbd321-853c-4f06-a6b6-e0601bd5611c","html_url":"https://github.com/ammargitham/WallFlow","commit_stats":null,"previous_names":["ammargitham/wallflow"],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ammargitham%2FWallFlow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ammargitham%2FWallFlow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ammargitham%2FWallFlow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ammargitham%2FWallFlow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ammargitham","download_url":"https://codeload.github.com/ammargitham/WallFlow/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249764734,"owners_count":21322290,"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":["android","compose","jetpack-compose","kotlin","material-design"],"created_at":"2024-08-02T01:00:50.715Z","updated_at":"2025-04-19T18:30:55.701Z","avatar_url":"https://github.com/ammargitham.png","language":"Kotlin","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"200\" height=\"200\" src=\".github/assets/icon.svg\" alt=\"WallFlow\" title=\"WallFlow\"\u003e\n  \u003ch1\u003eWallFlow\u003c/h1\u003e\n  \u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://github.com/ammargitham/WallFlow/releases/latest\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/v/release/ammargitham/wallflow.svg?style=for-the-badge\u0026logo=GitHub\u0026labelColor=black\u0026label=Github\u0026color=black\" alt=\"Github\"\u003e\n    \u003c/a\u003e\n  \u003c/div\u003e\n  \u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://f-droid.org/packages/com.ammar.wallflow/\"\u003e\n      \u003cimg src=\"https://img.shields.io/f-droid/v/com.ammar.wallflow?style=for-the-badge\u0026logo=fdroid\u0026logoColor=%23b1eb0b\u0026label=f-droid (Regular)\u0026labelColor=%23217ad3\u0026color=%23217ad3\" alt=\"F-Droid\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://f-droid.org/packages/com.ammar.wallflow.plus/\"\u003e\n      \u003cimg src=\"https://img.shields.io/f-droid/v/com.ammar.wallflow.plus?style=for-the-badge\u0026logo=fdroid\u0026logoColor=%23b1eb0b\u0026label=f-droid (Plus)\u0026labelColor=%23217ad3\u0026color=%23217ad3\" alt=\"F-Droid\"\u003e\n    \u003c/a\u003e\n  \u003c/div\u003e\n  \u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://github.com/ammargitham/WallFlow/actions/workflows/codeql.yml\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/ammargitham/wallflow/codeql.yml?style=for-the-badge\u0026label=CodeQL\" alt=\"CodeQL\" title=\"CodeQL\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://hosted.weblate.org/projects/wallflow/\"\u003e\n      \u003cimg src=\"https://img.shields.io/weblate/progress/wallflow?style=for-the-badge\" alt=\"Weblate\" title=\"Weblate\"\u003e\n    \u003c/a\u003e\n  \u003c/div\u003e\n  \u003cbr/\u003e\n  \u003cp\u003e\n  A wallpaper app for Android with beautiful wallpapers from \u003ca href=\"https://wallhaven.cc/\"\u003ewallhaven.cc\u003c/a\u003e, \u003ca href=\"https://reddit.com/\"\u003eReddit\u003c/a\u003e. Designed with \u003ca href=\"https://m3.material.io/\"\u003eMaterial Design 3\u003c/a\u003e and supports wide screen devices like tablets.\n  \u003c/p\u003e\n\u003c/div\u003e\n\u003cbr/\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"devices\" title=\"Devices\" src=\".github/assets/devices.png\" width=\"500\"\u003e\n\u003c/div\u003e\n\n## Downloads\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://github.com/ammargitham/WallFlow/releases/latest\"\u003e\n  \u003cimg height=\"80\" alt=\"Get it on GitHub\" title=\"Get it on GitHub\" src=\"./.github/assets/get-it-on-github.png\" /\u003e\n\u003c/a\u003e\n\n|                                                                                                           Regular                                                                                                           |                                                                                                               Plus                                                                                                               |\n|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|\n|                     [\u003cimg height=\"80\" alt=\"Get it on GitHub\" title=\"Get it on GitHub\" src=\"https://fdroid.gitlab.io/artwork/badge/get-it-on.png\" /\u003e](https://f-droid.org/packages/com.ammar.wallflow/)                      |                     [\u003cimg height=\"80\" alt=\"Get it on GitHub\" title=\"Get it on GitHub\" src=\"https://fdroid.gitlab.io/artwork/badge/get-it-on.png\" /\u003e](https://f-droid.org/packages/com.ammar.wallflow.plus/)                      |\n| [\u003cimg height=\"80\" alt=\"Get it on IzzyOnDroid\" title=\"Get it on IzzyOnDroid\" src=\"https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png\" /\u003e](https://apt.izzysoft.de/fdroid/index/apk/com.ammar.wallflow/) | [\u003cimg height=\"80\" alt=\"Get it on IzzyOnDroid\" title=\"Get it on IzzyOnDroid\" src=\"https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png\" /\u003e](https://apt.izzysoft.de/fdroid/index/apk/com.ammar.wallflow.plus/) |\n\n\\*[_What's the difference between Regular and Plus?_](#regular-vs-plus)\n\n\u003c/div\u003e\n\n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n| \u003cimg src=\"./src/base/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png\" alt=\"Home\" width=\"150\"\u003e | \u003cimg src=\"./src/base/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png\" alt=\"Filters\" width=\"150\"\u003e | \u003cimg src=\"./src/base/fastlane/metadata/android/en-US/images/phoneScreenshots/2_reddit.png\" alt=\"Filters\" width=\"150\"\u003e | \u003cimg src=\"./src/base/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png\" alt=\"Wallpaper Info\" width=\"150\"\u003e |\n|:-----------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------:|\n|                                                 \u003cb\u003eHome\u003c/b\u003e                                                 |                                            \u003cb\u003eWallhaven Filters\u003c/b\u003e                                            |                                                 \u003cb\u003eReddit Filters\u003c/b\u003e                                                 |                                                 \u003cb\u003eWallpaper Info\u003c/b\u003e                                                 |\n\n| \u003cimg src=\"./src/base/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png\" alt=\"Search History\" width=\"150\"\u003e | \u003cimg src=\"./src/base/fastlane/metadata/android/en-US/images/phoneScreenshots/5.png\" alt=\"Crop and Set Wallpaper\" width=\"150\"\u003e | \u003cimg src=\"./src/base/fastlane/metadata/android/en-US/images/phoneScreenshots/6.png\" alt=\"Settings 1\" width=\"150\"\u003e |\n|:---------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------:|\n|                                                 \u003cb\u003eSearch History\u003c/b\u003e                                                 |                                                 \u003cb\u003eCrop and Set Wallpaper\u003c/b\u003e                                                 |                                                  \u003cb\u003eSettings\u003c/b\u003e                                                  |\n\n\u003c/div\u003e\n\n## Features\n\n- Supports wallhaven.cc and Reddit\n- Multi-pane layout for tablets and other wide screen devices\n- Auto wallpaper changer\n- Save searches\n- Favorite wallpapers\n- Local Wallpapers\n- Use saved searches, favorites, and local wallpapers for auto wallpaper changer\n- Search history\n- [Plus] Smart wallpaper cropping using on-device object detection powered by [Tensorflow Lite](https://www.tensorflow.org/lite/).\n  - Supports adding your own TFLite models. You can find more models [here](https://tfhub.dev/s?deployment-format=lite\u0026module-type=image-object-detection/).\n- Search results caching to reduce api calls\n- Options to tweak the wallpaper grid layout\n- QuickSettings tile, shortcut and broadcast to quickly change wallpaper\n- Dynamic theme (Material You)\n- Supports multi-display environments (eg. when connected to external monitors)\n\n## Regular vs Plus\n\nTwo versions are provided (both free and open-source)\n\n- Regular version without the Object detection feature (smaller apk size).\n- Plus version with the Object detection feature. (Since Tensorflow adds around 8MB native libs to the apk size).\n\n**All other features are same in both versions.**\n\n## Broadcast details (for Tasker and similar apps)\n\n- Package:\n  - For Regular: `com.ammar.wallflow`\n  - For Plus: `com.ammar.wallflow.plus`\n- Action: `com.ammar.wallflow.ACTION_CHANGE_WALLPAPER`\n\nADB command:\n\n- For Regular: `am broadcast --user 0 -a com.ammar.wallflow.ACTION_CHANGE_WALLPAPER com.ammar.wallflow`\n- For Plus: `am broadcast --user 0 -a com.ammar.wallflow.ACTION_CHANGE_WALLPAPER com.ammar.wallflow.plus`\n\n## Roadmap\n\n- [ ] Support foldables inner and outer screens together\n- [ ] More theme colors\n- [ ] Learn from favorites (on-device) and suggest wallpapers\n- [ ] Support Windows using [Kotlin multiplatform](https://kotlinlang.org/docs/multiplatform.html).\n\n## Help with translations\n\u003ca href=\"https://hosted.weblate.org/engage/wallflow/\"\u003e\n  \u003cimg src=\"https://hosted.weblate.org/widget/wallflow/287x66-grey.png\" alt=\"Translation status\" /\u003e\n\u003c/a\u003e\n\n## Built using\n\n- [Jetpack Compose](https://developer.android.com/jetpack/compose/)\n- [Material Design 3 components for Compose](https://developer.android.com/jetpack/compose/designsystems/material3)\n- [Compose Destinations](https://composedestinations.rafaelcosta.xyz/)\n- [Hilt](https://developer.android.com/training/dependency-injection/hilt-android/)\n- [Room](https://developer.android.com/training/data-storage/room/)\n- [Datastore](https://developer.android.com/topic/libraries/architecture/datastore/)\n- [Retrofit](https://square.github.io/retrofit/)\n- [Coil](https://coil-kt.github.io/coil/)\n- [Telephoto](https://github.com/saket/telephoto/)\n- [Paging 3](https://developer.android.com/topic/libraries/architecture/paging/v3-overview/)\n- [Accompanist](https://google.github.io/accompanist/)\n- [WorkManager](https://developer.android.com/topic/libraries/architecture/workmanager/)\n- [My fork](https://github.com/ammargitham/easycrop/) of [EasyCrop](https://github.com/mr0xf00/easycrop/)\n- [Tensorflow Lite](https://www.tensorflow.org/lite/)\n- [Cloudy](https://github.com/skydoves/Cloudy/)\n- [partial-kt](https://github.com/MateriiApps/partial-kt/)\n- [Ktlint](https://pinterest.github.io/ktlint/) using [Spotless](https://github.com/diffplug/spotless) plugin\n- [Mockk](https://mockk.io/)\n- Some more AndroidX libraries. Please see the [build.gradle](./app/build.gradle.kts) file.\n\n## License\n\n```\nWallFlow\nCopyright (C) 2023  Ammar Githam\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n```\n","funding_links":[],"categories":["📱 Known apps"],"sub_categories":["🎴 Icons/Wallpapers/Widgets"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fammargitham%2FWallFlow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fammargitham%2FWallFlow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fammargitham%2FWallFlow/lists"}