https://github.com/rahulkrprajapati/gsuite-timesheet
An automated timesheet generator that integrates with Google Calendar, featuring invoice generation and currency conversion. Built with Svelte and designed for freelancers and small businesses.
https://github.com/rahulkrprajapati/gsuite-timesheet
currency-conversion google-calendar-api invoice-generator openai-api pnpm shadcn-svelte svelte timesheet-generator vite
Last synced: 8 months ago
JSON representation
An automated timesheet generator that integrates with Google Calendar, featuring invoice generation and currency conversion. Built with Svelte and designed for freelancers and small businesses.
- Host: GitHub
- URL: https://github.com/rahulkrprajapati/gsuite-timesheet
- Owner: rahulkrprajapati
- License: gpl-3.0
- Created: 2024-07-31T11:24:05.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-03T09:00:47.000Z (about 1 year ago)
- Last Synced: 2025-01-31T04:31:43.618Z (9 months ago)
- Topics: currency-conversion, google-calendar-api, invoice-generator, openai-api, pnpm, shadcn-svelte, svelte, timesheet-generator, vite
- Language: Svelte
- Homepage:
- Size: 950 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GSuite Timesheet Generator
This project is a GSuite Timesheet Generator that automates the process of creating timesheets from Google Calendar events. It includes features for invoice generation and currency conversion.
## Screenshots
## Prerequisites
Before you begin, ensure you have met the following requirements:
* You have installed [Node.js](https://nodejs.org/) (version 14 or later)
* You have installed [pnpm](https://pnpm.io/)
* You have a Google account with Calendar access
* You have an OpenAI API key
* You have an Exchange Rate API key
## Installation
To install the GSuite Timesheet Generator, follow these steps:
1. Clone the repository:
```bash
git clone https://github.com/yourusername/gsuite-timesheet.git
cd gsuite-timesheet
```
2. Install the dependencies:
```bash
pnpm install
```
3. Set up the Google credentials:
* Follow the [Google instructions](https://developers.google.com/gmail/api/quickstart/python#authorize_credentials_for_a_desktop_application) to set up credentials for a desktop application.
* Once you've downloaded the credentials file, rename it to `credentials.json` and place it in the root directory of the project.
You also need to create the exchange rate api key.
[Exchange Rate API](https://www.exchangerate-api.com/)
4. Create a `.env` file in the root directory and add your API keys:
```
OPENAI_API_KEY=your_openai_api_key_here
EXCHANGE_RATE_API_KEY=your_exchange_rate_api_key_here
```
## Running the Application
To run the GSuite Timesheet Generator, use the following command:
``` bash
pnpm run dev -- --open
```
This will start the development server and open the application in your default web browser. The application will be available at `http://localhost:5173/`.
## Features
* Fetch and display Google Calendar events
* Calculate total hours worked
* Generate invoices based on timesheet data
* Convert currency (USD to INR)
* Customize invoice details
## Contributing
Contributions to the GSuite Timesheet Generator are welcome. Please adhere to this project's `code of conduct`.
## License
This project uses the following license: [GNU GENERAL PUBLIC LICENSE](LICENSE)
## Contact
If you want to contact me, you can reach me at `rahul@ogha.ai`.