Sonar command line client

The command line client is an open source script that will help you take advantage of the Sonar API.

At the moment, sonar-cli allows you to list your new messages. It does not support sending messages.

Download & install

You can use your browser or your command line to download the script.

You can download the script from the following urls:

You can verify the checksum after download:

# sha256sum 

Once you download the script, you need to uncompress it:


And then assign the correct permissions:

chmod 750

Now you need to add your api key to the script. Edit the script with your text editor and add your api key in the api_key variable, it should look like this:


When you add your api key between the quotes, it will look similar to this:


Now the installation is finished and you can run the script with the following command:


If you don't have new messages, you will receive the following output:

Trying mirror 1...
There are no new messages

If you have new messages, the output will be like this:

Trying mirror 1...

If you have new messages and jq installed, you get a nicer output like this instead:

Trying mirror 1...
  "1": {
    "from": "guest-d89c3c31aa",
    "date": "2020-03-16"

It is important to protect your API key. If somebody gets access to your API key, they will be able to:

Even if somebody has access to your key, they won't be able to:


For more information about the API, you can check our API documentation.

If you have any question, do not hesitate to contact us using our contact form.

The private PGP key is stored encrypted so even if the server gets hacked the hacker gets no keys.
For higher security, you can manually encrypt the messages with PGP.

PGP key · FAQ · Contact Us · Donate · API · Sonar-cli

Sonar is listed on
Dark Eye · Raptor