Sessions

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 26 Open GitHub ↗

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.

// 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

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README