Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abrochard/emacs-habitica
Emacs Extension for Habitica
https://github.com/abrochard/emacs-habitica
emacs habitica org-mode
Last synced: 3 months ago
JSON representation
Emacs Extension for Habitica
- Host: GitHub
- URL: https://github.com/abrochard/emacs-habitica
- Owner: abrochard
- License: gpl-3.0
- Created: 2016-08-09T01:46:55.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-06-01T20:29:46.000Z (8 months ago)
- Last Synced: 2024-08-01T03:43:22.769Z (6 months ago)
- Topics: emacs, habitica, org-mode
- Language: Emacs Lisp
- Homepage:
- Size: 149 KB
- Stars: 75
- Watchers: 9
- Forks: 23
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://melpa.org/#/habitica)
# emacs-habitica
Emacs extension for [Habitica](https://habitica.com/), a RPG style habit tracker and todo list.
## Installation
Install from MELPA with
``` lisp
M-x package-install habitica
```
or load the file [habitica.el](../master/habitica.el).
## Usage
To see your tasks, call
``` lisp
M-x habitica-tasks
```
On your first use, the extension will prompt your for your username and password. These are used to query your user id and api token from the service.
## Shortcuts
Place your cursor on the task
``` lisp
C-x t n => new task
C-x t t => cycle todo/done
C-x t + => + a habit
C-x t - => - a habit
C-x t d => set deadline
C-x t i => set difficulty
C-x t D => delete the task
C-x t b => buy reward
C-x t a => add a tag to the task
C-x t A => remove a tag from the task
C-x t g => refresh
```
## Customize
### Auto login
If you restart Emacs often, or if you just don't like entering your username or password, it is possible to bypass it by setting your user id and token directly:
``` lisp
(setq habitica-uid "123")
(setq habitica-token "456")
```
You can find your uid and token by following the instructions [here](http://habitica.wikia.com/wiki/API_Options).
### Completed Todos Section
You can view your completed to dos by adding following to init.el
```lisp
(setq habitica-show-completed-todo t)
```
The variable is customized using the Emacs customization interface under the group `habitica`
### Highlighting
If you want to try highlighting tasks based on their value
``` lisp
(setq habitica-turn-on-highlighting t)
```
This is very experimental.
### Streak count
If you want the streak count to appear as a tag for your daily tasks
``` lisp
(setq habitica-show-streak t)
```