Skip to content

Commit d937d11

Browse files
author
Jan Schraff
committed
added Changelog and updated readme
1 parent 25fd8d3 commit d937d11

20 files changed

+114
-9
lines changed

CHANGELOG.md

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
2+
# Change Log
3+
All notable changes to this project will be documented in this file.
4+
5+
6+
## v1.2.0 - yyyy-mm-dd
7+
8+
### Added
9+
10+
- search functionality
11+
12+
- functionality to edit past work items
13+
14+
- possibility to save position on screen
15+
16+
- minutely auto-save to not lose work on crash
17+
18+
- optional reminder for notes if switching projects without notes
19+
20+
- shortcut for minimizing window (Win+Down)
21+
22+
### Changed
23+
24+
- hotkey popup has same functionality now as main project selection
25+
26+
- removed old xml import feature
27+
28+
- adapted report layout
29+
30+
- the main ui is always on top
31+
32+
- Icons changed
33+
34+
### Fixed
35+
36+
## v1.1.0 - 2019-07-15
37+
38+
### Added
39+
40+
Linux support (tested on Ubuntu 18.04), hot keys are disabled for Linux
41+
42+
- about screen with licenses of third party software
43+
44+
- colored time line to report screen
45+
46+
- copy to clipboard button to report screen
47+
48+
- convenient keyboard controls
49+
50+
### Changed
51+
52+
- new Font (OpenSans)
53+
54+
### Fixed
55+
56+
## v1.0.0 - 2018-10-28
57+
58+
### Added
59+
60+
- setting to prevent hiding the project list.
61+
62+
### Changed
63+
64+
- Decreased height of projects in list, so more projects fit in the same space
65+
66+
- "Styled" settings window
67+
68+
### Fixed
69+
70+
- (workaround) 'stuck' key when using hotkeys and locking the pc
71+
72+
## v1.0-beta.2 - 2018-09-25
73+
74+
### Added
75+
76+
- Import functionality for old config.xml
77+
78+
- Database Migrations
79+
80+
### Changed
81+
82+
- Cleaning works from UI if the work is changed on another day
83+
84+
- Moved db folder from user home/keeptime/db to ./db (relative to .jar like logs folder)
85+
86+
### Fixed

README.md

Lines changed: 28 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,39 @@
11
# KeepTime
2+
23
Application to track your time spent on different projects each day. Aim was to create an easy and fast way to track the doings over the day. In the end you get a summary for the day.
34

45
Create projects and choose if they are counted as 'work time'. Select the project you work on. Before you switch the project, write a comment on what u did. Change the project. Repeat.
56

6-
Main view (when you hover over the app):\
7-
![Alt text](/readme/images/main.png?raw=true "Main")
7+
## Usage
8+
9+
### Main view:
10+
![Main Ui with description](readme/images/contextMenuDescription.png?raw=true "Main")
811

912
+ You can move the window by dragging it around
10-
+ If you don't hover over the application the project list collapses
11-
+ Open the context menu for a project to edit/delete or change the project and transfer n minutes of the current running one
12-
+ You can change the project by clicking in the project list, or by using the Hotkey feature (if activated in settings) Strg+Win button. A popup will appear at the mouse cursor. With a mouseclick you have to first focus the app before you can make use of the search functionality. Up/Down will scroll through the projects and Enter will select the project.
13+
+ Open the context menu (with a right-click) for a project to edit/delete or change the project and transfer n minutes of the current running one
1314
+ In the taskbar you will also see the current time + the color of the active project
14-
+ You can choose the used colors for the main window, if the project list should be left or right and if you want to use the Hotkey
15+
+ The current Project will be saved eyery minute to mitigate loss on system crash or shutdown without closing window manually first.
1516
+ After a day you can open the Reports, which will summarize the work done for the different projects during the day
1617

17-
**You need to close the application manualy before you shutdown your PC. Otherwise the last running project is not saved to database.**
18+
**You need to close the application manualy before you shutdown your PC. Otherwise the last running project is not saved completely to database. (will be last state saved by auto-save)**
19+
20+
### Settings:
21+
![Settings Screen](readme/images/settings.png?raw=true "Settings")
22+
23+
+ Colors: you can define various Colors to use in the UI to customize the application. The Reset resets the color to the default color.
24+
+ Display projects on the right:
25+
+ Hide projects on mouse leave: If you don't hover over the application the project list collapses
26+
+ Use Hotkey(Strg+Win): You can change the project by clicking in the project list, or by using the Hotkey feature (if activated in settings) Strg+Win button. A popup will appear at the mouse cursor. With a mouseclick you have to first focus the app before you can make use of the search functionality. Up/Down will scroll through the projects and Enter will select the project.
27+
+ Save Position on Screen: remember the Position of the Main UI and place it there on start.
28+
+ Ask for notes when switching project (if empty): pops up a dialouge to add notes if no notes are given and you try to switch projects
29+
30+
### Reports:
31+
![Report Screen](readme/images/reportDescription.png?raw=true "Report")
32+
33+
+ the report screen gives you a summary for every day
34+
35+
## Install
1836

19-
# Install
2037
* Download keeptime.bat and keeptime-1.1.0-SNAPSHOT-bin.zip (see [releases](https://github.com/doubleSlashde/KeepTime/releases))
2138
* Extract the downloaded .zip
2239
* Copy the downloaded keeptime.bat file next to the *.jar*. Adapt the path inside the *keeptime.bat* to the name of the *.jar* file (if needed). Try starting the application by executing the *keeptime.bat* file. The start may take up to one minute.
@@ -27,11 +44,13 @@ It is recommended to run the application at computer start so you do not forget
2744

2845
You should put the .jar in an extra folder as a *logs* and a *db* folder will be created next to it.\
2946

30-
**migrate from old version**
47+
**migrate from old version (before v1.0-beta.2) **
3148

3249
If you have a folder *db* next to the old .jar, the folder has to be next to the new .jar as well. The folder contains your tracked times.\
3350
If you used this application before with a *config.xml* you can import your old projects in the settings dialog. Place your config.xml next to the jar and press "parse config.xml". Otherwise no steps are needed.
51+
3452
## Requirements
53+
3554
* Windows 7, 10
3655
* Linux (tested on Ubuntu 18.04)
3756
* Java 8 + JavaFX

readme/images/addProject.png

-7.7 KB
Loading

readme/images/contextMenu.png

584 Bytes
Loading
42.8 KB
Loading

readme/images/editProject.PNG

13.5 KB
Loading

readme/images/editWork.PNG

14.1 KB
Loading

readme/images/hover.png

-8.02 KB
Binary file not shown.

readme/images/main.png

-28.7 KB
Binary file not shown.

readme/images/mainLeft.PNG

10.3 KB
Loading

0 commit comments

Comments
 (0)