Timew Command Examples (with examples)
Use Case 1: Start a new stopwatch, giving a tag name to the activity being tracked
Code:
timew start activity_tag
Motivation:
This command is useful when you want to track the time spent on a specific activity. By giving a tag name to the activity, you can easily identify and differentiate between multiple activities.
Explanation:
activity_tag: This is the tag name for the activity being tracked. It can be any string that identifies the activity.
Example Output:
Started activity "Coding" at 2021-09-20T10:00:00
Use Case 2: View running stopwatches
Code:
timew
Motivation:
This command allows you to see all the running stopwatches, i.e., activities that are currently being tracked. It helps you quickly check which activities are ongoing without having to manually search through the tracked items.
Example Output:
ID Started Active Tags
1 2021-09-20 10:00 2h 30m Coding
2 2021-09-20 15:30 1h 15m Designing
Use Case 3: Stop the stopwatch with a given tag name
Code:
timew stop activity_tag
Motivation:
When you want to stop tracking a specific activity, you can use this command by providing the tag name of the activity. It stops the stopwatch for that particular activity, allowing you to accurately measure the time spent and move on to the next task.
Explanation:
activity_tag: This is the tag name of the activity you want to stop. It should match the tag name of the running stopwatch.
Example Output:
Stopped activity "Coding" at 2021-09-20T12:30:00
Use Case 4: Stop all running stopwatches
Code:
timew stop
Motivation:
In situations where you want to stop all running stopwatches simultaneously, this command comes in handy. It saves you the effort of stopping each stopwatch individually, especially when you have multiple ongoing activities.
Example Output:
Stopped activity "Coding" at 2021-09-20T11:00:00
Stopped activity "Designing" at 2021-09-20T16:15:00
Use Case 5: View tracked items
Code:
timew summary
Motivation:
This command generates a summary of all the tracked items, providing an overview of the activities completed and their respective durations. It helps in analyzing productivity and identifying time-consuming tasks.
Example Output:
Tracked in 6h 45m, while 1h 30m was unaccounted for.
Most tracked:
Coding 3h 30m
Designing 1h 45m
Unaccounted for:
Uncategorized 1h 30m
By using the timew summary command, you can easily see the total time tracked, the durations of individual activities, and any unaccounted time.
Use Case 6: Start a new stopwatch with specific time and tag
Code:
timew start activity_tag @{YYYY-MM-DDTHH:MM:SS}
Motivation:
Sometimes, you may want to retroactively track an activity with a specific start time, especially when you forgot to start the stopwatch in real-time. This command allows you to start a stopwatch at a specific time and associate it with the desired activity.
Explanation:
activity_tag: The tag name for the activity being tracked.@{YYYY-MM-DDTHH:MM:SS}: The start time in the format of Year-Month-DayTHour:Minute:Second.
Example Output:
Started activity "Writing" at 2021-09-20T09:30:00
Use Case 7: Modify the start or end time of a tracked item
Code:
timew modify @[ID] start @{YYYY-MM-DDTHH:MM:SS}
timew modify @[ID] end @{YYYY-MM-DDTHH:MM:SS}
Motivation:
There can be situations where you need to adjust the start or end time of a tracked item. This command allows you to modify the timestamps of specific activities, ensuring accurate time measurements.
Explanation:
@[ID]: The ID of the tracked item you want to modify.@{YYYY-MM-DDTHH:MM:SS}: The new start or end time in the format of Year-Month-DayTHour:Minute:Second.
Example Output:
Modified start time of activity "Coding" to 2021-09-20T09:00:00
Modified end time of activity "Coding" to 2021-09-20T12:00:00
Use Case 8: Delete a tracked item
Code:
timew delete @[ID]
Motivation:
If you want to remove a specific tracked item from the records, this command allows you to delete it. Deleting unnecessary or duplicated activities helps in maintaining a clean and accurate tracking history.
Explanation:
@[ID]: The ID of the tracked item you want to delete.
Example Output:
Deleted activity "Meeting" with ID 5
Deleting the activity “Meeting” with ID 5 will remove it from the tracked items list.
