org-reminders

org-reminders is an Emacs plugin designed to facilitate interactions between macOS Reminders and Org mode. The plugin allows you to manage reminders stored in macOS Reminders from within Org mode, providing a seamless experience for users who rely on both systems.

The project underwent a large-scale refactoring, with the old version maintained in the v1 ranch.

Features

• Automatic synchronization : Org Mode files and reminders sync automatically upon saving or updates, ensuring real-time data consistency across devices.
• Seamlessly mapping : Org Mode’s Todo functionality to Reminders’ core concepts for fluid conversion and compatibility.

0120.6.mp4

Detailed Video

https://youtu.be/RrR4EXZgYmU

Prerequisites

• org-reminders-cli : A CLI tool for syncing OS X Reminders with Emacs org-mode, designed to work with ginqi7/org-reminders.

Emacs dependencies

• websocket-bridge : A bridge that connects Emacs and Swift programs via WebSocket.
• emacs-websocket : A websocket implementation in elisp, for emacs.

Installation

reminders-cli

brew install ginqi7/formulae/org-reminders-cli

grant reminders access

When you encounter an error :

“error: you need to grant reminders access\n”

Running this command in Eshell will populate Emacs permissions.

osascript -e 'tell application "Reminders" to show (first list whose name is "blabla")'

package

• clone the project in your own emacs configuration files directory, like:

git clone git@github.com:ginqi7/org-reminders.git ~/.emacs.d/lisp/org-reminders
git clone git@github.com:ginqi7/websocket-bridge.git ~/.emacs.d/lisp/websocket-bridge
git clone git@github.com:ahyatt/emacs-websocket.git ~/.emacs.d/lisp/emacs-websocket

The emacs-websocket can be downloaded from ELPA.

• add the path to ‘load-path’

(add-to-list 'load-path (expand-file-name "~/.emacs.d/lisp/websocket-bridge"))
(add-to-list 'load-path (expand-file-name "~/.emacs.d/lisp/emacs-websocket"))
(add-to-list 'load-path (expand-file-name "~/.emacs.d/lisp/org-reminders"))

Configuration

Add the following line to your Emacs configuration file (e.g., `.emacs` or `init.el`):

(require 'org-reminders)

Variables

variable	description	default-value
org-reminders-sync-file	Specify which Org Mode file to synchronize the data to.	”~/.emacs.d/Reminders.org”
org-reminders-display-options	Display the content of those reminders, with the default being all. The available options are: all, incomplete, or complete.	“all”
org-reminders-sync-frequency	The synchronization frequency, indicating how many file saves trigger one synchronization, is set to 1 by default.	1

Usage

A Transient Prefix

• org-reminders-prefix : A transient prefix for multiple org-reminders commands.

org-reminders-sync-all

Flush all Reminders data to Org manner

org-reminders-restart-auto-sync

Enable automatic synchronization between Org Mode files and Reminders.

Check Log

• run websocket-bridge-app-log-buffer select org-reminders

Contributions

Contributions are welcome! Please submit issues and pull requests through the project’s repository.