Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/Sangdol/reminders-jxa

A command line tool that lets you add items to your macOS Reminders lists with a human-readable date format
https://github.com/Sangdol/reminders-jxa

jxa macos reminders

Last synced: about 2 months ago
JSON representation

A command line tool that lets you add items to your macOS Reminders lists with a human-readable date format

Awesome Lists containing this project

README

        

Reminders JXA
===

Quickly and easily add items to your macOS Reminders lists.

Installation
===

```sh
npm install
```

Usage
===

### Adding an item to the default list

By default, the application adds a new item to the `Todos` list.

For example,
```sh
node index.js --text 'run'
```

### Adding an item to the default list with a date string

`r` is used as a separator between a text and a date string.

For example,
```sh
node index.js --text 'run r 11:00'
node index.js --text 'run r tomorrow 11:00'
node index.js --text 'run r 11th 11:00'
node index.js --text 'run r in 5 minutes'

# 08:00 is the default time when there's no time specified
node index.js --text 'run r tomorrow'
```

[sugarjs](https://sugarjs.com) is used to parse a date string.
You can find more date format examples in
[the sugarjs Parsing section](https://sugarjs.com/dates/#/Parsing)

### Adding an item to a specific list

You can use a `--list` argument to specify the list name.

For example,
```sh
node index.js --text 'run r 11th 11:00' --list Work
```

Alfred integration
===

I've written this script to use it with [Alfred](https://www.alfredapp.com/).

I used to use the [alfred-reminders](https://github.com/surrealroad/alfred-reminders) workflow but I stopped using it since it was laggy.
I needed a fast workflow that does one thing well.

If you're an [Alfred Powerpack](https://www.alfredapp.com/powerpack/) user, you can add items via Alfred by creating your own workflow.

Check out [the Alfred Run Script Action page](https://www.alfredapp.com/help/workflows/actions/run-script/) for more information.

![Alfred integration screenshot](/img/alfred-reminders-jxa.png)

License
===

MIT