https://github.com/bcardoso/meditation

Flexible timer for meditation, working sessions & pomodoros.
https://github.com/bcardoso/meditation

meditation pomodoro timer

Last synced: 28 days ago
JSON representation

Flexible timer for meditation, working sessions & pomodoros.

• Host: GitHub
• URL: https://github.com/bcardoso/meditation
• Owner: bcardoso
• Created: 2017-03-23T17:27:22.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2022-03-09T17:12:05.000Z (over 3 years ago)
• Last Synced: 2025-03-18T10:36:03.387Z (8 months ago)
• Topics: meditation, pomodoro, timer
• Language: Shell
• Homepage:
• Size: 1.91 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.org

Awesome Lists containing this project

README

          
* meditation.sh

Flexible timer for meditation, working sessions & pomodoros.

** Installation

#+begin_src bash

git clone https://github.com/bcardoso/meditation "$HOME/bin/meditation"

chmod +x "$HOME/bin/meditation/meditation.sh"

# alias suggestion

echo "alias m='$HOME/bin/meditation/meditation.sh'" >> "$HOME/.bash_aliases"

# you might want to include the options you use the most

echo "alias m='$HOME/bin/meditation/meditation.sh -l'" >> "$HOME/.bashrc"

echo "alias p='$HOME/bin/meditation/meditation.sh -lpn'" >> "$HOME/.bashrc"

#+end_src

If you want to clone this repo to another location, remember to edit the =BASEDIR= variable in the =meditation.sh= file accordingly. Default time intervals and labels can also be set there.

** Usage

#+begin_src

USAGE:

    meditation.sh [OPTIONS] []

OPTIONS:

    -h    help

    -b    "/path/to/bell-sound.mp3"

    -c    countdown timer mode

    -C    write countdown state to file (-c is implied)

    -l    show interval labels

    -n    send notification on interval changes

    -p    pomodoro technique

    -q    quiet, no bell sound on interval changes

    -r    repeat forever (same as 'X/Y')

    -s    use a predefined interval sequence

EXAMPLES:

  meditation.sh             default interval is 25 minutes

  meditation.sh 2 3 5       set timer to 2, 3 and 5 minutes

  meditation.sh 23/5        loop for 23 and 5 minutes (same as '-r 23 5')

  meditation.sh -nl 23/5    same, with interval labels and notifications

  meditation.sh -p          start a pomodoro session

  meditation.sh -s          predefined interval sequence ('23 5 23 5 23')

#+end_src