hoppjan / luebeck-mensa-widget

Android Widget for the Menu of Mensa Lübeck
Apache License 2.0
7 stars 0 forks source link
android android-widget kotlin kotlin-android

Lübeck Mensa Widget

Release Build Status GitHub release (latest by date) Apache 2.0 Licence

Lübeck Mensa Widget is an Android application that displays the menu of the cafeteria and mensa located in the university district of Lübeck. The app only provides a widget for users to access the daily menu directly from their device's home screen.

Screenshot showing the widget displaying the menu

Installation

  1. Download the APK file from the release section of this repository.
  2. Enable the installation of apps from unknown sources on your Android device.
  3. Open the downloaded APK file and follow the on-screen instructions to install the application.
  4. Once installed, add the widget to your home screen by long-pressing on an empty space on the home screen and selecting Widgets. Then, locate the "Lübeck Mensa Widget" and drag it to your desired position on the home screen.

You can also get the app and its updates via Obtainium, but you will have to enable pre-releases for now:

<img alt="Get it on Obtainium" src="https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png" width=130 />

Build debug version

  1. Clone the project
  2. go into the repo
  3. execute ./gradlew app:assembleDebug

If you encounter any problems, fix them yourself (or open an issue)!

Release

When you want to create a new release, follow these steps:

  1. Update the versionName (e.g. 1.2.3) and increase the versionCode (e.g. 3) in app/build.gradle.kts
  2. Commit that change (git commit -am v1.2.3)
  3. Tag the commit (git tag v1.2.3). Make sure your tag name's format is v*.*.*
  4. Push the changes to GitHub (git push && git push --tags)
  5. Edit and publish the release draft created by the workflow in GitHub

After building successfully, the action will publish the release artifacts in a new release draft that will be created on GitHub with download links for the app.

Similar projects

Thanks