Skip to main content

Hello and welcome to daily, a program for command-line journaling. Each journal entry is stored in a file named after the date in YYYY-mm-dd format in either MD or RST format.

Building and installation

Available via PyPi. pip3 install daily-cli --user

Alternatively, clone this repo and run these commands.

make
pip3 install --user .

The man pages will be installed at $HOME/.local/usr/share/man and the bash completion script will be installed at $HOME/.local/etc/bash_completion.d/daily_completion.sh. Update your bashrc.

Usage

Usage is detailed in the man pages under ./doc/man. Start with daily.1, but a general quick start cookbook…

daily  # Perform first-time setup
daily add  # Edit today's entry.
daily show  # Show previous 2 weeks of entries
daily add -d yesterday  # Add or edit an entry on a specific date.
daily add --before today  # Batch edit any entries before today
daily show workout todo  # Show only specific headings for entries
daily add workout  # Edit specific headings for an entry.

daily todo  # Print next 2 weeks of todos

Entries have a title named after the date, a desription, headings, and metadata all built in to the text. Here is a simple example in markdown.

# 2022-10-10, Mon
I went to my daughter's play.

## Workout
And did like a gazillion pushups.


<!--- attributes --->
    ---
    id: some-internal-id
    tags: []

And an example in RST.

=================
 2022-10-10, Mon
=================
This semester in college is really starting to grind.

Todo
====
- 8am Calculus class.
- 9am Workout


.. code-block:: yaml

    ---
    id: some-internal-id
    tags: []

Usage with Vimwiki

Modify daily.ini (installed in ~/.config/daily after a first run) to change the journal’s directory to your vimwiki diary, and be sure the format is “md”.

Also install the generate-vimwiki-diary-template file to your ~/.vim/bin directory. This will make it so vim auto-generates daily’s entry text for new markdown files in the vimwiki diary directory. This must be done manually.

Maintenance and versioning

Update the CHANGELOG when cutting a new release, then update the version in setup.py. Then commit and tag it named after the release. Then…

  • Run make to build the package.

  • make release to upload to PyPi.

Release files for daily-cli 2.1.3

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

Source distribution (sdist)

Source distribution for daily-cli 2.1.3
File Size Uploaded
daily_cli-2.1.3.tar.gz 25.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for daily-cli 2.1.3
File Interpreter ABI Platform
daily_cli-2.1.3-py3-none-any.whl Python 3 none any Details

Total release size: 52.1 kB

Release files / daily_cli-2.1.3.tar.gz

Download URL daily_cli-2.1.3.tar.gz
Size 25.1 kB
Tags Source
SHA-256 checksum
How to use checksums
18b1ddb7ba62b7ef45efbaa97066fdf30e878873d6c05cacd4312ccd58db8fc6
BLAKE2b-256 checksum
How to use checksums
95c55e11e765e8fbb35219511babb4ba4da67fd2a6b7a2f25db6a9a84913a597
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.11

Release files / daily_cli-2.1.3-py3-none-any.whl

Download URL daily_cli-2.1.3-py3-none-any.whl
Size 27.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
08579b6474e99896fc00aee039a270acb2fc4313db6f29c23476ceeb101fb3aa
BLAKE2b-256 checksum
How to use checksums
7b19af7a5a197677ffb2fb71328ff942f93fbe75797f92f232406be6d52b1595
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.11

Release history Release notifications | RSS feed

This release

2.1.3 This release

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.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