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




[](https://git.schamagusa.de/Schanbro/WeekFocus/issues)
[](https://git.schamagusa.de/Schanbro/WeekFocus)
---
## Table of Contents
- [About](#about)
- [How It Works](#how-it-works)
- [Features](#features)
- [Installation](#installation)
- [Building from Source](#building-from-source)
- [Releases](#releases)
- [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
## 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.
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
- Android SDK platform 37 (`minSdk` 29, `targetSdk` 37)
**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/`.
## Releases
Releases are built automatically with Gitea Actions. Pushing a tag that starts with `v` triggers the workflow, which builds and signs the APK and publishes it as a release together with the notes from `CHANGELOG.md`.
### Starting a release build
Create a tag and push it. The tag name determines the app version (`v1.1.3` builds version `1.1.3`):
```bash
git tag v1.1.3
git push origin v1.1.3
```
You can follow the build under **Actions** in the repository. When it finishes, the signed `WeekFocus-1.1.3.apk` appears on the [Releases](https://git.schamagusa.de/Schanbro/WeekFocus/releases) page.
### Release notes
The workflow takes the notes from the section of `CHANGELOG.md` whose heading starts with the version number:
```markdown
## 1.1.3
- Added Weblate translations
- Fixed widget update at the start of a new week
```
If no matching section exists, the release gets a short placeholder text instead.
## 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!~~
If you want to contribute with translation you would have to fork this repository, translate into the files directly and make an pull request back to this repository.