Sessions

KO | EN

gitlite — search

#react #typescript #llm #machine-learning #deep-learning #linux #macos #java #nodejs #windows #security #ios #openai #open-source

(★ 26)

Productivity timer app built with Kotlin, Jetpack Compose, Firebase, Room Database, and Material 3. Follows MVVM Clean Architecture to help users maximize focus with session tracking and analytics.

Sessions Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<br/>

<table border="0" width="100%">
    <tr>
        <td width="30%" align="center" valign="middle">
            <img src="graphics/Icon.png" width="180" alt="Sessions App Icon"/>
        </td>
        <td width="70%" valign="middle">
            <h1>Sessions</h1>
            <h3>Your Personal Focus Companion</h3>
            <p><i>Precision-engineered productivity application designed to help you master your time and maintain flow state.</i></p>
        </td>
    </tr>
</table>

<br/>

[Report Bug](https://github.com/MohammadAliUstad/Sessions/issues) · [Request Feature](https://github.com/MohammadAliUstad/Sessions/issues) · [Download Latest Release](https://github.com/MohammadAliUstad/Sessions/releases)

</div>

---

## Overview

Sessions transforms the concept of a simple timer into a comprehensive focus tool. Whether you're studying, coding, or writing, the application ensures your environment is optimized for concentration. It features a robust background service and intelligent reminder system that ensures your progress is tracked and your habits are maintained, even when life gets busy.

---

## ✨ Key Features

### Intelligent Focus Engine
- **Smart Reminders:** Intelligent check-ins that trigger if you've been away too long, helping you stay consistent.
- **Personalised Nudges:** Playful, unique reminders based on your actual task history and focus habits.
- **Customisable Cycles:** Define your exact Focus Duration, Break Duration, and Repetition count.
- **Smart Intervals:** Automatically calculates when to trigger a Long Break based on your completed sets.

### Immersive Audio Environment
- **Curated Ambience:** Includes 6 high-quality background sounds: Rain, Brown Noise, Fireplace, Library, Riverside, and Forest.
- **Adaptive Audio Ducking:** Background volume intelligently lowers during breaks and rises during focus sessions.
- **Sensory Feedback:** Integrated haptic feedback and sound effects confirm interactions without needing to look at the screen.

### Reliability & System Integration
- **Live Activity Support:** Persistent notification on the lock screen and status bar allows you to track progress at a glance.
- **Quick Actions:** Skip focus or break periods directly from the notification tray for seamless session control.
- **Background Stability:** Engineered to resist aggressive battery optimization, ensuring your timer never stops unexpectedly.

### Analytics & Personalization
- **Visual Insights:** Dedicated dashboard featuring heatmaps and metrics (Total Focus Time, Peak Productivity Hours).
- **Deep Theming:** 8 Color Themes (including Dynamic Material You), OLED Black Mode, and 6 Font options.
- **Identity System:** Choose from a variety of animated avatars and set a custom display name.

---

## 📱 Screenshots

<table width="100%">
  <tr>
    <td align="center" width="25%">
      <img src="screenshots/Timer.jpg" alt="Timer" width="100%"/>
      <br/><sub><b>Timer</b></sub>
    </td>
    <td align="center" width="25%">
      <img src="screenshots/Insights.png" alt="Insights" width="100%"/>
      <br/><sub><b>Insights</b></sub>
    </td>
    <td align="center" width="25%">
      <img src="screenshots/Dashboard.jpg" alt="Dashboard" width="100%"/>
      <br/><sub><b>Dashboard</b></sub>
    </td>
    <td align="center" width="25%">
       <img src="screenshots/Appearance.png" alt="Appearance" width="100%"/>
      <br/><sub><b>Appearance</b></sub>
    </td>
  </tr>
  <tr>
    <td align="center" width="25%">
      <img src="screenshots/Settings.png" alt="Settings" width="100%"/>
      <br/><sub><b>Settings</b></sub>
    </td>
    <td align="center" width="25%">
      <img src="screenshots/Open Source.png" alt="Open Source" width="100%"/>
      <br/><sub><b>Open Source</b></sub>
    </td>
    <td align="center" width="25%">
      <img src="screenshots/Edit Profile.png" alt="Edit Profile" width="100%"/>
      <br/><sub><b>Edit Profile</b></sub>
    </td>
    <td align="center" width="25%">
      <img src="screenshots/About.png" alt="About" width="100%"/>
      <br/><sub><b>About</b></sub>
    </td>
  </tr>
</table>

</div>

---

## Technical Architecture

Sessions is built using modern Android development standards, ensuring a codebase that is scalable, testable, and maintainable.

```text
Language:             Kotlin
UI Framework:         Jetpack Compose (Material 3)
Architecture:         MVVM + Clean Architecture
Dependency Injection: Koin
Local Database:       Room
Backend Services:     Firebase (Auth, Firestore)
Concurrency:          Kotlin Coroutines & Flow
Background Tasks:     WorkManager
```

### Tech Stack

* **Kotlin** - Modern, concise, and safe programming language.
* **Jetpack Compose** - Declarative UI toolkit for building native Android interfaces.
* **Material 3** - Latest Material Design system for beautiful, accessible UIs.
* **MVVM Architecture** - Separation of concerns for maintainable code.
* **Room Database** - Robust local data persistence.
* **WorkManager** - Reliable background task scheduling for smart reminders.
* **Firebase** - Cloud services for authentication and data sync.
* **Coroutines & Flow** - Asynchronous programming made simple.

---

## Setup & Installation

### Prerequisites

* Android Studio (latest version recommended)
* JDK 11 or higher
* Android SDK API 26+

### Steps

1. **Clone the Repository**
```bash
git clone https://github.com/MohammadAliUstad/Sessions.git
cd Sessions
```

2. **Firebase Configuration**
* Create a project in the [Firebase Console](https://console.firebase.google.com/)
* Download the `google-services.json` file
* Place the file in the `app/` directory of the project

3. **Build & Run**
* Open the project in Android Studio
* Sync Gradle files
* Select your target device/emulator
* Click Run ▶️

---

## 🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

---

## 📄 License

Distributed under the MIT License. See `LICENSE` file for more information.

---

## Contact & Support

If you encounter any issues or have suggestions for future updates, please open an issue on GitHub or contact the developer directly.

**Developer:** Mohammad Ali Ustad

**Email:** Mohammadaliustad@gmail.com

**Company:** Yugen Tech

### Show Your Support

If you find this project helpful, please consider giving it a ⭐!

</div>

---

<div align="center">
<sub>Built with ❤️ by Yugen Tech</sub>
</div>

Sessions

Sessions Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Sessions

Sessions Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README