owntone-server/docs/index.md

82 lines
2.9 KiB
Markdown
Raw Normal View History

---
hide:
- navigation
- toc
---
# OwnTone
**OwnTone** is an open source (audio) media server for GNU/Linux, FreeBSD
2024-04-22 11:32:26 -04:00
and macOS.
It allows sharing and streaming your media library to iTunes (DAAP[^1]),
2024-04-22 11:32:26 -04:00
Roku (RSP), AirPlay devices (multi-room), Chromecast and also supports local
playback.
You can control OwnTone via its web interface, Apple Remote (and compatible
DAAP/DACP clients), MPD clients or via its JSON API.
Besides serving your local music, podcast and audiobook media files,
OwnTone supports internet radios and Spotify (requires Spotify premium account).
Prior to version 28, OwnTone was called forked-daapd, which again was a rewrite
of mt-daapd (Firefly Media Server).
OwnTone is written in C with a web interface written in Vue.js.
[^1]:
DAAP stands for Digital Audio Access Protocol which is the protocol used by
iTunes and friends to share/stream media libraries over the network.
## Features
- Stream to :material-cast-variant: AirPlay (synchronized multiroom) and :material-cast:
Chromecast devices
- :material-music-box-multiple-outline: Share local library with iTunes and Roku
- :material-volume-high: Local audio playback with ALSA or PulseAudio
- Supports multiple different clients:
2024-03-28 21:54:34 -04:00
- :material-cellphone: Remote apps like Apple Remote (iOS) or Retune (Android)
- :material-web: Integrated mobile friendly web interface
- :material-console: MPD clients
- Supports :material-music: music and :material-book-open-variant:
audiobook files, :material-microphone: podcast files and :material-rss: RSS
and :material-radio: internet radio
- :material-file-music: Supports audio files in most formats
- :material-spotify: Supports playing your Spotify library (requires
Spotify premium account)
- :material-raspberry-pi: Runs on low power devices like the Raspberry Pi
---
![Now playing](assets/images/screenshot-now-playing.png){: class="zoom" }
![Music browse](assets/images/screenshot-music-browse.png){: class="zoom" }
![Music album](assets/images/screenshot-music-album.png){: class="zoom" }
_(You can find more screenshots from OwnTone's web interface [here](control-clients/web.md))_
{: class="text-center" }
---
## Looking for help?
Before you continue, make sure you know what version of OwnTone you have,
and what features it was built with (e.g. Spotify support).
How to find out? Go to the [web interface](http://owntone.local:3689) and
check. No web interface? Then check the top of OwnTone's log file (usually
2024-03-28 21:54:34 -04:00
`/var/log/owntone.log`).
Note that you are viewing a snapshot of the instructions that may or may not
match the version of OwnTone that you are using.
If you are looking for help on building OwnTone (not using it), then
please see the documentation on [Building from Source](installation.md).
## References
You can find source and documentation, also for older versions, here:
2024-04-22 11:32:26 -04:00
- [Source Code](https://github.com/owntone/owntone-server.git)