A presentation tool for org-mode based on the visibility of outline trees
Emacs Lisp
Pull request Compare This branch is 41 commits behind takaxp:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


README for Org Tree Slide

#+Last Update: 2012-01-11@23:06

1. What’s this?

The main purpose of this elisp is to handle each tree in an org buffer as a slide by simple narrowing. This emacs lisp is a minor mode for Emacs Org-mode.

Main features:

  • Live editable presentation
  • Fast switching of narrowing/widen
  • TODO pursuit with narrowing
  • Displaying the current number of slides
  • Countdown timer
  • CONTENT view during a presentation
  • Slide-in effect
  • Slide header from org file’s header

1-1. Related packages

see http://orgmode.org/worg/org-tutorials/non-beamer-presentations.html.

2. Install

  1. Put this elisp into your load-path
  2. Add (require 'org-tree-slide) in your .emacs


  1. Eval: (auto-install-from-url "https://raw.github.com/takaxp/org-tree-slide/master/org-tree-slide.el") (for auto-install users)
  2. Add (require 'org-tree-slide) in your .emacs

Then open an org file, just type <right> and <left>. A presentation will begin with a header, slide-in effect, and slide number.

el-get recipe

If you are an el-get user, please use this recipe.

(:name org-tree-slide :description "A presentation tool for org-mode" :type git :url "git://github.com/takaxp/org-tree-slide.git" :required nil)

2.1 Requirements

  • Org-mode 6.33x or higher version is required.
  • This elisp doesn’t require any additional packages.

3. Recommended settings

Assigning a single key to org-tree-slide-mode is recommended.

(global-set-key (kbd "<f8>") 'org-tree-slide-mode)
(global-set-key (kbd "S-<f8>") 'org-tree-slide-skip-done-toggle)


(define-key org-mode-map (kbd "<f8>") 'org-tree-slide-mode)
(define-key org-mode-map (kbd "S-<f8>") 'org-tree-slide-skip-done-toggle)

4. Profiles

Three useful profiles are available. Please select a profile that is the most suitable for your using scenario.

If you select simple profile, call the following command while org-tree-slide-mode is ON.

M-x org-tree-slide-simple-profile

If you want to use this setting as the default, put the following configuration including recommended settings into your .emacs.

(when (require 'org-tree-slide nil t)
  (global-set-key (kbd "<f8>") 'org-tree-slide-mode)
  (global-set-key (kbd "S-<f8>") 'org-tree-slide-skip-done-toggle)

org-tree-slide-presentation-profile and org-tree-slide-narrowing-control-profile are also available.

4-1. `Simple’

This profile will display trees of your org buffer by simple narrowing. You can change trees without widen command. Most of the visual effect is disabled.

Type M-x org-tree-slide-simple-profile while org-tree-slide-mode is ON.

  1. No header display
  2. No slide-in effect
  3. The cursor will move to the head of the buffer when exit
  4. No slide number display in mode line
  5. Display every type of tree

4-2. `Presentation’

This profile is used as the default setting of org-tree-slide. If an org buffer includes #+TITLE:, #+EMAIL:, and #+AUTHOR:, org-tree-slide attempts to use those variables in the slide header. A date in the header will be set with the presentation of the day. You can enjoy a slide-in effect, the current slide number in mode line. A presentation with a count down timer is started by M-x org-tree-slide-play-with-timer.

If you want to show the content of your presentation, type C-x s c or M-x org-tree-slide-content. All of the headings will be shown like a Table Of Content. Find a heading that you want to show, and type <right>, the presentation will be resumed.

It is possible to skip slides when a heading level is higher than or equal to a value of org-tree-slide-skip-outline-level. see User variables.

To exit a presentation, set org-tree-slide-mode OFF. The cursor move to the head of the buffer and the trees will be displayed using #+STARTUP: if possible.

M-x org-tree-slide-presentation-profile

  1. Display header
  2. Enable slide-in effect
  3. The cursor will move to the head of buffer when exit
  4. Display slide number in mode line
  5. Display every type of tree

4-3. `TODO Pursuit with narrowing’

This profile will display trees restricted to TODO status without a header and slide-in effect. It is very useful to concentrate your focus on the current TODO item that is not done, and go to the next task by a single typing of <right>. This is “TODO Pursuit with narrowing”. If you want to track every kind of tree including finished items, toggle M-x org-tree-slide-skip-done-toggle OFF.

When you exit org-tree-slide-mode, the cursor will keep the same position, it is therefore possible to focus again by toggle M-x org-tree-slide-mode.

If you feel the cursor moving is very slow, please change a value of org-tree-slide-modeline-display to ‘outside or nil.

M-x org-tree-slide-narrowing-control-profile

  1. No header display
  2. No slide-in effect
  3. The cursor will keep the same position when exit
  4. Display slide number in mode line
  5. Display TODO trees only

5. User variables

VariableDefault valueSelect
[*1] { nil| 'lighter | 'outside }
  'outside: shown in the mode line outside of lighter
  'lighter: shown in lighter (slow)
       nil: nothing to be shown"

5-1. Useful settings for experts

If you like this elisp, the following setting is more useful. Try it!

<f8> / <f9> / <f10> / <f11> are assigned to control org-tree-slide.

(when (require 'org-tree-slide nil t)
  (global-set-key (kbd "<f8>") 'org-tree-slide-mode)
  (global-set-key (kbd "S-<f8>") 'org-tree-slide-skip-done-toggle)
  (define-key org-tree-slide-mode-map (kbd "<f9>")
  (define-key org-tree-slide-mode-map (kbd "<f10>")
  (define-key org-tree-slide-mode-map (kbd "<f11>")
  ;; Reset the default setting
  (define-key org-tree-slide-mode-map (kbd "<left>")  'backward-char)
  (define-key org-tree-slide-mode-map (kbd "<right>") 'forward-char)
  (setq org-tree-slide-skip-outline-level 4)
  (setq org-tree-slide-skip-done nil)))

6. Functions

Control functions

  • org-tree-slide-move-next-tree (<right>)
  • org-tree-slide-move-previous-tree (<left>)
  • org-tree-slide-content (C-x s c)

Startup options

These functions will toggle org-tree-slide-mode ON, automatically.

  • org-tree-slide-without-init-play
  • org-tree-slide-play-with-timer

Toggle variables

  • org-tree-slide-display-header-toggle
  • org-tree-slide-slide-in-effect-toggle
  • org-tree-slide-skip-done-toggle
  • org-tree-slide-heading-emphasis-toggle

Batch setting of user variables

  • org-tree-slide-simple-profile
  • org-tree-slide-presentation-profile
  • org-tree-slide-narrowing-control-profile

7. History

see also ChangeLog

v2.5.42012-01-11@23:02Add autoload magic comments
v2.5.32011-12-18@00:50Fix a bug for an org buffer without header
v2.5.22011-12-17@17:52Set presentation profile as the default
v2.5.12011-12-17@13:34org-tree-slide-skip-done set nil as default
v2.5.02011-12-12@18:16Remove auto-play function (TBD)
v2.4.12011-12-09@11:46Add an option to control mode line display
v2.4.02011-12-08@10:51Support TODO pursuit in a slideshow
v2.3.22011-12-08@09:22Reduce redundant processing
v2.3.12011-12-07@20:30Add a new profile to control narrowing status
v2.3.02011-12-07@16:17Support displaying a slide number
v2.2.02011-12-07@02:15Support minor mode
v2.1.72011-12-06@00:26Support TITLE/AUTHOR/EMAIL in a header
v2.1.52011-12-05@17:08Fix an issue of title display
v2.1.32011-12-05@15:08Fix the end of slide for skip control
v2.1.12011-12-05@11:08Add skip control by heading level
v2.0.12011-12-02@18:29Change function names, ots- is introduced.
v2.0.02011-12-01@17:41Add profiles and support org 6.33x
v1.2.52011-10-31@18:34Add CONTENT view to see all the subtrees.
v1.2.32011-10-30@20:42Add a variable to control slide-in duration
v1.2.12011-10-30@16:10Add slide-in visual effect
v1.1.12011-10-28@16:16Add functions to start and stop slide view
v1.0.02011-09-28@20:59Release the initial version

8. Contact

The author is Takaaki ISHIKAWA (takaxp@ieee.org). Feel free to email me or use a mention of twitter (@takaxp)