No description
  • Rust 95%
  • Dockerfile 5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2025-03-12 14:15:42 +00:00
.github/workflows first commit 2024-05-21 11:57:08 +01:00
src increase circular buffer size to 15 2025-03-12 14:14:44 +00:00
.gitignore first commit 2024-05-21 11:57:08 +01:00
Cargo.lock first commit 2024-05-21 11:57:08 +01:00
Cargo.toml bump version to 0.1.0 2025-03-12 14:15:42 +00:00
Dockerfile first commit 2024-05-21 11:57:08 +01:00
README.md first commit 2024-05-21 11:57:08 +01:00

Service Listener

A CLI tool that polls services (sites) for new releases and, optionally, sends notifications to a Discord webhook.

Supported sites

  • Splice - listens for new packs

Usage

A CLI tool that polls services (sites) for new releases and, optionally, sends notifications to a Discord webhook.

Usage: service-listener.exe [OPTIONS]

Options:
  -w, --webhook <WEBHOOK>
          The discord webhook to send notifications to (optional)
  -p, --splice-poll-rate <SPLICE_POLL_RATE>
          How often (per second) to poll for new packs on Splice [default: 60]
  -s, --disable-splice
          Disable the Splice listener
  -h, --help
          Print help
  -V, --version
          Print version

Downloading / building the tool

You can download the tool for your OS from latest releases or build manually. Steps for building manually are given below:

  1. Install Rust/Cargo via rustup
  2. Clone the repository
  3. cd into the repository
  4. Run cargo build --release
  5. The binary will be available at target/release/service-listener

Running on your computer

Once you have the binary, cd into the directory where the binary is located and run service-listener.exe or service-listener (depending if you are on Windows or not).

This will list all of the options available for the tool. Repeat the command and provide any options and arguments as needed.

Note

Here is a trick for automatically cd into the directory where the binary is located on Windows: Video

Running with Docker

You can also run the tool using Docker. Here is a couple example commands (make sure you are cd into the directory where the Dockerfile is located):

# Running with no arguments (defaults used)
docker run -it --rm ghcr.io/stefanuk12/service-listener:latest
# Running with webhook
docker run -it --rm ghcr.io/stefanuk12/service-listener:latest --webhook "https://discord.com/api/webhooks/1241502809552191509
/OXQnNf5iTFP0WBD420pnpEbXIk34PGCicsx7NuLWT6GEOL4mAJ_LjQRzBCiw00WFmqEt"

Creating a Discord webhook

This tool supports sending notifications to a Discord webhook. To create a webhook, follow this video up to the 0:52 mark. Copy the URL and provide it to the tool by using the --webhook <WEBHOOK_URL> option.

Running 24/7 for free with Oracle Cloud

  1. Follow this tutorial on setting up the server.
  2. To install Docker on Oracle Linux 8, follow this tutorial. Follow the Install Docker, Finish Docker Setup and Docker Commands as Non-Root User sections only.
  3. Follow the instructions on Running with Docker section.