Skip to content

robojumper/steam_workshop_discord

Repository files navigation

steam_workshop_discord

A python program that polls the Steam workshop of specified games for new mods and posts them to a Discord channel using a webhook.

grafik

Dependencies

  • Python 3.5+
  • toml (python3 -m pip install toml)

Setup

  1. Generate a Steam Web API key and one (or more) Discord webhook(s).

  2. Determine the Steam ID of the games whose workshop pages you are interested in.

  3. Create a copy of config.toml.template named config.toml, open it with a text editor, fill out the information.

  4. Create a cron job (or find a dfferent scheduler) that regularly runs the script.

Inner workings

The script maintains a list of all the mods it has posted to each channel. Whenever it is run, it determines the workshop pages it needs to fetch, requests the ten latest mods from each page. For each channel, if the channel has no recorded mods, those mods are listed as recorded. Otherwise, the new mods are filtered, and author+mod information is requested. Using mod and author information, a message is assembled, which is then posted to each channel that needs it. Only upon a successful (HTTP 204) request, the mod is recorded as posted.

Compatibility policy

New versions of this script may break compatibility with previous deployments. For updates to running deployments, the author recommends configuring the new deployment without a known_mods file, running the old version one final time, then running the new deployment once immediately. As of the current version, the script will never post mods to a channel if the channel hasn't been recorded in known_mods, so there will be no duplicate posts.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

About

A python script that posts new mods from the Steam workshop to Discord channels.

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages