Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Nriver/tomato-timer-widget

Pomodoro timer widget for Trilium Notes. Trilium 的番茄钟插件
https://github.com/Nriver/tomato-timer-widget

trilium trilium-plugin trilium-widget

Last synced: about 1 month ago
JSON representation

Pomodoro timer widget for Trilium Notes. Trilium 的番茄钟插件

Awesome Lists containing this project

README

        

# tomato-timer-widget :)

[中文说明](README_CN.md)

Please stand up and stretch your body for a while if you see this :)

[![Support Me on Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/nriver)

**Enhance Your Productivity**

Try out the Pomodoro Technique with the Trilium Notes widget. Don't forget to take breaks for yourself!

Learn more about the [Pomodoro Technique](https://en.wikipedia.org/wiki/Pomodoro_Technique) if you're unfamiliar with
it.

# ScreenShots

## Overall Look (Subject to Change)

![overall look](docs/at%20a%20glance.gif)

## Work with zen mode

I recently find out that this tomato timer can work with [Zen Mode](https://github.com/Nriver/awesome-trilium/issues/44) very well. You should try it :)

![work with zen mode](docs/work%20with%20zen%20mode.png)

## Break Time!

![break](docs/take%20a%20break.gif)

## System Notifications

* Windows:

![windows](docs/notification%20windows.gif)

* Linux desktop:

![linux](docs/notification%20linux.gif)

## Multi-language support

English

![english](docs/ui%20english.png)

简体中文 Chinese Simplified

![chinese](docs/ui%20chinese.png)

# How to install

1. Download the zip file from [release page](https://github.com/Nriver/tomato-timer-widget/releases).
2. Right click note tree in Trilium and click import, uncheck `Safe Import`.
3. Restart Trilium Notes or use `ctrl+r` to reload the interface.
4. Open any note, you will see a timer bar underneath.
5. Have fun.

# Hints

1. You can tweak configs in the `config` subnote.
2. i18n support, check the `translations` subnote for the translated texts.
3. There will be a notification tells you to rest :)
4. Buttons comes with sound effects so does the notification alarm.

# Why I made this?

I was diagnosed with lumbar disc herniation in October 2023. According to the doctors, the herniation is huge. Although
the chief physician strongly suggested that I undergo surgery immediately, I refused it, at least for now.

I'm currently undergoing conservative treatment and hoping for improvement. I understand that this is a long-term battle
and that there are many measures I need to take. According to my physical therapist, I should stand up and stretch every
30 minutes after sitting. It occurred to me later that
the [Pomodoro Technique](https://en.wikipedia.org/wiki/Pomodoro_Technique) follows a similar schedule: 25 minutes of
work followed by a 5-minute break. This approach aligns perfectly with my treatment plan.

I use Trilium Notes throughout the day, so creating a Pomodoro timer for Trilium seemed like a natural idea. I've been
using this timer actively during my treatment. I believe it's important to take breaks and rest your body after
prolonged periods of sitting.

Hopefully, this can help prevent others from developing lumbar disc herniation.

# About the audio files

The audio used in this project is obtained from Pixabay, a vibrant community of creators sharing royalty-free images, video, audio, and other media. I appreciate their contribution and the availability of this resource. Below is the information related to the audio content:

https://pixabay.com/sound-effects/button-124476/

https://pixabay.com/sound-effects/ding-47489/

This content is used in accordance with the Pixabay Content License, which allows for free use, modification, and adaptation of the content into new works. However, certain restrictions apply, and it is the user's responsibility to adhere to the terms of the license. Please refer to the full Content License for more details.

I respect the work of creators and encourage others to do the same.

# Donation

Hello! If you appreciate my creations, kindly consider backing me. Your support is greatly appreciated. Thank you!

Ko-fi:
[![Support Me on Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/nriver)

Alipay:
![Alipay](https://github.com/Nriver/trilium-translation/raw/main/docs/alipay.png)

Wechat Pay:
![Wechat Pay](https://github.com/Nriver/trilium-translation/raw/main/docs/wechat_pay.png)