https://github.com/hamza417/peristyle
Simple wallpaper manager app for Android with awesome UI, tags and multiple folder support and a native live wallpaper picker.
https://github.com/hamza417/peristyle
android android-app compose gallery glassmorphism jetpack-compose jetpackcompose kotlin material-design material-ui mvvm wallpaper wallpaper-app
Last synced: 12 days ago
JSON representation
Simple wallpaper manager app for Android with awesome UI, tags and multiple folder support and a native live wallpaper picker.
- Host: GitHub
- URL: https://github.com/hamza417/peristyle
- Owner: Hamza417
- License: apache-2.0
- Created: 2023-07-18T19:27:12.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-04-12T15:50:36.000Z (12 days ago)
- Last Synced: 2025-04-12T16:35:04.987Z (12 days ago)
- Topics: android, android-app, compose, gallery, glassmorphism, jetpack-compose, jetpackcompose, kotlin, material-design, material-ui, mvvm, wallpaper, wallpaper-app
- Language: Kotlin
- Homepage:
- Size: 141 MB
- Stars: 358
- Watchers: 7
- Forks: 10
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Peristyle
Simple wallpaper manager app for Android.
## Why Peristyle?
Peristyle is created to be extremely simple and sophisticated wallpaper manager and browser app
for Android. It solves the problem of having too many features and bloated apps and having
very minimal support for locally stored wallpapers. What if you just wanted an app that allows
you to browse and select your own locally stored wallpapers and lets you manage and set wallpapers
from there? then Peristyle is for you :)
## Features
- Simple architecture, browse wallpapers and use system wallpaper manager to set them as wallpaper.
- Multiple folders support.
- Ability to assign Tags to any wallpaper.
- Can scan .nomedia directories, useful if you want to keep your wallpapers away from gallery.
- Apply blur and color filters dynamically on any wallpaper before applying.
- Simple yet pretty animations with proper optimizations.
- Compress or reduce images on the fly.
- No ads, no tracking, no analytics, no internet permissions, no unnecessary permissions.
- Auto wallpaper change support with dedicated folders and tags for each screens.
- Change wallpaper using app's live wallpaper
- Edit and apply filters on wallpapers losslessly in realtime.
- Built-in live wallpaper picker.
- Dark mode support.
- Glassmorphic UI based on realtime blur effects and caustic shadows.
- Material You color theme.
- Fully reproducible build.
- Zero loading software architecture.
## Stats
## Download
[](https://github.com/Hamza417/Peristyle/releases/latest)
[](https://f-droid.org/en/packages/app.simple.peri/)
[](https://apt.izzysoft.de/fdroid/index/apk/app.simple.peri/)
## Screenshots
|  |  |  |
|:-----------------------------------------------------------------------:|:-----------------------------------------------------------------------:|:-----------------------------------------------------------------------:|
|  |  |  |
|  |  |  |
|  |  |  |
### Peristyle also has a separate UI based on Material You
The legacy interface is planned to be removed in v8.0.0.
|  |  |  |
|:----------------------------:|:----------------------------:|:----------------------------:|
|  |  |  |
## Triggering AutoWallpaperService from Other Apps
Peristyle supports triggering the AutoWallpaperService from other apps using the following
intent: `app.peristyle.START_AUTO_WALLPAPER_SERVICE`
**_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._**
## Permission Usage
Peristyle needs `MANAGE_EXTERNAL_STORAGE` and `READ_MEDIA_IMAGES` to be allowed to show the system
wallpapers in the app.
It has been discussed in
the [Issue #72](https://github.com/Hamza417/Peristyle/issues/72#issuecomment-2357558761).
The `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` is used to run Auto Wallpaper service whenever required.
And an access to all the wallpaper directories whichever the user specifies.
## Translate
[](https://crowdin.com/project/peristyle)
Peristyle supports localization, If you want to
translate Peristyle in your language/s, you can do
so [here on Crowdin](https://crowdin.com/project/peristyle).
[Contributors](https://crowdin.com/project/peristyle/members)
## License
```
Copyright 2023 Hamza Rizwan
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```