pomodoro-timer

KO | EN

gitlite — search

#react #llm #go #machine-learning #rust #deep-learning #java #windows #cli #kubernetes #vue #security #openai #mcp

(★ 11)

A sleek GNOME Shell extension for productivity using the Pomodoro Technique.

pomodoro-timer Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>Pomodoro Timer</h1>

A simple and effective Pomodoro timer for GNOME Shell
 Stay focused, take breaks, and track your productivity — right from the top panel.

</div>

---

## Overview

Pomodoro Timer is a **full-featured productivity extension** for GNOME Shell built around the [Pomodoro Technique](https://en.wikipedia.org/wiki/Pomodoro_Technique).

It lives in your top panel and gives you timer controls, task management, focus mode with wallpaper switching and Do Not Disturb, session statistics with charts, configurable keyboard shortcuts, sound notifications, idle detection, and a suspend inhibitor — all without leaving your desktop.

> Whether you're deep in a coding session or studying for exams, Pomodoro Timer keeps you on track with minimal friction.

---

## Gallery

<table>
 <tr>
 <td align="center" width="50%">
 <img src="assets/Screenshots/dropdown.png" alt="Dropdown Menu" width="100%" style="border-radius: 8px;">
 Panel Dropdown
 </td>
 <td align="center" width="50%">
 <img src="assets/Screenshots/behavior_configs.png" alt="Behavior Settings" width="100%" style="border-radius: 8px;">
 Behavior Settings
 </td>
 </tr>
 <tr>
 <td align="center" width="50%">
 <img src="assets/Screenshots/Focus_Mode_Configs.png" alt="Focus Mode Settings" width="100%" style="border-radius: 8px;">
 Focus Mode
 </td>
 <td align="center" width="50%">
 <img src="assets/Screenshots/Statistics.png" alt="Statistics" width="100%" style="border-radius: 8px;">
 Statistics
 </td>
 </tr>
 <tr>
 <td align="center" width="50%">
 <img src="assets/Screenshots/Tasks.png" alt="Tasks" width="100%" style="border-radius: 8px;">
 Tasks
 </td>
 <td align="center" width="50%">
 <img src="assets/Screenshots/appearance_configs.png" alt="Appearance Settings" width="100%" style="border-radius: 8px;">
 Appearance
 </td>
 </tr>
 <tr>
 <td align="center" width="50%">
 <img src="assets/Screenshots/About.png" alt="About Page" width="100%" style="border-radius: 8px;">
 About
 </td>
 </tr>
</table>

---

## Features

### Timer

- **Adjustable Durations** — Work, Short Break, Long Break, and intervals per set
- **Auto-start** — Optionally auto-start breaks after work and work after breaks
- **Session Persistence** — Timer state survives screen lock/unlock cycles
- **System Notifications** — Get notified when work sessions and breaks end
- **Minimal Panel UI** — Timer hidden when idle, shown only when running

### Focus Mode

- **Wallpaper Switching** — Automatically change your wallpaper during work sessions
- **5 Built-in Wallpapers** — Anime, Cloudscape, Dark Academia, Forest, Minecraft
- **Custom Wallpaper** — Use any image from your system
- **Do Not Disturb** — Suppress notification banners during focus
- **Mute Sounds** — Silence system event sounds while working

### Task Management

- **Create Tasks** — Add tasks with title, difficulty (1–10), and estimated pomodoros
- **Repeated Tasks** — Tasks that stay active and reset progress on completion
- **Auto-complete** — Optionally complete tasks when estimated pomodoros are reached
- **Track Progress** — See pomodoro progress per task in real time
- **Assign to Sessions** — Link tasks to your current timer session
- **Task History** — Completed tasks are archived with timestamps

### Statistics

- **Session Tracking** — Total sessions, total hours, streaks, efficiency score
- **Task Stats** — Tasks completed, average difficulty, average pomodoros per task
- **Visual Charts** — Bar charts for last 7 days, 4 weeks, and 12 months
- **Persistent Data** — Stats survive extension restarts and updates

### Keyboard Shortcuts

- **Start / Pause** — Toggle the timer with a global keybinding
- **Skip Interval** — Jump to the next interval
- **Reset / Reset All** — Reset current interval or the entire session
- **Configurable** — Set your own key combinations in preferences (modifier key required)

### Sounds

- **Event Sounds** — Audio alerts when the timer starts and completes
- **Tick Sound** — Optional ticking sound while running
- **Separate Volumes** — Independent volume controls for events and ticking

### Mouse Shortcuts

| Click | Action |
|-------|--------|
| Left-click | Open dropdown menu |
| Right-click | Start / Pause timer |
| Middle-click | Skip current interval |

### System Integration

- **Suspend Inhibitor** — Keeps your system awake during pomodoros
- **Away from Desk Detection** — Detects when you leave during a session. Auto-pause mode pauses the timer; ask-on-return mode lets you keep or discard elapsed time
- **System Theme Support** — Blend with GNOME theme colors instead of the default red

---

## Installation

### From GNOME Extensions (Recommended)

> The EGO version may lag behind the latest release. For the newest version, see [GitHub Releases](https://github.com/Oguzhankokulu/pomodoro-timer/releases).

### From GitHub Release

1. Download the latest `.zip` from [Releases](https://github.com/Oguzhankokulu/pomodoro-timer/releases)
2. Install:

```bash
# Extract and move to extensions directory
unzip pomodoro-timer@Oguzhankokulu.github.com.zip -d pomodoro-timer@Oguzhankokulu.github.com
mv pomodoro-timer@Oguzhankokulu.github.com ~/.local/share/gnome-shell/extensions/

# Enable (logout/login required on Wayland)
gnome-extensions enable pomodoro-timer@Oguzhankokulu.github.com
```

### From Source

```bash
# Clone
git clone https://github.com/Oguzhankokulu/pomodoro-timer.git
cd pomodoro-timer

# Rename and install
mv ../pomodoro-timer ../pomodoro-timer@Oguzhankokulu.github.com
cp -r ../pomodoro-timer@Oguzhankokulu.github.com ~/.local/share/gnome-shell/extensions/

# Compile schemas
glib-compile-schemas ~/.local/share/gnome-shell/extensions/pomodoro-timer@Oguzhankokulu.github.com/schemas/

# Enable (logout/login required on Wayland)
gnome-extensions enable pomodoro-timer@Oguzhankokulu.github.com
```

### Updating via Git

```bash
cd ~/.local/share/gnome-shell/extensions/pomodoro-timer@Oguzhankokulu.github.com
git pull
glib-compile-schemas schemas/
# Restart GNOME Shell (logout/login on Wayland)
```

---

## Customization

### Custom Icon

Replace the panel icon by swapping `assets/images/fruit.png` or `assets/images/coffee.png` with your own **16×16 pixel** PNG image. Keep the same filename.

### Settings

Open preferences via the dropdown menu, Extension Manager, or command line:

```bash
gnome-extensions prefs pomodoro-timer@Oguzhankokulu.github.com
```

---

## ❤️ Support Development

Pomodoro Timer is free and open-source. If it helps you stay productive, consider buying me a coffee.

---

Made with ❤️ by <a href="https://github.com/Oguzhankokulu">Oguzhan Kokulu</a> &nbsp;·&nbsp; GPL-3.0

pomodoro-timer

pomodoro-timer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

pomodoro-timer

pomodoro-timer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README