mirror of
https://github.com/KevinMidboe/zoff.git
synced 2025-10-29 18:00:23 +00:00
88 lines
3.6 KiB
Markdown
Executable File
88 lines
3.6 KiB
Markdown
Executable File
Zoff
|
|
====
|
|
|
|
Zoff (pronounced __søff__) is a shared (free) YouTube and SoundCloud based radio service, built upon the YouTube API, and SoundCloud API, with integrated casting with Chromecast.
|
|
|
|
Zoff supports importing YouTube, SoundCloud and Spotify playlists, and has functionality that (tries to) export to YouTube, SoundCloud and Spotify.
|
|
|
|
<a href="https://zoff.me"><img height="80" src="https://puu.sh/BlSwW/57061de17b.png"></a><a class="android-image-link" href="https://play.google.com/store/apps/details?id=zoff.me.zoff&hl=no&pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1"><img alt="Get it on Google Play" height="65" src="https://puu.sh/BcWup/f560259c3f.png"></a>
|
|
<a style="padding-bottom:20px;" class="apple-image-link" href="https://itunes.apple.com/us/app/zoff/id1402037061?ls=1&mt=8"><img height="65" alt="Get it on the AppStore" src="https://puu.sh/BcWvt/09002407c3.png"></a>
|
|
|
|
|
|
|
|
|
|
## Install
|
|
|
|
Prerequisites:
|
|
|
|
```
|
|
MongoDB : https://www.mongodb.org/
|
|
NodeJS : https://nodejs.org/en/
|
|
npm : https://www.npmjs.com/
|
|
```
|
|
|
|
Clone this repository into a folder, and navigate to it. Use ```$ npm install``` in the project folder.
|
|
|
|
For the server to run, you have to have the files
|
|
|
|
```
|
|
api_key.js
|
|
mongo_config.js
|
|
```
|
|
|
|
in ```/server/config```. There are ```*.example.js``` files for all the ones mentioned above. If you're going to deploy the server with a certificate, you also need to create the ```cert_config.js``` in ```/server/config/```. If you want the mailing to work, take a look at ```mailconfig.example.js``` and ```recaptcha.example.js```. You'll need ```mailconfig.js``` and ```recaptcha.js``` for this to work.
|
|
|
|
If you want to use Google Analytics, have a look at ```analytics.example.js``` in ```server/config/```.
|
|
|
|
Use ```$ npm start``` to start the server. (Alternative you can use the ```pm2.json``` in the project-root, if you prefer pm2 for running the apps.)
|
|
|
|
More info in <a href="https://github.com/zoff-music/zoff/blob/master/server/README.md">server/ README</a>
|
|
|
|
### About
|
|
|
|
Zoff is mainly a webbased service. The website uses <a href="https://nodejs.org/">NodeJS</a> with <a href="http://socket.io/">Socket.IO</a>, <a href="https://www.mongodb.org/">MongoDB</a> and express on the backend, with JavaScript and <a href="http://materializecss.com/">Materialize</a> on the frontend.
|
|
|
|
The team consists of Kasper Rynning-Tønnesen and Nicolas Almagro Tonne, and the project has been worked on since late 2014.
|
|
|
|
### Contact
|
|
|
|
The team can be reached on <a href="mailto:contact@zoff.me?Subject=Contact%20Zoff">contact@zoff.me</a>
|
|
|
|
### Screenshots of desktop version:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Embedded player:
|
|
|
|
|
|
|
|
### Screenshots of the mobile version:
|
|
|
|
<div style="text-align:center;">
|
|
<img src="http://i.imgur.com/aWlEmIx.png" alt="frontpage" height="600px">
|
|
<br>
|
|
<img src="https://puu.sh/xCI6X/1aead5e1b6.png" alt="channel" height="600px">
|
|
|
|
<img src="https://puu.sh/AhKUE/f93daa8a46.png" alt="channel search" height="600px">
|
|
</div>
|
|
|
|
### Legal
|
|
|
|
Creative Commons License
|
|
Zoff is licensed under a
|
|
<a href="http://creativecommons.org/licenses/by-nc-nd/3.0/no/">Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Norway License.</a>.
|
|
Do not redistribute without permission from the developers.
|
|
|
|
Copyright © 2018
|
|
Kasper Rynning-Tønnesen and Nicolas Almagro Tonne
|