---
name: "roarsin"
section: "1"
platform: "linux"
package: "roarclients"
version: "1.0~beta12-4"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/roarsin"
---

# roarsin(1)

RoarAudio sound server test clients

## NAME

roarcat2sock, roarcatad, roarsin, roarsockconnect - RoarAudio sound server test clients

## SYNOPSIS

roarcat2sock \[OPTIONS\]...

roarcatad \[OPTIONS\]...

roarsin

roarsockconnect HOST PORT

## DESCRIPTION

This clients are primary for test perpose but may be useful for someone or can be used as examples.

- **roarcat2sock**

  This is the same as [**roarcat**(1)](/roarcat/1.md) but uses [**roar\_simple\_new\_stream**(3)](/roar_simple_new_stream/3.md) to open the audio stream.

- **roarcatad**

  This is also the same as [**roarcat**(1)](/roarcat/1.md) but uses [**roar\_stream\_add\_data**(3)](/roar_stream_add_data/3.md) to fill the server's input buffer.

- **roarsin**

  This is the complete version of the sinus generator from [**roartut**(7)](/roartut/7.md). It plays a 5 second middle C (523.2Hz) sine.

- **roarsockconnect**

  **This is just a test tool connecting somewhere via roar\_socket\_connect**(3). First the data of stdin is copied to the socket than the data from the socket to stdout. It's a very simlple semi-bi-directional version of [**netcat**(1)](/netcat/1.md).

## GENERAL OPTIONS

**NOTE: This list is incomplete!**

- **--help**

  Print some help text.

## AUDIO OPTIONS

- **--rate RATE**, **-R RATE**

  Set server sample rate.

- **--bits BITS**, **-B BITS**

  Set server bits.

- **--chans CHANNELS**, **-C CHANNELS**

  Set server channels.

## NETWORK OPTIONS

- **--server SERVER**

  The server to connect to

## ENVIRONMENT VARIABLES

Below only the basic environment variables are listend. For a complete list see [**libroar**(7)](/libroar/7.md).

- **HOME**

  The users home directory.

- **ROAR\_SERVER**

  The address of the listening server. This may be in form of host:port for TCP/IP connections and /path/to/sock for UNIX Domain Sockets. See [**roartips**(7)](/roartips/7.md) for a full list. This is the same as the **--server** option.

## BUGS

There are a lot of bugs...

## SEE ALSO

[**roarctl**(1)](/roarctl/1.md), [**roarvorbis**(1)](/roarvorbis/1.md), **roarfish**(1), [**roarbaseclients**(1)](/roarbaseclients/1.md), [**roartips**(7)](/roartips/7.md), [**libroar**(7)](/libroar/7.md), [**RoarAudio**(7)](/RoarAudio/7.md).

## HISTORY

For history information see [**RoarAudio**(7)](/RoarAudio/7.md).