{"id":22546386,"url":"https://github.com/antonengelhardt/kicktipp-bot","last_synced_at":"2025-04-10T00:52:15.687Z","repository":{"id":144681505,"uuid":"565802635","full_name":"antonengelhardt/kicktipp-bot","owner":"antonengelhardt","description":"A bot which can submit tips for a Kicktipp competition based on quotes.","archived":false,"fork":false,"pushed_at":"2025-02-16T07:03:00.000Z","size":133,"stargazers_count":18,"open_issues_count":9,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-10T00:52:07.635Z","etag":null,"topics":["bot","kicktipp","python","selenium","selenium-python","sportbetting","sports","webscraper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/antonengelhardt.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-11-14T11:05:33.000Z","updated_at":"2025-01-05T21:14:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"5c7afbd0-f2d5-411b-b300-abc6c7ee5b31","html_url":"https://github.com/antonengelhardt/kicktipp-bot","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonengelhardt%2Fkicktipp-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonengelhardt%2Fkicktipp-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonengelhardt%2Fkicktipp-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonengelhardt%2Fkicktipp-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/antonengelhardt","download_url":"https://codeload.github.com/antonengelhardt/kicktipp-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137996,"owners_count":21053775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","kicktipp","python","selenium","selenium-python","sportbetting","sports","webscraper"],"created_at":"2024-12-07T15:07:27.344Z","updated_at":"2025-04-10T00:52:15.651Z","avatar_url":"https://github.com/antonengelhardt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kicktipp-bot\n\nThis script can automatically enter tips into Kicktipp based on the quotes of the bookmakers. It is written in Python and uses Selenium to interact with the website.\n\n## Run\n\nCopy the contents of the `.env.example` file into a new file called `.env` and fill in the values.\n\n### Python\n\nIf you use the [fish shell](https://fishshell.com/), you can use the `envsource .env` command, from [this GitHub Gist](https://gist.github.com/nikoheikkila/dd4357a178c8679411566ba2ca280fcc) to load the environment variables.\n\n```bash\n# Install dependencies\npip install -r requirements.txt\n\n# Run the script\npython main.py\n\n# Headless mode\npython main.py --headless\n```\n\n### Docker\n\nInstall Docker and run the following commands.\n\n```bash\n# Get Image\ndocker pull ghcr.io/antonengelhardt/kicktipp-bot:amd64\n\n# Run Container and set your env variables\ndocker run \\\n-it \\\n--name kicktipp-bot \\\n--platform linux/amd64 \\\n--env-file .env \\\nghcr.io/antonengelhardt/kicktipp-bot:amd64\n```\n\nor deploy with Kubernetes.\n\n## Environment Variables\n\n| Variable | Description | Example | Required |\n| --- | --- | --- | --- |\n| `KICKTIPP_EMAIL` | Your Kicktipp email | `email@example.com` | Yes |\n| `KICKTIPP_PASSWORD` | Your Kicktipp password | `password` | Yes |\n| `KICKTIPP_NAME_OF_COMPETITION` | The name of the competition you want to tip for | `mycoolfriendgroup` | Yes |\n| `KICKTIPP_HOURS_UNTIL_GAME` | The script will tip games which start in the next x hours | `24` | No |\n| `KICKTIPP_RUN_EVERY_X_MINUTES` | The script will run every x minutes | `60` | No |\n| `CHROMEDRIVER_PATH` | The path to the chromedriver binary | `/usr/bin/chromedriver` | No |\n| `ZAPIER_URL` | The URL of your Zapier Webhook | `https://hooks.zapier.com/hooks/catch/123456/abcdef/` | No |\n| `NTFY_URL` | The URL of your NTFY Webhook | `https://ntfy.your-domain.com` | No |\n| `NTFY_USERNAME` | The username for your NTFY Webhook | `username` | No |\n| `NTFY_PASSWORD` | The password for your NTFY Webhook | `password` | No |\n| `WEBHOOK_URL` | The URL of some generic webhook. | `https://your-home-assistant-url.com/api/webhook/your-webhook-id` | No |\n\n## Notifications\n\nIf you want to receive a notification when the script tips for a match, you can use the Zapier or NTFY integration.\n\n### Zapier\n\nPlease create a Zapier Account and set up the following Trigger: Custom Webhook. Please also make sure you set the ENV Variable `ZAPIER_URL` to the URL of your custom webhook. Then you can set up actions like sending an email or a push notification.\n\n### NTFY\n\nSet up your [ntfy](https://github.com/binwiederhier/ntfy?tab=readme-ov-file) server and set the ENV Variables `NTFY_URL`, `NTFY_USERNAME` and `NTFY_PASSWORD` to the values of your server. Create the topic `kicktipp-bot` and subscribe to it. Then you will receive a notification when the script tips for a match.\n\n### Generic Webhook\n\nSet up a webhook (e.g in [Home Assistant](https://www.home-assistant.io/integrations/webhook/)) and set the ENV Variable `WEBHOOK_URL` to the URL of your webhook. Then you will receive a notification when the script tips for a match.\n\n## Related projects\n\n- [kicktipp-bot-serverless](https://github.com/tbrodbeck/kicktipp-bot-serverless) (written by [tbrodbeck](https://github.com/tbrodbeck)) uses Playwright instead of Selenium and runs as a one time job, so that it can be scheduled by other tools like Cron\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantonengelhardt%2Fkicktipp-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantonengelhardt%2Fkicktipp-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantonengelhardt%2Fkicktipp-bot/lists"}