meltaxa/slackview repository overview

⁠Slack View

Stream in real time a Slack channel to a web page.

Slack View is a web app that can show mutliple Slack channels as separate Slack View pages.

⁠Demo

This is a live Slack View example of the Bad Actors Slack channel from https://mellican.com/badactors⁠:

These bad actors aren't from Hollywood.

⁠Configuration

⁠To obtain a Slack API and BOT token:

1. Visit https://api.slack.com/apps⁠

2. Click "Create New App"

3. Call the App "SlackView"

4. Under Features > OAuth & Permissions > Scopes, add the following OAuth scopes:

   • channels:history
   • channels:read
   • users:read
   • emoji:read

5. Under App Level Tokens > Generate Token and Scopes > add a token name and the connections.write scope.

6. Click "Generate"

7. Copy App Token value and update it in the config.yml file.

8. Click Install App to Workspace

   Accept permissions by clicking the "Allow" button.

9. Copy the Bot User OAUTH Token value and update it in the config.yml file.

⁠Add SlackView to the channel

1. The SlackView "bot" app needs to join the channel by issuing the invite command from the channel:

   /invite @SlackView

⁠Docker version

1. Create a config directory which will be mounted as a volume for Docker.

2. Place your config.yml in the config directory. See config.yml-example⁠ for details.

3. Run the Docker image with the volume switch to mount your config directory as /config in the image. For example:

   docker run -v /path/to/config_dir:/config -p 7000:7000 -e TZ=Australia/Brisbane meltaxa/slackview

   Note, by default the Docker container will be set in UTC timezone. Set the timezone using the -e TZ=... option.

4. The Slack View app will be running on: http://<ip address>:7000