MyGES 2 ICS

MyGES2ICS is a Rust project that allows you to subscribe to your schedule using a webcal link. You can subscribe to your schedule from your native iOS, MacOS, Android, or other calendar apps.

To achieve this, you need to subscribe to the server's link using basic-auth if your calendar app supports it. If your calendar app does not support basic-auth, you can provide your credentials using query parameters.

---

How to subscribe

You can subscribe to your calendar using the server https://myges2ics.aprrn.fr that I provide or host your own one like on the instructions below.

Important

Use your own server, there is a lot of cheap VPS for students, the server that I provide can be shut down.

Using a calendar app that supports basic-auth

ICSx5 on android supports basic-auth. Then your calendar is available any app like Google Calendar or Simple Calendar Pro.

To subscribe using apps that support basic authentication, use the following URL: https://myges2ics.aprrn.fr and provide your user/password of myges.fr.

Using a calendar app that does not support basic-auth

Most calendar apps, such as the native ones on iOS, macOS, or Google Calendar, do not support basic authentication. To subscribe in such cases, you can include your username and password in the query parameters of the URL like this:

https://myges2ics.aprrn.fr/?user=USER&password=PASSWORD Please make sure to replace "USER" and "PASSWORD" with your actual myges.fr credentials.

Or if you have '#' in your password (because everything that comes after # is client-side)

https://myges2ics.aprrn.fr/?base64=BASE64 Replace BASE64 with user:password encoded in base64 with the ':' To convert in base64 you can use the following command :

echo 'user:password' | base64

---

How to run

You can run this project with docker or by launching the binary. If you want to host it I recommend to host it behind a reverse proxy like Caddy to have HTTPS

With Docker :

A sample docker-compose.yml is provided in the root folder. To launch the app with Docker, follow these steps:

1. Clone the repository
2. Build and launch with the following commands:

docker compose build && docker compose up -d

Your application is now accessible on the exported port in the docker-compose.yml file wich is by default 8080.

Build and launch the binary

To build the project you need to install the rust toolchain. After installing Rust, clone the repository and execute the following commands:

1. Build the project:

cargo build --release

2. Launch it

./target/release/myges2ics

If you want to edit the default config values you can copy the .env.example file:

cp .env.example .env

Then you can edit the values to suit your needs