Kasper

<p align="center"> <img width = 200 src=https://github.com/TriStaRvOiD/Kasper/assets/58824912/c148b06f-7e49-429f-b429-4180e5881ad1> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <img width=200 src=https://github.com/TriStaRvOiD/Kasper/assets/58824912/d803283c-46d9-4654-907e-5aba1c17b521> </p>

A pedometer/health app written in Kotlin and Jetpack Compose

This app is not feature complete. Feature requests and contributions are more than welcome!

Installation

1. Clone the repository to your local machine: git clone https://github.com/TriStaRvOiD/Kasper.git
2. Open the project in Android Studio.
3. Build the project:
   • Click on the “Build” menu.
   • Select “Build Project” or press Ctrl + F9 (Windows/Linux) or Cmd + F9 (Mac).
4. Connect a physical device or use an emulator:
   • Make sure your device is connected via USB and has Developer Mode enabled.
   • Alternatively, use an Android emulator from Android Studio.
5. Run the app:
   • Click on the “Run” menu.
   • Select “Run app” or press Shift + F10 (Windows/Linux) or Ctrl + R (Mac).
6. The app should now be running on your device or emulator.

Configuration

You will need to manually provide your own OpenWeatherMap API key.

Concepts

• The app uses Android's step detection sensor
• The Room library acts as a local database for storing the user's steps along with the corresponding date.
• Weather information is fetched through Retrofit

Contributions

I am anything but a seasoned developer, and my coding skills are not spectacular at the moment; so, contributions are truly appreciated.

Translations

Unfortunately this app currently only supports English, however this will most likely change in the future.

License

This application's code is available under a GPL v3 license. This excludes the icons, fonts, logos, assets and animations used.

Notice

This application's logo was created using AI (Bing Image Generator)

Attribution

• This application uses animations from https://lottiefiles.com
• This application uses icons from https://fonts.google.com
• This application uses the "Josefin Sans" font family from https://fonts.google.com
• This application uses OpenWeatherMap's Apis