dob 3.0.5

journal and time tracker, supercharged for the terminal

dob is an interactive, terminal-based time tracking application.

You’ll find Vim-like navigation, robust filtering and searching capabilities, and a colorful, customizable interface.

dob is written in Python and installs easily with pip:

$ pip install dob

The best way to learn dob is to run the demo:

$ dob demo

For other setup options, read the installation guide.

ALPHA ALERT! dob is alpha software. A proper, stable release is forthcoming this year!

• You can currently demo dob.

• You can even start using dob today, but the developers are finishing a few features, and shoring up test coverage.

  And we would not want you to get frustrated, or to file bugs for issues we already plan to fix. So please be patient!

  (You may see progress by fits and starts, but it’ll happen.)

• Please be aware that real humans have only tested the alpha code on Debian Linux (technically, Linux Mint).

  We’ll verify macOS and Windows support as part of the alpha cycle.

Ethos

dob is a developer’s tool, or at least targeted to someone who’s comfortable in the terminal.

dob is perfect for the person who asks, Why must I use my mouse to manage time tracking?

dob is inspired by Hamster, a beloved but aged time tracking application for GNOME.

Try dob today – you might like it!

• Demo dob to learn it.

• Then, start from scratch,

  or load a legacy database.

If you like dob, hopefully you’ll help us make it better!

Features

• Designed for modern Python releases (3.6, 3.7, and 3.8).

• Seamlessly integrates into your terminal-based workflow.

• Naturally Unicode compatible – spice up your notes!

• Can migrate legacy Hamster databases (and fix integrity issues, too).

• Excellent coverage (to give you comfort knowing your Facts are safe).

• Well documented features – get help at runtime, or on the command line.

• Simple, elegant code base – follows best practices, uses top libraries.

• Low bar of entry to get raw access to data – defaults to Sqlite3 file.

• Constant dogfooding (– I dob daily!)

• Free and open source – hack away!

Example

Demo dob

You can easily demo dob after installing it.

Run the demo command to load an interactive tutorial:

$ dob demo

Keep reading to learn how to create an empty data store, or how to import an existing database.