discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens

Benji377/Timety · source

Snapshot 0 · 2026-11-04T12:47:28Z · Kotlin · GPL-3.0

GitHub description at capture

An offline-first Android app uniting tasks, focus timers, and habit tracking

README at capture

# Timety

<p align="center">
  <img src="assets/banner_small.png" alt="Timety banner">
  <p align="center">
    <a href="https://github.com/Benji377/Timety/actions/workflows/ci.yml">
      <img src="https://img.shields.io/github/actions/workflow/status/Benji377/Timety/ci.yml?label=Lint&logo=kotlin&style=for-the-badge&labelColor=555555" alt="lint">
    </a>
    <a href="https://github.com/Benji377/Timety/actions/workflows/dependency-submission.yml">
      <img src="https://img.shields.io/github/actions/workflow/status/Benji377/Timety/dependency-submission.yml?label=Dependencies&logo=githubactions&style=for-the-badge&labelColor=555555" alt="test">
    </a>
    <a href="https://github.com/Benji377/Timety/releases">
      <img src="https://img.shields.io/github/downloads/Benji377/Timety/total?label=Downloads&logo=github&style=for-the-badge&labelColor=555555" alt="downloads">
    </a>
    <br>
    <a href="https://tally.so/r/ODbEoA">
      <img src="https://img.shields.io/badge/Feedback-Tally-8B5CF6?style=for-the-badge&labelColor=555555" alt="feedback">
    </a>
    <a href="https://crowdin.com/project/timety">
      <img src="https://img.shields.io/badge/Translate-Crowdin-2E3340?style=for-the-badge&logo=crowdin&logoColor=white&labelColor=555555" alt="translate">
    </a>
    <a href="mailto:apptimety@gmail.com">
      <img src="https://img.shields.io/badge/Email-Contact-EA4335?style=for-the-badge&logo=gmail&logoColor=white&labelColor=555555" alt="email">
    </a>
  </p>
</p>

Timety is an offline-first productivity and time-management application built with Kotlin for Android. It integrates Task Management, Focus Sessions, and Habit Tracking into one beautiful experience.

<p align="center">
  <img src="screenshots/output/01_home_screen.png" width="32%" alt="Home Screen">
  <img src="screenshots/output/02_focus_screen.png" width="32%" alt="Focus Screen">
  <img src="screenshots/output/03_tasks_screen.png" width="32%" alt="Habits Screen">
</p>
<p align="center">
  <em>View the <a href="screenshots/output/">full screenshot gallery</a> to see the calendar, analytics, profile, and more!</em>
</p>

## Features

*   **Intelligent Task Management:** Organize one-off tasks with due dates, priority levels, and effort sizes.
*   **Focus Engine:** A robust stopwatch and timer system tailored for deep work. Includes support for tags, custom modes, and short/long break phases.
*   **Habit Tracker:** Build lasting routines with flexible frequencies (daily, specific weekdays, or flexible weekly goals).
*   **Rich Analytics:** Visualize your productivity with interactive charts, weekly velocity metrics, and time-of-day habit analysis.
*   **Smart Notifications:** Local reminders for tasks, specific habit times, and dynamic daily motivation.
*   **Unified Calendar:** A custom micro-dot calendar view to see your tasks, focus sessions, and habits at a glance.
*   **Mood Calendar:** Rate each day from the evening check-in or your profile, and see a month of moods and your all-time split at a glance.

## Download & Installation

> [!TIP]
> 🇨🇳 **Users in China:** Having trouble downloading or updating? See the [China Download & Update Guide (F-Droid Mirrors)](https://github.com/Benji377/Timety/discussions/81)

Choose your preferred way to stay productive.

<p align="left">
  <a href="https://f-droid.org/packages/io.github.benji377.timety">
    <img src="assets/badges/badge_fdroid.png"
      alt="Get it on F-Droid"
      height="50">
  </a>
  <a href="https://play.google.com/store/apps/details?id=io.github.benji377.timety">
    <img src="assets/badges/badge_google.png" 
      alt="Get it on Google Play" 
      height="50">
  </a>
  <a href="https://github.com/Benji377/Timety/releases/latest">
    <img src="assets/badges/badge_github.png"
      alt="Get it on GitHub"
      height="50">
  </a>
  <a href="https://sourceforge.net/p/timety/">
    <img src="assets/badges/badge_sourceforge.png" 
      alt="Get it on SourceForge" 
      height="50">
  </a>
</p>

### Manual Installation (GitHub Releases)

1. Go to the **[GitHub Latest Release Page](https://github.com/Benji377/Timety/releases/latest)**.
2. Scroll down to the **Assets** section.
3. Download the `.apk` file (the universal APK works on all devices).
   *(Note: The `.aab` file is for app stores and bundle installers; most users should download the `.apk`)*

> [!NOTE]
> **APK Verification (SHA-256)**
> To ensure the authenticity of the APK downloaded from GitHub, you can verify its signing certificate fingerprint matches the following: \
> `a12e4cf83cbbdf2c4a33edf58c4866ba3763d7d4e83a40f35126e5bea41a5526`
> 
> *For independent verification, this same hash is also publicly recorded at the bottom of the official [F-Droid build manifest](https://gitlab.com/fdroid/fdroiddata/tree/master/metadata/io.github.benji377.timety.yml).*

#### **How to install:**
1. Download the `.apk` file.
2. Open the file on your Android device.
3. If prompted, enable "Install from Unknown Sources" in your settings.
4. Follow the on-screen instructions to finish.

## Installation and Setup

### Prerequisites
*   Android Studio
*   Java 17
*   Android SDK

### Build Instructions

1.  Clone the repository:
    ```bash
    git clone https://github.com/Benji377/Timety.git
    cd Timety
    ```

2.  Open the project in Android Studio.

3.  Sync Gradle dependencies.

4.  Run the application on an emulator or a physical device:
    ```bash
    ./gradlew installDebug
    ```

## Development & Roadmap

Want to see what's coming next or contribute to Timety?

Check out the **[Timety GitHub Project Board](https://github.com/users/Benji377/projects/7)**! There, you can track the live status of all planned features, bugs, and enhancements, complete with priority tags and issue sizing.

## Community & Discussions

Join the conversation! Whether you need help, want to share how you use Timety, or have a brilliant idea for a new feature, our **[GitHub Discussions](https://github.com/Benji377/Timety/discussions)** is the place to be.

* **📢 Announcements:** Stay up to date with the latest releases and major changes.
* **💡 Ideas:** Suggest and vote on new features you'd love to see.
* **🙏 Q&A:** Ask questions and get help from the community or the developer.

## Translations

Help us bring Timety to your native language! We use Crowdin to manage our localization, making it incredibly easy to contribute translations without touching any code.

How to contribute:
1. Visit the **[Timety Crowdin Project](https://crowdin.com/project/timety)**.
2. Select your language and start translating!
3. If your language isn't listed, feel free to request it directly on Crowdin.

*Note: If you ever need context for a specific word or phrase, drop by our GitHub Discussions and ask!*

## Timety in the press

Timety has been featured by bloggers and writers around the world, and I'm very grateful for it! 
Have a look at the [press & mentions page](PRESS.md) to see what others have written, or [let me know](../../issues/new?template=press-article.yml) if you wrote about Timety yourself.


## Privacy
Timety is proudly **Offline-First**. All of your tasks, habits, and focus history are stored securely on your local device using Room. No accounts, no cloud sync, no tracking.