{"id":13643077,"url":"https://github.com/Hamza417/Peristyle","last_synced_at":"2025-04-20T21:32:47.712Z","repository":{"id":182130773,"uuid":"667998169","full_name":"Hamza417/Peristyle","owner":"Hamza417","description":"Simple wallpaper manager app for Android with awesome UI, tags and multiple folder support and a native live wallpaper picker.","archived":false,"fork":false,"pushed_at":"2025-04-20T06:37:37.000Z","size":147522,"stargazers_count":357,"open_issues_count":4,"forks_count":12,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-20T07:23:29.692Z","etag":null,"topics":["android","android-app","compose","gallery","glassmorphism","jetpack-compose","jetpackcompose","kotlin","material-design","material-ui","mvvm","wallpaper","wallpaper-app"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hamza417.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"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,"zenodo":null}},"created_at":"2023-07-18T19:27:12.000Z","updated_at":"2025-04-20T06:31:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"87cc58b9-f58f-4351-9c3f-dc7f6e179fd0","html_url":"https://github.com/Hamza417/Peristyle","commit_stats":null,"previous_names":["hamza417/peri","hamza417/peristyle"],"tags_count":89,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamza417%2FPeristyle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamza417%2FPeristyle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamza417%2FPeristyle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamza417%2FPeristyle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hamza417","download_url":"https://codeload.github.com/Hamza417/Peristyle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249965547,"owners_count":21352925,"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","android-app","compose","gallery","glassmorphism","jetpack-compose","jetpackcompose","kotlin","material-design","material-ui","mvvm","wallpaper","wallpaper-app"],"created_at":"2024-08-02T01:01:41.079Z","updated_at":"2025-04-20T21:32:47.703Z","avatar_url":"https://github.com/Hamza417.png","language":"Kotlin","funding_links":[],"categories":["Kotlin","🎨 Personalization and UI"],"sub_categories":["🎴 Icons/Wallpapers/Widgets"],"readme":"# Peristyle\n\nSimple wallpaper manager app for Android.\n\n## Why Peristyle?\n\nPeristyle is created to be extremely simple and sophisticated wallpaper manager and browser app\nfor Android. It solves the problem of having too many features and bloated apps and having\nvery minimal support for locally stored wallpapers. What if you just wanted an app that allows\nyou to browse and select your own locally stored wallpapers and lets you manage and set wallpapers\nfrom there? then Peristyle is for you :)\n\n## Features\n\n- Simple architecture, browse wallpapers and use system wallpaper manager to set them as wallpaper.\n- Multiple folders support.\n- Ability to assign Tags to any wallpaper.\n- Can scan .nomedia directories, useful if you want to keep your wallpapers away from gallery.\n- Apply blur and color filters dynamically on any wallpaper before applying.\n- Simple yet pretty animations with proper optimizations.\n- Compress or reduce images on the fly.\n- No ads, no tracking, no analytics, no internet permissions, no unnecessary permissions.\n- Auto wallpaper change support with dedicated folders and tags for each screens.\n- Change wallpaper using app's live wallpaper\n- Edit and apply filters on wallpapers losslessly in realtime.\n- Built-in live wallpaper picker.\n- Dark mode support.\n- Glassmorphic UI based on realtime blur effects and caustic shadows.\n- Material You color theme.\n- Fully reproducible build.\n- Zero loading software architecture.\n\n## Stats\n\n![GitHub all releases](https://img.shields.io/github/downloads/Hamza417/Peri/total?label=Total%20Downloads\u0026color=white)\n\n## Download\n\n[![](https://img.shields.io/github/v/release/Hamza417/Peristyle?color=181717\u0026logo=github\u0026label=GitHub%20Release)](https://github.com/Hamza417/Peristyle/releases/latest)\n[![](https://img.shields.io/f-droid/v/app.simple.peri?logo=fdroid\u0026logoColor=white\u0026label=F-Droid\u0026color=1976D2)](https://f-droid.org/en/packages/app.simple.peri/)\n[![](https://img.shields.io/endpoint?url=https://apt.izzysoft.de/fdroid/api/v1/shield/app.simple.peri\u0026logo=fdroid)](https://apt.izzysoft.de/fdroid/index/apk/app.simple.peri/)\n\n## Screenshots\n\n| ![01](./fastlane/metadata/android/en-US/images/phoneScreenshots/01.png) | ![02](./fastlane/metadata/android/en-US/images/phoneScreenshots/02.png) | ![03](./fastlane/metadata/android/en-US/images/phoneScreenshots/03.png) |\n|:-----------------------------------------------------------------------:|:-----------------------------------------------------------------------:|:-----------------------------------------------------------------------:|\n| ![04](./fastlane/metadata/android/en-US/images/phoneScreenshots/04.png) | ![05](./fastlane/metadata/android/en-US/images/phoneScreenshots/05.png) | ![06](./fastlane/metadata/android/en-US/images/phoneScreenshots/06.png) |\n| ![07](./fastlane/metadata/android/en-US/images/phoneScreenshots/07.png) | ![08](./fastlane/metadata/android/en-US/images/phoneScreenshots/08.png) | ![09](./fastlane/metadata/android/en-US/images/phoneScreenshots/09.png) |\n| ![10](./fastlane/metadata/android/en-US/images/phoneScreenshots/10.png) | ![11](./fastlane/metadata/android/en-US/images/phoneScreenshots/11.png) | ![12](./fastlane/metadata/android/en-US/images/phoneScreenshots/12.png) |\n\n### Peristyle also has a separate UI based on Material You\n\nThe legacy interface is planned to be removed in v8.0.0.\n\n| ![001](./screenshots/01.png) | ![002](./screenshots/02.png) | ![003](./screenshots/03.png) |\n|:----------------------------:|:----------------------------:|:----------------------------:|\n| ![004](./screenshots/04.png) | ![005](./screenshots/05.png) | ![006](./screenshots/06.gif) |\n\n## Triggering AutoWallpaperService from Other Apps\n\nPeristyle supports triggering the AutoWallpaperService from other apps using the following\nintent: `app.peristyle.START_AUTO_WALLPAPER_SERVICE`\n\n**_You can use any automation or scheduling tool and create your own scenario to change wallpaper for any custom event such as locking/unlocking or as you need._**\n\n## Permission Usage\n\nPeristyle needs `MANAGE_EXTERNAL_STORAGE` and `READ_MEDIA_IMAGES` to be allowed to show the system\nwallpapers in the app.\nIt has been discussed in\nthe [Issue #72](https://github.com/Hamza417/Peristyle/issues/72#issuecomment-2357558761).\n\nThe `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` is used to run Auto Wallpaper service whenever required.\n\nAnd an access to all the wallpaper directories whichever the user specifies.\n\n## Roadmap\n\n- Setting specific wallpaper for night mode and day mode (eta: v9)\n- Auto assign night/day tags to wallpapers based on their luminance data (eta: v9)\n- Minimal (sfw only) integration of WallHaven API (eta: v10 onwards)\n- [Speculated] Integration of other wallpaper APIs (eta: v11 onwards)\n\n## Translate\n\n[![Crowdin](https://badges.crowdin.net/peristyle/localized.svg)](https://crowdin.com/project/peristyle)\n\nPeristyle supports localization, If you want to\ntranslate Peristyle in your language/s, you can do\nso [here on Crowdin](https://crowdin.com/project/peristyle).\n\n[Contributors](https://crowdin.com/project/peristyle/members)\n\n## License\n\n```\nCopyright 2023 Hamza Rizwan\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHamza417%2FPeristyle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHamza417%2FPeristyle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHamza417%2FPeristyle/lists"}