# caps-log

> Terminal-based journaling tool that saves daily entries as Markdown files with calendar navigation and tag organization

Stars: 408 · Categories: Productivity

- Repository: https://github.com/NikolaDucak/caps-log
- Page: https://www.trmn.sh/tools/caps-log

## Install

- Manual Build: `sudo apt-get install -y libboost-program-options-dev libgit2-dev && mkdir build && cd build && cmake .. && make && sudo make install`

## Overview

Caps-Log is a terminal-based journaling application that saves daily entries as Markdown files with structured organization through sections and tags. The tool uses level 1 headers for sections and unordered lists starting with '*' for tags, allowing users to categorize and navigate their journal entries efficiently.

The application provides a calendar view that highlights dates with log entries and can display annual events like birthdays and holidays. Users can navigate between calendar dates and menus using keyboard shortcuts (hjkl/arrow keys), open entries in their preferred editor via the $EDITOR environment variable, and access a scratchpad feature for quick note-taking. The tool supports both section-based browsing and tag filtering across all entries.

Caps-Log includes AES encryption for securing journal data and basic git integration for remote storage synchronization using SSH authentication. The application offers extensive theming options through configuration files, allowing customization of colors, borders, and markdown preview styling. While functional in smaller terminals, it performs optimally when the full calendar view is visible, and emoji handling may be inconsistent depending on terminal configuration.

### Installation

```bash
# via Manual Build
sudo apt-get install -y libboost-program-options-dev libgit2-dev && mkdir build && cd build && cmake .. && make && sudo make install
```

![Caps-Log terminal interface](https://media.trmn.sh/cached/ddaaeee454b097bf65721a3213fd46d113584edf5858d0eedf862d196ba5e7cc.gif)

## Alternatives

- [asak](https://www.trmn.sh/tools/asak.md): Terminal audio tool for browsing, playing, and recording audio files with waveform visualization and device selection (372 stars)
- [daylight](https://www.trmn.sh/tools/daylight.md): Command-line tool for tracking sunrise, sunset, and daylight hours with 10-day projections (372 stars)
- [omm](https://www.trmn.sh/tools/omm.md): Keyboard-driven task manager for the command line with priority reordering and context management (Go, 334 stars)
- [scli](https://www.trmn.sh/tools/scli.md): Terminal user interface for Signal messaging with Vim-like navigation and external editor support (Python, 537 stars)
- [bmm](https://www.trmn.sh/tools/bmm.md): Command-line bookmark manager with local storage, search capabilities, and both CLI and TUI interfaces (239 stars)

---

Canonical: https://www.trmn.sh/tools/caps-log