https://github.com/basemax/wakatimeteamreport
This Python script generates a daily report for the team lead to monitor the hourly work of team members. It tracks the number of hours spent by team members on various projects and sends the report to a Telegram group and the director's email.
https://github.com/basemax/wakatimeteamreport
api api-wakatime python python-wakatime remote remote-work script team team-wakatime team-work teamwork wakatime wakatime-api wakatime-client wakatime-python wakatime-script wakatime-software wakatime-team work workflow
Last synced: over 1 year ago
JSON representation
This Python script generates a daily report for the team lead to monitor the hourly work of team members. It tracks the number of hours spent by team members on various projects and sends the report to a Telegram group and the director's email.
- Host: GitHub
- URL: https://github.com/basemax/wakatimeteamreport
- Owner: BaseMax
- License: gpl-3.0
- Created: 2023-07-18T12:09:53.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-07-19T05:04:40.000Z (almost 3 years ago)
- Last Synced: 2025-03-28T17:08:10.422Z (over 1 year ago)
- Topics: api, api-wakatime, python, python-wakatime, remote, remote-work, script, team, team-wakatime, team-work, teamwork, wakatime, wakatime-api, wakatime-client, wakatime-python, wakatime-script, wakatime-software, wakatime-team, work, workflow
- Language: Python
- Homepage:
- Size: 37.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Wakatime Team Member Daily Report Generator
This Python script generates a daily report for the team lead to monitor the hourly work of team members. It tracks the number of hours spent by team members on various projects and sends the report to a Telegram group and the director's email.
## Prerequisites
Before running the script, ensure that you have the following dependencies installed:
- time
- pytz
- email
- smtplib
- requests
- datetime
## Configuration
To use this script, you need to set up the configuration in the config.py file. Please complete the following information:
### User Information
Provide the names of team members as keys and their respective Wakatime API keys as values in the USERS dictionary:
```python
USERS = {
'Max': '.............',
# Add more users here if needed
}
```
### Time Configuration
Set the timezone and the time when you want the script to send the report:
```python
TIME_ZONE = 'Asia/Tehran'
SEND_AT_HOUR = 0
SEND_AT_MINUTE = 0
SEND_AT_SECOND = 0
SEND_AT_MICROSECOND = 0
```
### Telegram Bot and Chat Information
Configure the Telegram bot token and chat ID:
```python
BOT_TOKEN = '473681081:xxxxxxxxxxx'
CHAT_ID = '-xxxxxxxxxxx'
```
### Date Range for the Coding Activity Report
Set the start and end dates for the coding activity report. By default, it will be set to today's date:
```python
TODAY = datetime.now().strftime('%Y-%m-%d')
START_DATE = TODAY
END_DATE = TODAY
```
### Email Configuration
Provide the necessary information for sending the daily report via email:
```python
EMAIL_SUBJECT = f"Coding Activity Report - {TODAY}"
EMAIL_SENDER = 'max@asrez.com'
EMAIL_RECEIVERS = [
'maxbasecode@gmail.com',
'98@hi2.in'
]
EMAIL_PASSWORD = 'XXXX'
```
## How to Run
- Install the required dependencies mentioned in the "Prerequisites" section.
- Configure the config.py file with the necessary information.
- Run the script. It will generate the daily report for team members and send it to the Telegram group and email recipients based on the configured schedule.
- Please make sure to keep the script running daily to get the regular reports as scheduled.
Note: Replace the placeholder values marked with ............., xxxxxxxxxxx, and XXXX in the `config.py` file with the actual API keys, tokens, chat IDs, and passwords for proper functionality.
Copyright 2023, Max Base