Hammy.el 使用教程

Hammy.el 使用教程

hammy.elProgrammable, interactive interval timers (e.g. for working/resting)项目地址:https://gitcode.com/gh_mirrors/ha/hammy.el

项目介绍

Hammy.el 是一个为 Emacs 设计的可编程交互式间隔计时器。它允许用户轻松定义自己的计时器（称为“hammys”），并可以根据需要集成到其他程序中。Hammy.el 主要用于交替工作与休息时段，提醒用户伸展腿部等。该项目在 GitHub 上开源，遵循 GPL-3.0 许可证。

项目快速启动

安装

Hammy.el 可以通过 MELPA 安装，也可以通过 quelpa-use-package 安装：

;; 通过 MELPA 安装
M-x package-install RET hammy RET

;; 通过 quelpa-use-package 安装
(use-package hammy
  :quelpa (hammy :fetcher github :repo "alphapapa/hammy.el"))

基本使用

定义一个简单的 Pomodoro 计时器：

(hammy-define "🍅"
  :documentation "Pomodoro 计时器"
  :intervals
  (list
   (interval "工作" :duration 25 :units 'minutes)
   (interval "休息" :duration 5 :units 'minutes)))

启动计时器：

M-x hammy-start RET "🍅" RET

应用案例和最佳实践

预防 RSI 的定时器

定义一个定时器，提醒用户每隔一段时间站起来伸展腿部：

(hammy-define "Move"
  :documentation "Don't forget to stretch your legs"
  :intervals
  (list
   (interval "站立" :duration 10 :units 'minutes)
   (interval "坐下" :duration 50 :units 'minutes)))

自定义模式行显示

自定义模式行显示，以便更清晰地看到当前计时器的状态：

(setq hammy-mode-lighter-seconds-format "%M:%S")

典型生态项目

Org-mode 集成

Hammy.el 可以与 Org-mode 集成，实现更复杂的任务管理和时间跟踪：

(defun my/hammy-org-clock-in ()
  (interactive)
  (hammy-start "🍅")
  (org-clock-in))

其他 Emacs 插件

Hammy.el 可以与其他 Emacs 插件如 alert.el 结合，实现更多样化的提醒方式：

(require 'alert)

(defun my/hammy-alert ()
  (alert "Time to take a break!" :category 'hammy))

(add-hook 'hammy-interval-end-hook 'my/hammy-alert)

通过这些集成和扩展，Hammy.el 可以更好地适应用户的个性化需求。

hammy.elProgrammable, interactive interval timers (e.g. for working/resting)项目地址:https://gitcode.com/gh_mirrors/ha/hammy.el