https://github.com/unhammer/org-random-todo

🍃 Pop up a random TODO from your agenda every so often, using alert.el
https://github.com/unhammer/org-random-todo

alert org-mode serendipity todo

Last synced: 13 days ago
JSON representation

🍃 Pop up a random TODO from your agenda every so often, using alert.el

• Host: GitHub
• URL: https://github.com/unhammer/org-random-todo
• Owner: unhammer
• Created: 2013-05-13T12:58:47.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2020-05-13T10:40:09.000Z (over 4 years ago)
• Last Synced: 2024-10-11T23:47:40.406Z (about 1 month ago)
• Topics: alert, org-mode, serendipity, todo
• Language: Emacs Lisp
• Homepage: https://melpa.org/#/org-random-todo
• Size: 26.4 KB
• Stars: 8
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.org

Awesome Lists containing this project

README

        
#+TITLE: org-random-todo

[[https://melpa.org/#/org-random-todo][https://melpa.org/packages/org-random-todo-badge.svg]]

[[https://stable.melpa.org/#/org-random-todo][https://stable.melpa.org/packages/org-random-todo-badge.svg]]

This will show a random TODO from your =org-agenda-files= every so

often. It uses [[https://github.com/jwiegley/alert][alert]] to show the notifications – see that package on

how to use other notification methods than =message=.

If you want to navigate to the most recently shown random TODO, use

=M-x org-random-todo-goto-current=; navigate to a new one with

=M-x org-random-todo-goto-new=.

* Installation

** MELPA

If you use [[https://melpa.org/][MELPA]], you can just do =M-x list-packages=, find

=org-random-todo= in the list and hit =i x=.

** Manual

Install [[https://github.com/jwiegley/alert][alert]], and ensure you're running =org-mode= version 7.9.3f or

later. Then just put =org-random-todo.el= somewhere in =load-path=.

* Usage

** Manual, loading on startup:

   Put this in your =~/.emacs.d/init.el=:

#+BEGIN_SRC emacs-lisp

  (require 'org-random-todo)

  (setq org-random-todo-how-often 1500)

  (org-random-todo-mode 1)

#+END_SRC

** With use-package

   I have this in my =~/.emacs.d/init.el= to install it if not

   installed yet, and only load it after I've opened at least one

   =org-mode= file, and use =notifications= instead of =message= for

   this package:

#+BEGIN_SRC emacs-lisp

   (use-package org-random-todo

     :ensure t

     :after org

     :commands (org-random-todo-mode

                org-random-todo

                org-random-todo-goto-current

                org-random-todo-goto-new)

     :config

     (setq org-random-todo-how-often 1500)

     (org-random-todo-mode 1))

   (use-package alert

     :defer t

     :config

     (alert-add-rule :mode     'org-mode

                     :category "random-todo"

                     :style 'notifications

                     :continue t))

#+END_SRC

* Related

- [[https://github.com/mwfogleman/org-randomnote][org-randomnote]] lets you go to a random note with

  =M-x org-randomnote=, which is shorter to type than

  =M-x org-random-todo-goto-new=

- https://www.emacswiki.org/emacs/RemembranceAgents are programs that

  try to suggest /relevant/ information from your personal data (while

  =org-random-todo= just suggest information)