https://github.com/kyzn/euro-2020-slack-bot

A script to notify Slack channels with live updates from EURO 2020 matches.
https://github.com/kyzn/euro-2020-slack-bot

slack soccer

Last synced: 9 days ago
JSON representation

A script to notify Slack channels with live updates from EURO 2020 matches.

• Host: GitHub
• URL: https://github.com/kyzn/euro-2020-slack-bot
• Owner: kyzn
• License: mit
• Created: 2021-05-20T15:02:07.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-06-28T20:46:00.000Z (over 3 years ago)
• Last Synced: 2025-01-12T13:50:15.202Z (15 days ago)
• Topics: slack, soccer
• Language: Perl
• Homepage:
• Size: 132 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![A sample run](sample.png)

# NAME

euro-2020-slack v0.06

# DESCRIPTION

Downloads EURO 2020 live game status from football-data.org & posts to Slack.

You can install system dependencies on a ubuntu flavored OS like below.

    apt-get update

    apt install make cpanminus gcc libssl-dev zlib1g-dev

Once you have cpanm, run following to install perl dependencies.

    cpanm --installdeps .

# SYNOPSIS

First, you will need a Football-Data.org token.

- Go to [https://www.football-data.org/client/register](https://www.football-data.org/client/register) and register

- You will get an email titled "Your free API-key for football-data.org"

- Copy the token, keep it safe

Then, you will need a Slack incoming webhook URL. Here's how to get it:

- Create an app at [https://api.slack.com/apps?new\_app=1](https://api.slack.com/apps?new_app=1)

- Choose "From Scratch" if asked

- Below "Add features and functionality", click "Incoming webhooks"

- Turn on "Activate Incoming Webhooks"

- Click "Add New Webhook to Workspace" down below

- Choose the channel you want the bot to interact with

- Copy webhook URL, take a note. Don't share this with other people.

- Go to your app details page at [https://api.slack.com](https://api.slack.com)

- Go to "Incoming webhooks" on left navigation, it will be there.

Post to slack incoming webhook URL.

    perl euro-2020-slack.pl --token=.. --slack=https://hooks.slack.com/services/..

Increase politeness sleep for outgoing HTTP requests (defaults to 2 seconds)

    perl euro-2020-slack.pl --token=.. --slack=.. --sleep=10

Change delay (in minutes) to post to slack (put 0 for no delay. defaults to 3 mins)

    perl euro-2020-slack.pl --token=.. --slack=.. --delay=1

Specify multiple Slack URLs to post to multiple workspaces

    perl euro-2020-slack.pl --token=.. --slack=... --slack=...

Specify name and location of db.json file. This may be

helpful if you are running multiple instances of script.

    perl euro-2020-slack.pl --token=.. --slack=... --dbjson=some/file.json

Do a dry run: Don't post to slack, don't write to db.json

    perl euro-2020-slack.pl --token=... --dry

# CONTRIBUTING

PRs are welcome, but you are encouraged to discuss it in issues first.

Please don't edit this README directly, it's auto generated with commands below.

    cpanm Pod::Markdown

    echo -e '![A sample run](sample.png)\n\n' > README.md && pod2markdown euro-2020-slack.pl >> README.md

# LICENSE

MIT.

This script talks to [football-data.org](https://www.football-data.org/),

please check their terms for your use case.

# ATTRIBUTION

This script is partly based on

[j0k3r/worldcup-slack-bot](https://github.com/j0k3r/worldcup-slack-bot)

which was written in PHP.

Football data provided by the Football-Data.org API.