soundcloak

wip alternative frontend for soundcloud

official public instance

there is no image and audio proxy for now so beware

Setting it up

Prerequisites:

1. node.js + npm (any recent enough version should do, it's just used for getting hls.js builds)
2. golang (1.21 or higher was tested, others might work too)
3. git

Setup:

1. Clone this repository:

git clone https://github.com/maid-zone/soundcloak

2. Go into the cloned repository:

cd soundcloak

3. Download hls.js:

npm i

4. Download templ:

go install github.com/a-h/templ/cmd/templ@latest

5. Download other required go modules:

go get

6. Optional. Edit config: You can change some values in lib/cfg/init.go if you want. Keep in mind that you need to rebuild the binary each time you want to update the config.

7. Generate code from templates & build binary:

You might need to add go binaries to your PATH (add this line to your .bashrc / .zshrc / whatever)

export PATH=${PATH}:`go env GOPATH`/bin

templ generate && go build main.go

8. Run the binary:

./main

This will run soundcloak on localhost, port 4664. (by default)