nowfocus 0.2.0

NowFocus: the open source task-tracking self-control panel.

NowFocus

A simple, performance-oriented, activity tracker that flexibly connects multiple to-do lists with multiple time trackers and displays your current task and time spent in the status bar.

Features

• Unlimited flexible combinations of to-do lists and time tracking systems
• Flexibly nested lists
• Inactivity detection that automatically pauses time tracking
• Pomodoro timer
• Task prioritization
• Time targets: set a minimum or maximum time for any task or list of tasks and get reminded to follow though
• Randomness interrupt bell (optional) to keep you on track with tracking your time
• Fast, keyboard-driven, interface
• Offline to-do list cache
• Tested on Ubuntu and Linux Mint with Xorg and Wayland

Currently Supported Todo Lists

• Simple text or markdown file with indentation based sub-lists
• Any to-do list that supports CalDav todos
• todotxt format
• TaskWarrior
• Vikunja
• Photosynthesis Timetracker

Currently Supported Time Trackers

• CSV file
• ActivityWatch
• Photosynthesis Timetracker
• TimeWarrior

Installation

• Install dependencies:

sudo apt install gir1.2-appindicator3-0.1 meson libdbus-glib-1-dev patchelf python3.12-venv pip libgirepository1.0-dev gcc libcairo2-dev pkg-config python3-dev

• Set up a python venv

python3 -m venv .venv/nowfocus  
source .venv/nowfocus/bin/activate 

Install with Pip

pip install nowfocus

• Run python3 -m what-am-doing and check for errors

• Add the following to your startup applications bash -c "source .venv/nowfocus/bin/activate; python3 -m what-am-doing"

Install from Source

• Clone this repo into some out-of-the-way directory (referred to as YOUR_INSTALL_PATH)

• Change to YOUR_INSTALL_PATH directory with cd /path/to/where/you/cloned/nowfocus

• Install required python modules: pip install -r requirements.txt

• Run python3 __main__.py and check for errors

• Add the following to your startup applications: bash -c "source .venv/nowfocus/bin/activate; python3 /YOUR_INSTALL_PATH/src/what-am-doing/__main__.py"

Usage

• Open settings and add your to-do list and time tracker details

Build Flatpak

python3 -m build
# python3 flatpak-pip-generator --runtime=org.gnome.Sdk/x86_64/47 PACKAGE # run this for lots of stuff
flatpak run org.flatpak.Builder --force-clean --user --install --install-deps-from=flathub --repo=repo builddir APPID.yaml
flatpak run APPID

Keybindings

To set up a keybinding to open your tasks on Ubuntu or Linux Mint, open Setting > Keyboard > Keyboard Shortcuts > Custom Shortcuts, set the command to /YOUR_INSTALL_PATH/src/what-am-doing/signal.sh, and pick whatever key combo you'd like.

Task Window Keybindings

• F11 Toggle fullscreen
• Esc Close task window
• Enter Start top task (or make a new task with current search phrase if no results)
• Ctrl + P Pause current task
• Ctrl + D Pause current task and mark it Done
• Ctrl + X Cancel current task
• Ctrl + N New task
• Ctrl + R Refresh todolists
• Ctrl + L or Ctrl + F Focus the task search