44 lines
1.7 KiB
Markdown
44 lines
1.7 KiB
Markdown
# pomodoro-mode
|
|
|
|
Add a simple [pomodoro](https://en.wikipedia.org/wiki/Pomodoro_Technique) timer to your Emacs mode-line.
|
|
|
|
Defaults to `🍅 (MM:SS)` when working and `🥫 (MM:SS)` when taking a break.
|
|
|
|
## Installation
|
|
|
|
The package can be manually installed by saving `pomodoro-mode.el` to `~/emacs.d/` or wherever your emacs configuration is stored and load the package with
|
|
```cl
|
|
(add-to-list 'load-path "~/.emacs.d/") ; Adjust this path if necessary
|
|
|
|
(require 'pomodoro-mode)
|
|
```
|
|
|
|
In Emacs 30.1 and above, `use-package` works well with version control, allowing the following
|
|
```cl
|
|
(use-package pomodoro-mode
|
|
:ensure (pomodoro-mode :url "https://git.jjanzen.ca/jjanzen/pomodoro-mode"))
|
|
```
|
|
|
|
## Usage
|
|
|
|
- Start a pomodoro session with `M-x pomodoro-mode`.
|
|
- Stop a pomodoro session with `M-x pomodoro-mode`.
|
|
- Move to the next work or break period with `M-x pomodoro-toggle-state`.
|
|
|
|
## Customization
|
|
|
|
This is a simple package that doesn't do much. That being said, you can customize some aspects of the mode:
|
|
- `pomodoro-work-time`: the number of seconds in a work session; defaults to 1500 (25 minutes)
|
|
- `pomodoro-break-time`: the number of seconds in a break session; defaults to 300 (5 minutes)
|
|
- `pomodoro-work-symbol`: the string to display while in a work session; defaults to 🍅
|
|
- `pomodoro-break-symbol`: the string to display while in a break session; defaults to 🥫
|
|
|
|
These can be customized with `M-x customize-group` in the `pomodoro` group. Alternatively, you can modify your `init.el` file to set the variables with `setq`.
|
|
|
|
## Contributing
|
|
|
|
Feel free to publish issues or create pull requests if you have suggestions on how to improve this package.
|
|
|
|
## License
|
|
|
|
Distributed under the GNU General Public License v3.0. See `LICENSE` for more information.
|