hamster-tools/README.md

hamster-tools

Manipulate hamster-time-tracker data from the command-line, including:

• find duplicate activities
• list, move and delete categories, activities and facts

Merging, renaming and otherwise tidying-up the database used to be possible, but currently (as of version 2.0.0.16) doesn't work for me, so I wrote this script to fill in the gap until the shiny new version of hamster is ready.

$ pip install .

$ hamster-tools categories --help
Usage: hamster-tools categories [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  activities  Show activities for categories specified by IDS
  delete      Delete categories specified by IDS
  list        List / search categories

$ hamster-tools activities 
Usage: hamster-tools activities [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  delete           Delete activities specified by IDS
  find-duplicates  Show activities which are not unique in their categories
  list             List / search activities
  list-facts       Show facts for activities
  move             Move activities to another category
  move-facts       Move facts from one activity to another

$ hamster-tools export 
Usage: hamster-tools export [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  kimai  Export time tracking data in Kimai format

Importing into Kimai

1. Run hamster-tool activities list --csv to get a dump of all activities
2. Review the export to check for any duplicates, typoes, etc.
3. Use e.g. hamster-tool activities move-facts ... to clean them up