Skip to content

shabane/radio

Repository files navigation

Static Badge Static Badge Static Badge Static Badge Static Badge

Simple serverless no-bullshit Radio web-app written with pure Vuejs. focusing on listening without distracting on what music to listen!

The Idea

well, when I start to coding, I need a music which make me focus on the code, before this site I just used telegram for my musics and the messages I got or its notifications and the ability to change and selecting the music make me distract again!

so decided to create a website for listening to musics without any distractions, just open to listen ;)

the only two ability users have are that they can change between stations and increase/decrease volume.

How It Works?

all musics come from github! and the web-ui it self serve from github pages. everything are on the github.

technically we have one directory per each music genre like the rock repo which all the rock musics come from. the radio it self have a specific directory called station, where stations listed there as git submodule. the web-ui will request an API call to list all the stations and then it will request for listing station musics and after all, it will play one randomly.

How To Add Station?

to adding a new station for example jazz you must create a github repo with this structure:

jazz
└── files
    ├── bg
    └── musics
  • all musics goes to jazz/files/musics
    • music files should be in .opus format(thie make them smaller file size)
  • each station should have a background image in jazz/files/bg
    • background image name should be bg. for example: bg.[gif]
    • the format extension can be one of: [gif, png, jpg, webp]

then just open an issue and tell me your station repo url.

the repo should be on github

Donation :)

if you find this stuff useful, then I will be happy for receive any donation