Congegni
/
sintonia
7
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
sintonia/docs/index.md

30 lines
1.5 KiB
Markdown
Raw Normal View History

Add basic Mkdocs config and initial docs.
2017-03-03 15:43:14 +01:00
Welcome to LibreTime
====================
Add "or terrestrial" in 1. sentence
2017-03-05 14:18:41 +01:00
LibreTime makes it easy to run your own online or terrestrial radio station. Check out some [features](features.md) and [screenshots](features.md#screenshots), then [install it](install.md) and start broadcasting!
Add basic Mkdocs config and initial docs.
2017-03-03 15:43:14 +01:00
LibreTime is Free/Libre and Open Source Software (FLOSS). Among other things, this means that you have the freedom to:
* Run it royalty-free for as long as you like.
* Read and alter the code that makes it work (or hire someone to do this for you!)
* Contribute documentation, bug-fixes, etc. so that everyone in the community benefits.
LibreTime is a fork of AirTime due to stalled development of the FLOSS version. For background on this, see this [open letter to the Airtime community](https://gist.github.com/hairmare/8c03b69c9accc90cfe31fd7e77c3b07d).
Getting Started
---------------
Clarify some docs and improve code highlighting.
2017-03-03 19:27:51 +01:00
The easiest way to check out LibreTime for yourself is to run a local instance in a virtual machine. Assuming you already have Git, Vagrant and Virtualbox installed, just run:
Add basic Mkdocs config and initial docs.
2017-03-03 15:43:14 +01:00
Add more vagrant docs Complete with links to the usual tooling needed, some info on vagrant ssh and a small troubleshooting section.
2017-03-10 12:31:19 +01:00
```bash
git clone https://github.com/libretime/libretime.git
cd libretime
Update vagrant docs for new ubuntu boxes
2017-04-16 01:33:41 +02:00
vagrant up ubuntu-trusty
Add more vagrant docs Complete with links to the usual tooling needed, some info on vagrant ssh and a small troubleshooting section.
2017-03-10 12:31:19 +01:00
```
Clarify some docs and improve code highlighting.
2017-03-03 19:27:51 +01:00
Vagrant Debian support (and experimental CentOS) This changes the Vagrant setup to support multiple installations as multiple boxes. In addition to Ubuntu Vagrant can now be used to install on Debian as well as on CentOS. I took the chance to clean up the .deb install a bit and backported analyzer and celery to SysV proper so it runs there. Some of the distro specfics were moved to the install script from the python setup scripts to acheive this. For the CentOS support I added a rather involved OS prepare script. In the long term this will be added to the preparing-the-server docs we already have. I had to switch the default port to http-alt (8080). On CentOS 9080 is registered for ocsp and getting it to work for apache without hacking SELinux is hard. I think 8080 is the RFC way to go anyhow. If anyone want to override this it should be rather easy using the --web-port arg and by hacking Vagrantfile. The PyOpenSSL code has been refactored for all the distros that the Vagrantfile now supports. As far as my checks go, I tried this code with all the distros, uploaded a track and downloaded a unicode and a ssl podcast and was able to listen to them in each case. In the experimental CentOS case, the UI is not up to spec since services need to get scheduled through systemctl and the status overview (ie. on the /?config page) do not work properly. They need to be as follows: ``` sudo systemctl start airtime-playout sudo systemctl start airtime-liquidsoap sudo systemctl start airtime_analyzer.service sudo systemctl start airtime-celery.service ```
2017-03-08 12:39:59 +01:00
If everything works out, you will find LibreTime on [port 8080](http://localhost:8080), icecast on [port 8000](http://localhost:8000) and the docs on [port 8888](http://localhost:8888).
Install airtime in vagrant env Uses the old installer to get LibreTime installed quick and dirty on vagrant. It uses the `install -fIap` command that does a local install and points the apache config directly to the local working copy mounted in /vagrant. While we don't have fancy autoloading for libretime like the docs do, this way it's already easy to work against a local branch. I'm not sure if the `-I` arg to the installer also covers the python parts of libretime.
2017-03-06 12:03:11 +01:00
Add more vagrant docs Complete with links to the usual tooling needed, some info on vagrant ssh and a small troubleshooting section.
2017-03-10 12:31:19 +01:00
Of course, this setup isn't appropriate for production use. For that, check out our [installation instructions](install.md). More information on the vagrant setup are in [the docs](vagrant.md).