go-ical-ntfy-reminder/README.md

1.7 KiB

GO ical ntfy reminder

This is a simple Go application that does iCalendar files (.ics) analyzes and sends notifications by ntfy based on the events in these iCalendar files.

Prerequisites

Before you begin, ensure you have the following installed:

Getting Started

  1. Clone the repository:

    git clone https://code.brothertec.eu/simono41/go-ical-ntfy-reminder.git
    
  2. Create an environment variables file:

    Create a file named .env in your project directory. Fill this file with the required environment variables:

    TO_EMAIL=recipient@example.com
    NTFY_AUTH=echo "Basic $(echo -n 'testuser:fakepassword' | base64)"
    NTFY_HOST=https://ntfy.sh/alerts
    ICS_DIR=/path/to/ics/files
    

    Customize the values according to your application.

  3. Build and run the Docker container:

    docker-compose up --build
    

    This command uses Docker Compose to build and run the container, loading environment variables from the .env file.

  4. Access your application:

    Open your web browser and go to http://localhost:8080.

Customizing the Docker Image

  • If your application uses additional environment variables, add them to the .env file.
  • Customize the Dockerfile or docker-compose.yml if needed.

Contributing

If you'd like to contribute, please fork the repository and create a pull request. Feel free to open an issue if you encounter any problems or have suggestions.

License

This project is licensed under the MIT License - see the LICENSE file for details.