Org Agenda View
Customize your weekly Agenda
Some important variables:
(setq org-agenda-span 'week) ;; The no. of days to include in display (setq org-agenda-start-on-weekday 0) ;; Week starts on Sunday (setq org-agenda-remove-timeranges-from-blocks t)
Emacs Calendar/Diary integration
(setq org-agenda-include-diary t) (global-set-key (kbd "C-c k") 'calendar) (setq calendar-mark-diary-entries-flag t)
Key points about diary integration:
- SPC, TAB, and RET can be used from the agenda buffer to jump to the diary file in order to edit existing diary entries.
D (org-agenda-toggle-diary)
Toggles the inclusion of diary entries.- The i command (used in Diary to insert new entries for the current date) also works in the agenda buffer.
- c can be used to switch back and forth between calendar and agenda.
- It is better to use diary expressions in an Org file than in Emacs diary because Org evaluates them faster.
- Expression entries must exists under an Org Heading and start at the left margin, as in this example:
#+beginexample
Birthdays
#+endexample
Appointment reminders
Org can be integrated with Emacs' appointment notification system to help manage and remind you of upcoming appointments.
The command org-agenda-to-appt
is used to load appointments from your Org agenda files into Emacs' appointment notification facility. This helps you get reminders directly within Emacs.
Simple motions
To move up and own a line: n/p up/down
Do I use it: Yes
Visit Original File: SPC Versus TAB and RET
To view the Agenda item in its original Org file in a separate window use SPC
.
(Sometimes one may need to recentre the items in the original file, in which case use L
.)
Nota Bene the cursor stays in the Org Agenda window with these commands.
Use TAB
to have the cursor jump to the item in its original file.
RET
Leave Org Agenda and go to original file
Summary: Use "SPC" to view, TAB
to edit
Do I use it? Yes
Follow Mode F
As you move point through the agenda buffer, the other window shows the corresponding location in the Org file.
Utility: View and edit multiple items quickly
Do I use it: No.
Show only the subtree of the item, not the whole file
C-c C-x b (org-agenda-tree-to-indirect-buffer)
Do I use it: No
Open another Agenda View and "append" it to the current view
A (org-agenda-append-agenda)
Interactively select another agenda view and append it to the current view, making for a single view
Do I use it? Sometimes
Delete other windows
C-x 1
or o
Change you views
v d or short d (org-agenda-day-view)
v w or short w (org-agenda-week-view)
v m (org-agenda-month-view)
With a prefix argument, jump to a specific month: C-u 8 vm
v y (org-agenda-year-view)
With a prefix argument, jump to a specific year: C-u 2024 vy
v SPC (org-agenda-reset-view)
Resets the current view to your default set by org-agenda-span.
f (org-agenda-later)
Go forward in time (prefix arguments are allowed)
b (org-agenda-earlier)
Go backward in time.
. (org-agenda-goto-today)
Go to today.
j (org-agenda-goto-date)
Prompts and allow you to jump to a specific date.
r (org-agenda-redo)
g (org-agenda-redo-all)
Recreate the agenda buffer, for example to reflect the changes after modification of the timestamps of items with S-LEFT and S-RIGHT.
A nice hidden feature
C-x C-s or short s (org-save-all-org-buffers)
Save all Org buffers
t (org-agenda-todo)
Same as C-c C-t
Change the TODO state of the item, both in the agenda and in the original Org file.
C-k (org-agenda-kill)
Delete the current agenda item.
C-c C-w (org-agenda-refile)
Refile the entry at point.
a (org-agenda-archive-default-with-confirmation)
Archive
T (org-agenda-show-tags)
Show all tags associated with the current item.
: (org-agenda-set-tags)
Set tags for the current headline.
C-c C-z or short z (org-agenda-add-note)
Add a note to the entry.
k (org-agenda-capture)
Important Command
org-capture, but uses the date at point as the default date
Bulk Actions
Use Agenda Menu