notwaldorf /tiny-care-terminal

💖💻 A little dashboard that tries to take care of you when you're using your terminal.

★ 5,977⑂ 235👁 77⑃ 104● 96▤ 0
JavaScriptMITCreated 2017-04-10
+1
Daily
5,977
stars
235
forks
77
watchers
104
prs
96
issues
0
releases

README

tiny-care-terminal

This is a little dashboard that tries to take care of you when you're using your terminal. It tells you cute, self care things, and tries not to stress you out. It shows:

- the last tweets from @tinycarebot, @selfcare_bot and @magicrealismbot. The first two tend to tweet reminders about taking breaks, drinking water and looking outside, and the latter tells you strange, whimsical stories. If you don't like these bots, they're configurable!
- your git commits from today and the last 7 days. When I get stressed out because I think I haven't done anything, it turns out that I only think about big and serious commits, and forget about all the tiny amounts of work I've actually done throughout. Hopefully this will help you too <3
- the weather, because you might get rained on.

It looks like this, and updates every 20 minutes.

!tiny terminal care screenshot

 Make it go

 1\. Installation

Sadly only node.js v10.x is supported at the moment.

sh
npm install -g tiny-care-terminal


(yarn also works fine.)

 2\. Setting the environment variables

After installing the npm package, you need to set up the configuration in your Terminal.

Every OS and shell is different so I probably won't hit all of them, but the bottom line is that you should copy those environment variables wherever the rest of your system's variables live. For example,

- if you're using zsh, that's probably in your home directory's .zshrc file
- if you're using bash, that could be your bash_profile file
- if you're using fish, use set -gx key value in your ~/.config/fish/config.fish file

Note that the export bit is pretty key, to make sure that they are globally available. To check that the variables have been set correctly, you can print them in the terminal -- for example, echo $TTC_WEATHER.

 Configure the dashboard

All the settings the dashboard looks at are in the sample file sample.env. This file isn't used by the dashboard, it just lists the environment variables that you can copy in your rc files:

- TTC_BOTS are the 3 twitter bots to check, comma separated. The first entry in this list will be displayed in the big party parrot box.
- TTC_SAY_BOX defines the ASCII-Art to show. e.g. parrot | bunny | llama | cat | yeoman | mario | ironman.ansi | stegosaurus.cow See section below for all the different options.
- TTC_REPOS, a comma separated list of repos to look at for git commits.
- TTC_REPOS_DEPTH is the max directory-depth to look for git repositories in the directories defined with TTC_REPOS (by default 1). Note that the deeper the directory depth, the slower the results will be fetched. Seeing your commits in tiny-terminal-care, set this to gitlog
- TTC_WEATHER, the location to check the weather for. A zipcode doesn't always work, so if you can, use a location first (so prefer Paris over 90210)
- TTC_CELSIUS (by default true)
- TTC_APIKEYS -- set this to false if you don't want to use Twitter API keys and want to scrape the tweets instead.
- TTC_UPDATE

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON