https://github.com/harrybournis/org-fancy-priorities

Display Org Mode priorities as custom strings
https://github.com/harrybournis/org-fancy-priorities

emacs org org-mode

Last synced: 7 days ago
JSON representation

Display Org Mode priorities as custom strings

• Host: GitHub
• URL: https://github.com/harrybournis/org-fancy-priorities
• Owner: harrybournis
• License: mit
• Created: 2018-02-01T22:54:14.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2021-08-30T16:57:22.000Z (over 3 years ago)
• Last Synced: 2024-08-02T16:44:45.530Z (9 months ago)
• Topics: emacs, org, org-mode
• Language: Emacs Lisp
• Homepage:
• Size: 428 KB
• Stars: 132
• Watchers: 3
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• my-awesome-github-stars - harrybournis/org-fancy-priorities - Display Org Mode priorities as custom strings (Emacs Lisp)

README

        
[![MELPA](https://melpa.org/packages/org-fancy-priorities-badge.svg)](https://melpa.org/#/org-fancy-priorities)

# Org Fancy Priorities

Org mode is great. It is powerful, versatile and customizable. Unfortunately, I

always found the task priorities functionality a bit underwhelming, not in

terms of usability, but more in the visual department.

Inspired by [org-bullets](https://github.com/sabof/org-bullets), I created a

minor mode that displays org priorities as custom strings. This mode does

**NOT** change your files in any way, it only displays the priority part of a

heading as your preferred string value.

## Screenshots

![Screenshot 1](./screenshots/screenshot1.png)

![Screenshot 2](./screenshots/screenshot2.png)

![Screenshot Agenda](./screenshots/screenshot-agenda.png)

## Installation

The package is available in [MELPA](https://melpa.org/#/org-fancy-priorities).

The code bellow will display the highest priority in each org file as ⚡, with

the rest of the symbols following in descending priority.

``` emacs-lisp

(use-package org-fancy-priorities

  :ensure t

  :hook

  (org-mode . org-fancy-priorities-mode)

  :config

  (setq org-fancy-priorities-list '("⚡" "⬆" "⬇" "☕")))

```

## Customization

If you use custom priority values for different files, you can explicitly set a

different string that will be matched to each one of them. See example below:

``` emacs-lisp

(setq org-fancy-priorities-list '((?A . "❗")

                                  (?B . "⬆")

                                  (?C . "⬇")

                                  (?D . "☕")

                                  (?1 . "⚡")

                                  (?2 . "⮬")

                                  (?3 . "⮮")

                                  (?4 . "☕")

                                  (?I . "Important")))

```

The "?" before each character is needed to convert each character to its integer

value, since Characters in Elisp are just integers.