Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
loan-mgt committed Sep 16, 2024
1 parent 002d52f commit b9fa63e
Showing 1 changed file with 47 additions and 6 deletions.
53 changes: 47 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,52 @@
# cpe-calendar
Sync your CPE calendar with your personal one
<div align="center">
<img width=200 alt="logo cpe-calendar" src="/static/favicon.svg">

# CPE calendar

Sync your CPE calendar with your personal one.

</div>

# About

The goal of the CPE Calendar is to offer students easy and effortless access to their school schedule by syncing it with their personal calendar. This works on all devices (phones, computers, laptops) and with any calendar provider, including Apple and Google.

The calendar automatically updates every hour, keeping you informed of any schedule changes. This project is open-source, and contributions or issue reports are welcome on GitHub.

# Setup

1. Frist step is to setup your own `.env` use as reference `exemple.env`
2.
```
1. The first step is to set up your own `.env` file. Use `example.env` as a reference.
2. Then run the production version using Docker Compose.

# Known Issues

There can be an issue starting the Docker environment on Windows due to the missing `make-key.sh` script.

# Development

If you want to run the project without the Docker environment, follow these steps:

### Generate the needed key
```bash
openssl genrsa -out secret/private.pem 2048
openssl rsa -in secret/private.pem -pubout > static/public.pem
```
```

### Start the code
```bash
go mod download
go run main.go
```

# Trust

As with all hosted open-source projects, there's no guarantee that the instance owner hasn't modified the official code. This implies a certain level of trust in the service chain. Depending on your trust level or risk tolerance, consider the following:

1. **Full Trust**: Use the service as is.
2. **Partial Trust**: Limit potential risks by creating a dedicated password for the service.
3. **No Trust**: As this is an open-source project, you can host your own instance. A guide is available for setting it up.

# Affiliation

This project is entirely independent and is not affiliated with any school or organization.

0 comments on commit b9fa63e

Please sign in to comment.