An unofficial Unsplash client for Android, built with modern Android development tools.
Plashr is a modern Android application for browsing the vast collection of beautiful photos from Unsplash. This is an unofficial client and is not created by or affiliated with Unsplash.
Organize your favorite photos into collections, like photos from other users, and view them in stunning detail.
- 🖼️ Browse and search for high-quality photos.
- 🔍 View photo details, including EXIF data.
- ❤️ Like photos and add them to your profile.
- 📂 Create and manage photo collections.
- 👤 View user profiles, including their photos, likes, and collections.
- 🔄 Infinite scrolling powered by the Unsplash API.
Plashr is built using the latest Android development technologies:
- UI: Jetpack Compose for a modern, declarative UI.
- Language: 100% Kotlin.
- Asynchronicity: Coroutines and Flow for managing background threads and data streams.
- Architecture: MVVM (Model-View-ViewModel) with Android Architecture Components (ViewModel, Paging 3).
- Dependency Injection: Hilt for managing dependencies.
- Networking: Retrofit for making API calls to the Unsplash service.
To build the app, you will need to get an API key from Unsplash.
- Register for a developer account at unsplash.com/developers to obtain your API credentials.
- Create a file named
apikey.propertiesin the root directory of the project. - Add your Unsplash API credentials to the
apikey.propertiesfile:
client_id="<Your Unsplash Access Key>"
client_secret="<Your Unsplash Secret Key>"
callback_url="<Your Unsplash Callback URL>"This project uses Firebase Crashlytics and Analytics for crash reporting and usage statistics.
- Go to the Firebase console and create a new project.
- Follow the setup guide to add an Android app to your project.
- Once the app is registered, download the
google-services.jsonconfiguration file and place it in theapp/directory.
A big thank you to Unsplash for providing the amazing photo API that powers this app.
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
Please refer to the privacy policy.