owntone-server/docs/web-interface.md
chme 56da181959 [docs] Generate OwnTone documentation with MkDocs
- Copy existing README*.md and INSTALL.md files to docs folder
- Set up MkDocs to build documentation (mkdocs.yml)
- Add new index.md with a quick overview of OwnTone
2022-05-08 07:20:04 +02:00

2.7 KiB

OwnTone web interface

Mobile friendly player web interface for OwnTone build with Vue.js, Bulma.

Screenshots

Now playing{: class="zoom" } Queue{: class="zoom" } Music browse{: class="zoom" } Music artists{: class="zoom" } Music artist{: class="zoom" } Music albums{: class="zoom" } Music albums options{: class="zoom" } Music album{: class="zoom" } Spotiy{: class="zoom" } Audiobooks authors{: class="zoom" } Audiobooks{: class="zoom" } Podcasts{: class="zoom" } Podcast{: class="zoom" } Files{: class="zoom" } Search{: class="zoom" } Menu{: class="zoom" } Outputs{: class="zoom" }

Usage

You can find OwnTone's web interface at http://owntone.local:3689 or alternatively at http://[your_server_address_here]:3689.

Build Setup

The source is located in the web-src folder.

cd web-src

The web interface is built with Vite, makes use of Prettier for code formatting and ESLint for code linting (the project was set up following the guide ESLint and Prettier with Vite and Vue.js 3

# install dependencies
npm install

# Serve with hot reload at localhost:3000
# (assumes that OwnTone server is running on localhost:3689)
npm run serve

# Serve with hot reload at localhost:3000
# (with remote OwnTone server reachable under owntone.local:3689)
VITE_OWNTONE_URL=http://owntone.local:3689 npm run serve

# Build for production with minification (will update web interface
# in "../htdocs")
npm run build

# Format code
npm run format

# Lint code (and fix errors that can be automatically fixed)
npm run lint

After running npm run serve the web interface is reachable at localhost:3000. By default it expects owntone to be running at localhost:3689 and proxies all JSON API calls to this location.

If the server is running at a different location you have to set the env variable VITE_OWNTONE_URL.