Skip to main content

Calamity

Calamity is a terminal-based calendar focused on fast navigation, fast data-entry, and vim-like bindings.

Home Image

Installation

Install Calamity via pip:

pip install calamity_calendar
calamity

Your calendar is stored in ~/.local/share/calamity/events.db.

Usage

  • Three kinds of events: appointments, tasks, and chores.

    • Appointments: start time and end time.
    • Tasks: have a deadline (e.g. homework).
    • Chores: performed on the day they're scheduled (e.g. hygiene)
  • Selection:

    • Coordinate system: Day (A-Z), Event (1-9).
    • Vim motions (e.g. j, k, h, l) to navigate.
  • Repetitions (Groups):

    • r Create repetitions. (r followed by 7+13 creates 13 weekly repetitions.)
    • Individual events are edited with with the e prefix.
    • Entire repetition groups are edited with the g prefix.

New Event

Command Description
a Appointment
t Task
c Chore

Selection

Command Description
A-Z Day
1-9 Event
j Down
k Up
l Right (Event)
h Left (Event)
\> Next month
< Previous month
w Next week
b Previous week
TAB Next chore
SPC Next appointment
RET Next task
gg Jump to today

Edit

Edit Event Edit Repetition Group Description
eD N/A Edit date
ed gd Edit description
ec gc Edit code (task)
es gs Edit start time (appointment)
ef gf Edit finish time (appointment)
et gt Edit time (appointment)
; g; Cycle color forwards
, g, Cycle color backwards
+ g+ Postpone one day
- g- Prepone one day
x gx Delete event
r gr Repeat event
m gm Move event
~ g~ Toggle chore / task
gX N/A Kill future repetitions

Undo

Command Description
u Undo
CTRL-R Redo
. Repeat last action
Command Description
/ Search
n Next match
N Previous match
* Next repetition
# Previous repetition

Miscellaneous

Command Description
y Yank event
gy Yank repetition group
p Paste yanked event/group
s Separate event from repetition group
v Backup calendar
q Quit

View

Command Description
zk Up
zj Down
zh Left
zl Right
zz Center
zt Top
zb Bottom
z0 Toggle 12/24 hour
z? Toggle help visibility
g? Toggle ROT13 encryption

Metadata

Release files for calamity_calendar 0.1.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for calamity_calendar 0.1.11
File Size Uploaded
calamity_calendar-0.1.11.tar.gz 18.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for calamity_calendar 0.1.11
File Interpreter ABI Platform
calamity_calendar-0.1.11-py3-none-any.whl Python 3 none any Details

Total release size: 38.9 kB

Release files / calamity_calendar-0.1.11.tar.gz

Download URL calamity_calendar-0.1.11.tar.gz
Size 18.2 kB
Tags Source
SHA-256 checksum
How to use checksums
674965cd1b655561b5397612b646518ebc53b6920dc1a65f7317b9099cb3cd6e
BLAKE2b-256 checksum
How to use checksums
37b775254f21a1935841eaa2cfa1e76bb74da57bd0eac8bbe98900b02de44039
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.6.1 CPython/3.10.12 Linux/6.2.0-39-generic

Release files / calamity_calendar-0.1.11-py3-none-any.whl

Download URL calamity_calendar-0.1.11-py3-none-any.whl
Size 20.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8a7b0e49d0029f2a987f34297036e8e89bbb4b93de62018f61e45ef3e45ea8d3
BLAKE2b-256 checksum
How to use checksums
128af227ff78665a4e9c9a2e64f589fe9842502849d79b02c0da4678ea2c4b3e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.6.1 CPython/3.10.12 Linux/6.2.0-39-generic

Release history Release notifications | RSS feed

This release

0.1.11 This release

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page