python -m src.main -X -w

Berserk Timer

cli timer with witness mode and flexible duration input.

the goal was to make a simple windows cli timer that asks “What have you been doing?” after each session. it combines flexibility, simplicity, and a no-ads policy.

screens

witness
 ▄▄▄▄▀ ▄█ █▀▄▀█ ▄███▄   █▄▄▄▄
▀▀▀ █    █ █ █ █ █▀   ▀  █  ▄▀
    █    █ █ ▄ █ ██▄▄    █▀▀▌
   █     ▐█    █ █▄   ▄▀ █  █
  ▀       ▐   ▀  ▀███▀     █
                          ▀

TIMER FINISHED

Completed at: 22:41:03
Goal:         write docs

What did you accomplish? (or press Enter to skip, 'skip' to cancel, 'k' to stop alert):
startup
███   ▄███▄   █▄▄▄▄   ▄▄▄▄▄   ▄███▄   █▄▄▄▄ █  █▀
█  █  █▀   ▀  █  ▄▀  █     ▀▄ █▀   ▀  █  ▄▀ █▄█
█ ▀ ▄ ██▄▄    █▀▀▌ ▄  ▀▀▀▀▄   ██▄▄    █▀▀▌  █▀▄
█  ▄▀ █▄   ▄▀ █  █  ▀▄▄▄▄▀    █▄   ▄▀ █  █  █  █
███   ▀███▀      █             ▀███▀     █     █
                ▀                       ▀     ▀
             █▄
           ▄     █▀▄▀█
       ▄▄▄▀▀ ▄█  █ █ █  ▄███▄   █▄▄▄▄
    ▀▀▀ █    ██  █ ▀ █  █▀   ▀  █  ▄▀
        █    ██  █   █  ██▄▄    █▀▀█▌
       █     ▐█      █  █▄   ▄▀ █   █
      ▀       ▐     ▀   ▀███▀      █
made by ivan krushinski aka looksawful
https://github.com/awfulthings/berserk-timer
© 2025
version: 0.2.1-beta

INSTRUCTIONS:
  • Set timer duration in minutes
  • Presets: -x (5min), -s (10min), -m (15min), -l (20min), -X (25min), -t (1min test)
  • Maximum duration: 3 hours
  • Set your goal for this session (if witness mode enabled, or skip)
  • Choose sound: --sound alert1.wav (or alert2/alert3/alert4)
  • Set volume in config.json (1-10 scale, default: 5)
  • During timer:
    - Press 'p' to pause/resume
    - Press 'q' to quit
    - Press 'x' to zero the timer
    - Press 'r' to restart
    - Press 'v' to view today's log
    - Press 'd' to delete today's log
    - Press 'u' to update duration
    - Press 'g' to set/change goal
    - Press 'm' to toggle silent mode
    - Press 's' to open audio settings (sound/volume)

------------------------------------------------------------

Enter timer duration in minutes [max 180] (or press Enter for 5 min default):
What are you planning to do? (or press Enter to skip):
audio settings
  ▄▄▄▄▄   ▄███▄     ▄▄▄▄▀ ▄▄▄▄▀ ▄█    ▄     ▄▀    ▄▄▄▄▄
 █     ▀▄ █▀   ▀ ▀▀▀ █ ▀▀▀ █    ██     █  ▄▀     █     ▀▄
▄  ▀▀▀▀▄   ██▄▄       █     █    ██ ██   █ █ ▀▄ ▄  ▀▀▀▀▄
 ▀▄▄▄▄▀    █▄   ▄▀   █     █     ▐█ █ █  █ █   █ ▀▄▄▄▄▀
           ▀███▀    ▀     ▀       ▐ █  █ ██  ███
                                    █   ██

═══ AUDIO SETTINGS ═══

Volume: [#####-----] 5/10
Sound:  alert1.wav (1/4)

Available sounds:
  > 1. alert1.wav
    2. alert2.wav
    3. alert3.wav
    4. alert4.wav

Commands:
  0       = Toggle silent mode
  1-10    = Set volume (1=min, 10=max)
  +/-     = Volume up/down
  >       = Next sound
  <       = Previous sound
  t       = Test current settings
  k       = Stop playing sound
  Enter   = Close menu

>
help
 ▄  █ ▄███▄   █    █ ▄▄
█   █ █▀   ▀  █    █   █
██▀▀█ ██▄▄    █    █▀▀▀
█   █ █▄   ▄▀ ███▄ █
   █  ▀███▀       ▀ █
  ▀                  ▀

TIMER COMMANDS:
  p - Pause/Resume timer
  q - Quit timer (with confirmation)
  x - Zero the timer
  r - Restart timer from beginning
  v - View today's witness log
  d - Delete today's witness log
  u - Update duration (change timer length)
  g - Set/change goal for this session
  m - Toggle silent mode on/off
  s - Open audio settings (sound file and volume)
  h - Show this help screen
  k - Stop currently playing sound

Press Enter to return to timer...
flexible duration inputwitness modepresetscontrol & audiologging

music

audio settings / playerready
00:0000:00
Volume:
5/10
Sound:

install

clone the repo / dependencies
git clone https://github.com/looksawful/berserk-timer
cd berserk-timer
pip install -r requirements.txt

usage

start a timer with a duration, a fractional duration, a preset or silent mode.

usage examples
# start a 10 minute timer
python -m src.main 10

# start a 1.5 minute timer
python -m src.main 1.5

# start the small preset
python -m src.main -s

# start silently
python -m src.main 25 --mute