coldp/todaywallpaper

TodayWallpaper is an Android app that presents wallpapers in a calendar-style layout, letting you browse images organized by date. Instead of a standard grid or list, the home screen is built around a date-driven view where you can scroll through wallpapers as if flipping through a calendar. The app also offers curated categories organized by theme and style, so you can browse by subject rather than by date if you prefer. You can save wallpapers to personal collections and build custom albums from your favorites. The interface supports both Chinese and English. A search feature lets you look up wallpapers by keyword, pulling results from the Pexels photo API, which is a library of free stock photography. The app is built with Kotlin and uses Jetpack Compose, Android's modern UI toolkit, along with Material 3 for the visual design. It follows the MVVM (Model-View-ViewModel) architecture pattern common in Android development. Networking is handled with Retrofit and OkHttp, image loading with a library called Coil, and local data storage with Room, which is Android's built-in database layer. The minimum supported Android version is SDK 24, which corresponds to Android 7.0. To build it from source, you need Android Studio Narwhal (2025.1 or newer) and JDK 11 or later. Building a release version requires signing credentials provided as environment variables. The project is MIT licensed and includes a list of the third-party libraries it depends on.