---
name: "worklog"
section: "1"
platform: "linux"
package: "worklog"
version: "2.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/worklog"
---

# worklog(1)

a program for keeping track of time spent on different projects

## NAME

worklog -  a program for keeping track of time spent on different projects

## SYNOPSIS

**worklog** \[\<project config file\> \[\<log file\>\]\]

## DESCRIPTION

*worklog* is a program that helps you keep track of your time. *worklog* is a simple ncurses based based program that runs a clock and logs time to a logfile.  When *worklog* is invoked, it reads the project configuration file, and periodically appends to the log file throughout the extent of its run. Individual logfiles are also kept on a per-project basis. The key of each project is used to construct a separate log file made unique by appending .X to the name of the main log file where X is the key character.  Press Control-L to redraw the screen (sometimes useful when resizing the window).

## THE PROJECT CONFIGURATION FILE

The *project configuration file* is a text file containing a project and its associated key-character on separate lines.  The format of a project line is :

**\<key\>:\<name\>**

Comments may be preceded by the # character

## EXAMPLE PROJECT CONFIGURATION FILE

```
# Worklog project file
# note that projects appear in Worklog in REVERSE order
B:BOWER consultation
L:LIS consultation
R:Research
D:DEC system administration
P:Problems email
S:Sugar administration
r:Reading NetNews
```

## AUTHOR

*worklog* was written by Truxton King Fulton II

## BUGS

If you find one, please report it to trux@truxton.com