# WeekFocus
**One word. One week. One quality to grow.**
[](https://git.schamagusa.de/Schanbro/WeekFocus/releases)
[](LICENSE)
[](https://weblate.schamagusa.de/engage/weekfocus/)







---
## 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!
[](https://weblate.schamagusa.de/engage/weekfocus/)