Skip to content

Commit 915d0a1

Browse files
authored
Update README.md
1 parent a17523a commit 915d0a1

File tree

1 file changed

+74
-3
lines changed

1 file changed

+74
-3
lines changed

README.md

Lines changed: 74 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,76 @@
1-
### Originally forked from acocalypso/Eventwatcher-Standalone but heavily modified.
1+
### Originally forked from acocalypso/Eventwatcher-Standalone but heavily modified. Fetching from [Leek Duck](https://leekduck.com/) using [ScrapeDuck](https://raw.githubusercontent.com/bigfoott/ScrapedDuck/data/events.json).
2+
3+
# Pokémon Go Event Notifier
4+
5+
This project tracks Pokémon Go events, raids, and eggs, and sends notifications to specified Discord webhooks.
6+
7+
## Table of Contents
8+
9+
- [Features](#features)
10+
- [Prerequisites](#prerequisites)
11+
- [Installation](#installation)
12+
- [Configuration](#configuration)
13+
- [Usage](#usage)
14+
15+
## Features
16+
17+
- Tracks Pokémon Go events, raids, and eggs.
18+
- Sends notifications to Discord webhooks.
19+
- Customizable via environment variables.
20+
- Supports scheduling checks via cron syntax.
21+
22+
## Prerequisites
23+
24+
- Docker
25+
- Docker Compose
26+
27+
## Installation
28+
29+
### Pull the Docker Image
30+
31+
If you want to use the pre-built Docker image from the GitHub Container Registry:
32+
```
33+
sh
34+
docker pull ghcr.io/filikun/pkmn-event-notifier:latest
35+
```
36+
### Configure the Docker Compose File
37+
38+
version: '3.5'
39+
services:
40+
pkmn-event-notifier:
41+
image: ghcr.io/filikun/pkmn-event-notifier:latest
42+
container_name: pkmn-event-notifier
43+
environment:
44+
- DISCORD_ROLE_ID=your_discord_role_id
45+
- EVENT_WEBHOOK_URL=https://discord.com/api/webhooks/your_event_webhook_url
46+
- RAID_WEBHOOK_URL=https://discord.com/api/webhooks/your_raid_webhook_url
47+
- EGG_WEBHOOK_URL=https://discord.com/api/webhooks/your_egg_webhook_url
48+
- CRON_SCHEDULE=0 6-22 * * *
49+
restart: always
50+
volumes:
51+
- /opt/pkmn-event-notifier/.env:/usr/src/app/.env
52+
- /etc/localtime:/etc/localtime:ro
53+
- /opt/pkmn-event-notifier/logs/:/usr/src/app/logs
54+
security_opt:
55+
- no-new-privileges:true
56+
57+
## Configuration
58+
59+
### Environment Variables
60+
- `DISCORD_ROLE_ID`: The Discord role ID to mention in notifications.
61+
- `EVENT_WEBHOOK_URL`: The webhook URL for event notifications.
62+
- `RAID_WEBHOOK_URL`: The webhook URL for raid notifications.
63+
- `EGG_WEBHOOK_URL`: The webhook URL for egg notifications.
64+
- `CRON_SCHEDULE`: The cron schedule for checking events, raids, and eggs.
65+
66+
###Volumes
67+
- `/opt/pkmn-event-notifier/.env`: Environment variables file.
68+
- `/etc/localtime`: Timezone configuration.
69+
- `/opt/pkmn-event-notifier/logs/`: Logs directory.
70+
71+
72+
## Usage
73+
74+
Once deployed, the container will run according to the specified cron schedule, checking for updates and sending notifications to the configured Discord webhooks.
275

3-
Posts event notifications to Discord using webhooks.
476

5-
Fetching from [Leek Duck](https://leekduck.com/) using [ScrapeDuck](https://raw.githubusercontent.com/bigfoott/ScrapedDuck/data/events.json)

0 commit comments

Comments
 (0)