hamster-tools/README.md

56 lines
1.8 KiB
Markdown
Raw Normal View History

2021-09-07 21:51:01 +00:00
# hamster-tools
2020-09-21 18:17:59 +00:00
Manipulate [hamster-time-tracker](https://github.com/projecthamster/) 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](https://github.com/projecthamster/hamster-lib) is ready.
2020-09-30 18:53:39 +00:00
$ pip install .
2020-09-21 18:17:59 +00:00
2020-09-30 18:49:55 +00:00
$ hamster-tools categories --help
2020-09-30 18:53:39 +00:00
Usage: hamster-tools categories [OPTIONS] COMMAND [ARGS]...
2020-09-21 18:17:59 +00:00
2020-09-30 18:49:55 +00:00
Options:
2020-09-30 18:53:39 +00:00
--help Show this message and exit.
2020-09-21 18:17:59 +00:00
2020-09-30 18:49:55 +00:00
Commands:
2020-09-30 18:53:39 +00:00
activities Show activities for categories specified by IDS
delete Delete categories specified by IDS
list List / search categories
2020-09-21 18:17:59 +00:00
2020-09-30 18:49:55 +00:00
$ hamster-tools activities
2020-09-30 18:53:39 +00:00
Usage: hamster-tools activities [OPTIONS] COMMAND [ARGS]...
2020-09-21 18:17:59 +00:00
2020-09-30 18:49:55 +00:00
Options:
2020-09-30 18:53:39 +00:00
--help Show this message and exit.
2020-09-21 18:17:59 +00:00
2020-09-30 18:49:55 +00:00
Commands:
2020-09-30 18:53:39 +00:00
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
2021-09-07 21:51:01 +00:00
## 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
4.