n8n-nodes-centovacast

This is an n8n community node that lets you manage Centova Cast streaming servers directly from your n8n workflows.

Centova Cast is a web-based control panel for internet radio stations that supports SHOUTcast, Icecast, and other streaming server software.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
  • Community Nodes (Recommended)
  • Docker Installation
  • Building from Source
• Credentials
• Operations
  • Server Operations
  • System Operations
• Usage Examples
• API Reference
• License

Installation

Community Nodes (Recommended)

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Click Install a community node
4. Enter n8n-nodes-centovacast and click Install
5. The node will be available immediately — no restart required

Note: Community Nodes is available from n8n version 0.187.0 and above.

Docker Installation

If you are running n8n in Docker, follow these steps:

1. Build the package (if not already built)

git clone https://github.com/Sakretsos/n8n-nodes-centovacast.git
cd n8n-nodes-centovacast
npm install
npm run build
npm pack

This will create a n8n-nodes-centovacast-0.2.0.tgz file.

2. Install into your n8n Docker container

# Create the target directory (first time only)
docker exec -it n8n sh -c "mkdir -p /home/node/.n8n/custom/node_modules/n8n-nodes-centovacast"

# Copy the tgz into the container
docker cp n8n-nodes-centovacast-0.2.0.tgz n8n:/tmp/

# Extract and install
docker exec -it n8n sh -c "cd /tmp && tar xzf n8n-nodes-centovacast-0.2.0.tgz && cp -r package/* /home/node/.n8n/custom/node_modules/n8n-nodes-centovacast/"

# Restart n8n to load the new node
docker restart n8n

Note: Replace n8n with your actual n8n container name. You can find it with docker ps.

3. Updating to a new version

# Clear the old version
docker exec -it n8n sh -c "rm -rf /home/node/.n8n/custom/node_modules/n8n-nodes-centovacast/*"

# Copy and extract the new tgz
docker cp n8n-nodes-centovacast-0.2.0.tgz n8n:/tmp/
docker exec -it n8n sh -c "cd /tmp && tar xzf n8n-nodes-centovacast-0.2.0.tgz && cp -r package/* /home/node/.n8n/custom/node_modules/n8n-nodes-centovacast/"

# Restart n8n
docker restart n8n

Building from Source

# Clone the repository
git clone https://github.com/Sakretsos/n8n-nodes-centovacast.git
cd n8n-nodes-centovacast

# Install dependencies
npm install

# Build the project
npm run build

# Create the tgz package
npm pack

Development

To watch for changes during development:

npm run dev

Credentials

To use this node, you need to configure the Centova Cast API credentials in n8n:

Tip: For Server operations, the credentials password is used to authenticate against the target account. For System operations, the admin password is required.

Operations

Server Operations

Operations for managing individual streaming server accounts.

System Operations

Admin-level operations for managing the Centova Cast installation.

Usage Examples

Check Server Status

1. Add a Centova Cast node to your workflow
2. Select Resource: Server
3. Select Operation: Get Status
4. Enter the Account Username of the stream to check
5. Optionally set Mountpoints to check specific mount points

Start/Stop a Stream

1. Add a Centova Cast node
2. Select Resource: Server
3. Select Operation: Start or Stop
4. Enter the Account Username

List All Accounts

1. Add a Centova Cast node
2. Select Resource: System
3. Select Operation: List Accounts
4. Optionally set a Filter keyword and Limit

Create a New Account

1. Add a Centova Cast node
2. Select Resource: System
3. Select Operation: Provision
4. Fill in the required fields: Username, Hostname, IP Address, Port, etc.

API Reference

This node implements the Centova Cast JSON API. All requests are sent via POST for security (passwords are not logged in URL parameters).

The API uses two main classes:

• Server class - requires account username + password, manages individual streams
• System class - requires admin password, manages the entire Centova Cast installation

For full API documentation, visit: https://centova.com/doc/cast/internals/API_Reference

Compatibility

• n8n version: 1.0.0+
• Node.js version: 22+
• Centova Cast version: 3.x

License

This project is licensed under the MIT License.