Tuner — tuner.alumni-x.com

Subscribe to a channel.
Receive what is sent to it.

Tuner relays messages from your servers to whoever is listening, live. A fake SMS gateway for one-time codes in local and QA, a feed for CI events, a window on logs.

$ gitlab-login$ man tuner

[ONE-TIME CODES]

No real SMS provider in local and QA.

Your app sends the OTP to Tuner instead of an SMS gateway, with the phone number as the channel. Whoever is tuned in to that number sees the code at once and copies it. Nothing is paid, nothing leaves the building.

[CI EVENTS]

Know when the pipeline is done.

A job publishes to ci-main, or to a channel per branch, when a stage passes or fails. Keep the stream open and the result is in front of you, no refreshing the pipeline page.

[LIVE LOGS]

Watch a server without opening it.

Publish log lines from a script or a deploy to a channel of your choice and follow them from the browser or your phone, without SSH access to the machine.

[HOW IT WORKS]

1. $ subscribe

Open the console or the Android app and tune in to a channel: a phone number, ci-main, anything. Channel names ignore case.

2. $ publish

A server POSTs { to, content } to /messages with a GitLab token. Any language, any tool that speaks HTTP.

3. $ receive

Every subscriber of that channel gets it live. Nobody listening yet? Tuner holds it for 90 seconds and hands it to the first one to tune in.

[PUBLISH]

# from a server, a pipeline job or your terminal

curl -X POST https://tuner.alumni-x.com/tuner/messages \
  -H "Authorization: Bearer $GITLAB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"to": "+237600000001", "content": "Your code is 482913"}'

The token is a GitLab access token from hub.gitlab.alumni-x.com (scope read_user). Full reference: api docs.

[CLIENTS]

  • web — this site, any browser, iPhone included

    Several channels at once, grep, codes picked out with a copy button.

  • android — the Tuner app

    Keeps history on the phone, wakes up when a code is waiting, and can hand an OTP straight to the app that asked for it.

[BEFORE YOU USE IT]

# a testing tool, not a delivery service

  • ! Anyone signed in can tune in to any channel. Never send real customers' codes or personal data through it.
  • ! Delivery is once and live: a message is not stored on the server, and a reconnect replays nothing.
  • ✓ Sign-in is your Alumnix GitLab account; no separate password.