https://github.com/ziggy42/ontopic

Display SNS messages on your terminal
https://github.com/ziggy42/ontopic

aws aws-sns aws-sqs cli sns sqs

Last synced: 5 months ago
JSON representation

Display SNS messages on your terminal

• Host: GitHub
• URL: https://github.com/ziggy42/ontopic
• Owner: ziggy42
• License: apache-2.0
• Created: 2020-01-30T22:36:59.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-01-05T06:09:45.000Z (over 3 years ago)
• Last Synced: 2025-10-29T08:38:23.491Z (8 months ago)
• Topics: aws, aws-sns, aws-sqs, cli, sns, sqs
• Language: JavaScript
• Size: 1.4 MB
• Stars: 23
• Watchers: 1
• Forks: 4
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![Node.js CI](https://github.com/ziggy42/ontopic/workflows/Node.js%20CI/badge.svg)

[![NPM version](https://img.shields.io/npm/v/ontopic.svg)](https://www.npmjs.com/package/ontopic)

# ontopic

`ontopic` let's you listen to [SNS](https://aws.amazon.com/sns) notifications from your command line.  

It does so by creating an [SQS](https://aws.amazon.com/sqs) queue subscribed to the topic and polling it. 

Before the process exits the created resources are removed.  

![Demo](.github/demo/demo.gif)

You must have your `AWS` account correctly configured on your machine for `ontopic` to work.

## Installation

```

npm install -g ontopic

```

## Usage

Basic usage:

```

ontopic 

```

For more see `--help`:

```

$ ontopic --help

usage: ontopic [-h] [-v] [-r REGION] topicArn

Listen to SNS notifications

Positional arguments:

  topicArn              The SNS Topic ARN to subscribe to.

Optional arguments:

  -h, --help            Show this help message and exit.

  -v, --version         Show program's version number and exit.

  -r REGION, --region REGION

                        AWS region to use for the queue. If absent, it will 

                        be set to the environment variable AWS_DEFAULT_REGION,

                        AWS_REGION or defaulted to eu-central-1.

```