arching-kaos

Arching Kaos is a project for building a Web Radio Station. It consists from tools that allow us to play its content, upload new one, persist it on IPFS, make use of CJDNS for authenticating contributors and provide an IRC server for communication of producers, contributors, fans etc. The goal is to reach decentralization as we currently see is happening all around the world.

All dependencies can be resolved from the init.sh script provided for Fedora systems. Testing got into place in Fedora, Ubuntu and Gentoo Linux distributions for v1.0 tag. After this checkpoint, the focal distribution is Fedora Linux version 34.

Releases

Currently master is used for development updates. Below, you find available releases with a full working state.

v1.0

Working instance, checked etc:

• commit 6fb9a4d765f05c169742ec450c6418d276c7cad8

v2.0

Arching Kaos v2.0 involves development of new tools.

Keep an eye on arching-kaos-roadmap.

Documentation

Documentation can be found on /docs/

Can be launched with docker too

./scripts/docker-arching-kaos-docs.sh

Install and run

From fresh Fedora installation

As root: sh -c "$(curl -fsSL https://github.com/kaotisk-hund/arching-kaos/raw/master/init.sh)"

Cloning manually

Clone the repository using git:

git clone https://git.arching-kaos.net/kaotisk/arching-kaos.git

Change into that directory:

cd arching-kaos

and run

./install

Components

Torrent tracker

This is for future use.

• Simple install

Docker with opentracker ./scripts/docker-opentracker.sh

IRC

Next Generation IRC daemon.

• Simple install

Static files:

• ./etc/ngircd/ngircd.conf
• ./etc/ngircd/ngircd.motd

Scripts:

• ./scripts/configure-ngircd.sh
• ./scripts/docker-ngircd.sh

Web server

nginx web server

• Simple install

Configuration is done with:

• ./scripts/configure-nginx.sh

Either mount on docker or copy this folder:

• ./etc/nginx/conf.d/

Stream server

icecast2

• Simple install

Static files:

• ./etc/icecast2/icecast.xml

Scripts:

• ./scripts/docker-icecast.sh

Player

liquidsoap

• Simple install

Static files:

• ./etc/liquidsoap/radio.liq

Scripts:

• ./scripts/docker-liquidsoap.sh

Storage

FS

Generic storage folder

Theoritical volume:

• ./storage

Torrent

We store no torrents. Future release.

IPFS

• Simple install

Mount location:

• ./storage/ipfs

Scripts

• ./scripts/docker-ipfs.sh

SSB

• Simple install

Static files:

• ./etc/ssb-pub-data

Scripts:

• ./scripts/docker-ssb-create.sh

Tools, scripts

Collection of tools and scripts

Generate playlist

./scripts/gen-playlist.sh

Experimental stuff

Environment tools

"grep"s the variables of the project

scripts/grep-env.sh

Supposingly we are going to use this to render all the configuration through it

scripts/sed-example.sh

Example is for rendering {$LOCATION} variable to "earth".

CJDNS tools

Strip comments from cjdroute configuration

scripts/cjdroute-strip-comment.sh