Package: dob
dobis an interactive, terminal-based time tracking application.You’ll find Vim-like navigation,
robust functionality,
a customizable user experience,
lots of great plugins, and
an elegant, minimalistic interface.dobis written inPythonand installs easily withpip:$pip3installdobThe best way to learndobis to run the demo:$dobdemoFor other setup options, read theinstallation guide.Hint: You might need toupdatePATHor find wherepipinstallsdob.Quick Peekdob has lots of CLI commands, and it also includes an interactive terminal application.Here’s a little taste of what the terminal application looks like.:╭────────────────────────────────────────────────────────────────────────────────╮
│             Thu 16 Apr 2020 ◐ 02:13 PM — 03:52 PM                              │
╰────────────────────────────────────────────────────────────────────────────────╯

  duration........... :  1 hour  39 minutes
  start.............. : 2020-04-16 13:13:49
  end................ : 2020-04-16 14:52:50
  activity........... : dobumentation
  category........... : dob Development
  tags............... : #readme

┌────────────────────────────────────────────────────────────────────────────────┐
│I'm adding this Fact to the README. So meta.                                    │
│                                                                                │
│                                                                                │
│                                                                                │
│                                                                                │
│                                                                                │
│                                                                                │
└────────────────────────────────────────────────────────────────────────────────┘
Fact ID #22618                              [?]: Help / [C-S]: Save / [C-Q]: QuitThough in your terminal, you’ll see colors and font ornamentation
(bold, italic, and underline).Statusdobis released tobeta!You candemo dobto see how awesome it is!You can also start usingdob!But just be aware that it has not been vetted yet for a larger
audience — you might still encounter a few issues. But please
report them, and we’ll get them fixed.We just don’t want you to have a bad first experience.Aka,you’ve been warned!(Nonetheless, thedobbeta uses a backup file judiciously,
so if it does crash, you should not lose any unsaved data.)dob is already feature-rich, and it’s used daily (hourly!) by
the authors.To see what all the fuss is about, you canpip3 install doband rundob demoright now to try it out.Or, keep reading for an overview of dob, a list of its features,
and then detailed documentation of the interactive editor commands.OS Supportdobruns on any operating system that supports Python,
including Linux, macOS, and Windows.Please see theinstallation guidefor help getting setup.Quick StartIf you want to dive right in (after running the demo to get acquainted), try:$ dob init
$ dob editTheinitcommand creates a config file and the database,
and theeditcommand runs the interactive editor.You can also rundob--helpto see an overview of all commands.Ethosdobis a designed for developers, but suitable
for any individual whose comfortable in the terminal.dobis perfect for the person who asks,Why must I use my mouse to manage time tracking?dobis even more suited for the person who asks,How can I manage time tracking with the fewest possible keystrokes?dobis inspired byHamster,
a beloved but aged time tracking application forGNOME.dobis emulative ofVim,
an editor that enables users to concentrate on their
work while the tool itself slips into the background.Trydobtoday – you might like it!Demo dobto learn it.Then,start from scratch,orload a legacy database.If you likedob, hopefully you’llhelp us make it better!FeaturesMinimalist interactive console app fits elegantly into your terminal-based workflow.Robust configuration – and manageable via CLI if you want to avoid the config file.Fully customizable – change which keys map to which commands.Define your own user-specific paste commands – assign your own activities and tags.Undo and redo edits as you work – don’t worry if you make a mistake.Auto-complete makes it easy to set activities and tags – and shows useful stats, too.Edit text in your favorite$EDITOR– and set a file extension for highlighting.Use all the Unicode you want – spice up your notes!Personalize the interface colors – and style your own activity and tag names!Natural syntax lets you dob “offline” to a text file, that you can import later.Migrates legacy Hamster databases – and repairs integrity issues, too.Supports unrestricted plugin access – anyone can add their own commands and config.Includes command shortcuts – common command sequences mapped to a single keypress.Runs on the latest Python (3.6, 3.7, and 3.8).Broad desktop OS support – runs on Linux, macOS, and Windows.Suitably tested (though coverage could be better).Well documented – get help at runtime, on the command line, or online.Simple, smooth code base – follows best practices, and uses top libraries.Low bar of entry to get raw access to data –
defaults toSqlite3file.Constant dogfooding(– I dob daily!)Free and open source – hack away!DemoDemodobRun thedemocommand to load an interactive tutorial:$dobdemoAnd then follow the walk-through.Getting startedReadbasic usageto learn how to create an empty data store,
or how to import an existing database.Learning dobYou’ll find lots of documentation online, including:Configure dobChoose your $EDITORRun the Interactive EditorExit, Save, and Undo/RedoNavigate Facts QuicklyEdit Facts and MetadataCopy and Paste MetadataUseful Command CombinationsNudge Start and End TimePluginsPlugins make it easy for everyday dobbers to write their own
features and to share them with the broader community.The core development team has created the following plugins
for non-essential and distribution-specific features.Please note: these plugins are not yet published!(We just want to get you excited in the meantime.)Thedob-plugin-export-commitplugin exports and commits changes to your dob database on every save.Thedob-plugin-stale-fact-goaderplugin displays a GNOME-style popup notification after some amount of
inactivity to badger you to start a new Fact.Thedob-plugin-git-hipplugin tags the active Fact based on the Git branch name
pulled from the current directory.Have a great idea fordob? Implement it as a plugin!Plugins have complete access to dob.Plugins can add their own commands.Plugins can add their own configuration.Plugins can run on startup, on exit, or whenever the user saves.Plugins help keepdoblean, and they let you turn
an idea into a feature quickly and easily!Thanks!We hope you enjoy using dob as much as we have had making it!And if you like it, please tell your friends and colleagues about it.
Tell the whole world!!Keep on dobbin’!