Skip to content

Commit af1bb73

Browse files
authored
Merge pull request #75 from doubleSlashde/feature/#73_update_readme_and_add_changelog
added Changelog and updated readme * fixes #73
2 parents 25fd8d3 + e05c98a commit af1bb73

20 files changed

+97
-13
lines changed

CHANGELOG.md

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

README.md

Lines changed: 27 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,40 @@
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: Will show the list of projects on the right side, instead of the left
25+
+ Hide projects on mouse leave: If you don't hover over the application the project list collapses
26+
+ Use Hotkey (`Strg`+`Win`): Change the project by using the Hotkey feature. A popup will appear at the mouse cursor.
27+
+ Save Position on Screen: Remembers the last position of the Main UI on application start.
28+
+ Ask for notes when switching project (if empty): Pops up a dialog 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")
1832

19-
# Install
20-
* Download keeptime.bat and keeptime-1.1.0-SNAPSHOT-bin.zip (see [releases](https://github.com/doubleSlashde/KeepTime/releases))
33+
+ the report screen gives you a summary for every day
34+
35+
## Install
36+
37+
* Download keeptime.bat and keeptime-<version>-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.
2340

@@ -27,11 +44,8 @@ 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**
31-
32-
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.\
33-
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.
3447
## Requirements
48+
3549
* Windows 7, 10
3650
* Linux (tested on Ubuntu 18.04)
3751
* 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)