Feeling

A Zsh script for your feelings

_{Demo made with svg-term-cli using my dotfiles}

Overview

The script is inspired by this Reddit post. The idea is to enter your feeling each day on a 1-10 scale. This gives time to reflect upon your day to create more meaningful goals and improve wellness. By displaying your feelings in a beautiful calendar, you can also gain insight into trends in your feelings while prettifying your terminal.

Installation

Note for macOS users. As the script makes use of GNU versions of tools, please link gsed to sed and gdate to date.

Oh My Zsh

Clone this repository into the custom plugins folder:

git clone https://github.com/qiz-li/feeling.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/feeling

Update Oh My Zsh plugins list in .zshrc:

plugins=(
    # Other plugins...
    feeling
)

Antigen

Add the following to your .zshrc:

antigen bundle qiz-li/feeling@main

Configuration

FEELING_DATA_PATH

Path to file in which your feelings and corresponding dates will be stored. Defaults to ~/.config/feeling/feelings.csv.

FEELING_FILLED_CHAR

Character to represent days you have rated. Defaults to ●.

FEELING_EMPTY_CHAR

Character to represent days that are unrated. Defaults to ◯.

Usage

Use the -h flag for help.

Show Calendar

Run without any arguments:

feeling

Add/Change Feeling

Add your feeling as an argument.

To add/change today's feeling:

feeling 8

Or specify a date using the -d flag:

feeling -d 2022-02-22 3

Remove Feeling

Add the -r flag to remove a feeling.

To remove today's feeling:

feeling -r

Or a specific date:

feeling -d 2022-03-20 -r