> [!IMPORTANT] > This app is under heavy development currently.
# WeekFocus **One word. One week. One quality to grow.** Get it on Obtainium [![Release](https://img.shields.io/gitea/v/release/Schanbro/WeekFocus?gitea_url=https://git.schamagusa.de&label=Release)](https://git.schamagusa.de/Schanbro/WeekFocus/releases) [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue)](LICENSE) [![Translation status](https://weblate.schamagusa.de/widgets/weekfocus/-/svg-badge.svg)](https://weblate.schamagusa.de/engage/weekfocus/) ![Android 8.0+](https://img.shields.io/badge/Android-8.0%2B-3DDC84?logo=android&logoColor=white) ![Kotlin](https://img.shields.io/badge/Kotlin-7F52FF?logo=kotlin&logoColor=white) ![Jetpack Compose](https://img.shields.io/badge/Jetpack%20Compose-4285F4?logo=jetpackcompose&logoColor=white) ![Stars](https://img.shields.io/gitea/stars/Schanbro/WeekFocus?gitea_url=https://git.schamagusa.de) ![Forks](https://img.shields.io/gitea/forks/Schanbro/WeekFocus?gitea_url=https://git.schamagusa.de) ![Open issues](https://img.shields.io/gitea/issues/open/Schanbro/WeekFocus?gitea_url=https://git.schamagusa.de) ![Last commit](https://img.shields.io/gitea/last-commit/Schanbro/WeekFocus?gitea_url=https://git.schamagusa.de)
--- ## Table of Contents - [About](#about) - [How It Works](#how-it-works) - [Features](#features) - [Screenshots](#screenshots) - [Installation](#installation) - [Building from Source](#building-from-source) - [Contributing](#contributing) - [License](#license) - [Translations](#translations) ## About WeekFocus is a minimalist Android app built around a simple idea: personal growth works best in small, focused steps. Each week, a single positive quality, such as *patience*, *gratitude* or *courage*, is displayed as one word on a home screen widget. Throughout the week, you consciously focus on living that quality. When the week ends, a new one takes its place. No streaks, no pressure, no clutter. Just a gentle daily reminder of what you want to cultivate. ## How It Works 1. **Add the widget** to your home screen. 2. **See your quality of the week** every time you unlock your phone. 3. **Focus on it** in your daily life for seven days. 4. **Next week**, a new quality appears and the cycle continues. ## Features - 🧩 Home screen widget showing your current quality of the week - 🔄 Automatic weekly rotation to a new quality - 🌙 Light and dark theme support - 🔒 No ads, no tracking, no unnecessary permissions - ⚡ Lightweight and battery-friendly ## Screenshots ## Installation ### Recommended: Obtainium With [Obtainium](https://github.com/ImranR98/Obtainium) you get updates directly from this repository, no app store required. 1. Install Obtainium on your Android device. 2. Tap the badge above or open this link: [Add WeekFocus to Obtainium](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://git.schamagusa.de/Schanbro/WeekFocus) 3. Confirm and install the app. Alternatively, tap **Add App** in Obtainium and paste this URL: ``` https://git.schamagusa.de/Schanbro/WeekFocus ``` ### Manual APK Install 1. Open the [Releases](https://git.schamagusa.de/Schanbro/WeekFocus/releases) page. 2. Download the latest `.apk` file. 3. If prompted, allow installation from unknown sources, then install the APK. ## Building from Source **Requirements** - [Android Studio](https://developer.android.com/studio) (latest stable) - JDK 17 or newer **Steps** ```bash git clone https://git.schamagusa.de/Schanbro/WeekFocus.git cd WeekFocus ./gradlew assembleDebug ``` The resulting APK is located in `app/build/outputs/apk/debug/`. ## Contributing Contributions are welcome! 1. Fork the repository 2. Create a feature branch: `git checkout -b feature/my-feature` 3. Commit your changes: `git commit -m "Describe your change"` 4. Push the branch: `git push origin feature/my-feature` 5. Open a merge request Found a bug or have an idea? Please open an [issue](https://git.schamagusa.de/Schanbro/WeekFocus/issues). ## License This project is licensed under the [GNU General Public License v3.0](LICENSE) (GPL-3.0). You are free to use, modify and redistribute this software under the terms of the GPLv3. Derivative works must be released under the same license. ## Translations WeekFocus is translated via [Weblate](https://weblate.schamagusa.de/engage/weekfocus/). Help translate the app into your language! [![Translation status](https://weblate.schamagusa.de/widgets/weekfocus/-/multi-auto.svg)](https://weblate.schamagusa.de/engage/weekfocus/)