Add documentation links (#1931)

README.md

@@ -9,10 +9,6 @@
 
 Turn your Home Assistant instance into a jukebox, hassle free streaming of your favourite media to Home Assistant media players.
 
-## Attention: Running Home Assistant 2023.3 or later?
-Make sure to install at least the 2023.6.bx BETA version of Music Assistant HA Integration. Older versions of the Integration are not compatible with recent Home Assistant versions. Music Assistant HA Integration version [2023.12.0](https://github.com/music-assistant/hass-music-assistant/releases/tag/2023.12.0) was released on Dec. 29 and should be used in the first instance.
-
-
 ## Introduction
 
 Music Assistant is a music library manager for your offline and online music sources, combined with the power of Home Assistant to easily stream your favourite music to a wide range of supported players.
@@ -21,122 +17,38 @@ Music Assistant consists of multiple building blocks:
 
 - Music Assistant Server (2.0):  the core part that runs the Music Assistant engine and keeps track of your Music sources. This will be installed automatically as an addon in HAOS when installing the Integration. Alternatively, you can manually install the addon in HAOS or install the server in a separate docker container.
 - Music Assistant integration for Home Assistant: Connects Home Assistant to your Music Assistant Server to automate your music!
-- Home Assistant Plugin for Music Assistant: Import Home Assistant media players into the Music Assistant engine to use as target for playback. (available soon).
+- Home Assistant Plugin for Music Assistant: Import Home Assistant media players into the Music Assistant engine to use as targets for playback.
 
 ---
 
-### Features
-
-- Supports multiple music sources through a provider implementation.
-- Many popular streaming services are supported, as well as local files.
-- Auto matches music on different providers (track linking).
-- Fetches metadata for extended artist information.
-- Keeps track of the entire music library in a compact database
-- Gapless, crossfade and volume normalization support for all players.
-- Truly hassle free streaming of your favourite music to players, no advanced knowledge required.
-- Rich User interface (Progressive Web App) powered by VueJS 3.
-
----
-
-### Preview
-
-![Preview image](https://raw.githubusercontent.com/music-assistant/hass-music-assistant/main/screenshots/screen1.png)
-
-<details>
-<summary>Click to show more screenshots</summary>
-
-![Preview image](https://raw.githubusercontent.com/music-assistant/hass-music-assistant/main/screenshots/screen3.png)
-
-![Preview image](https://raw.githubusercontent.com/music-assistant/hass-music-assistant/main/screenshots/screen2.png)
-
-![Preview image](https://raw.githubusercontent.com/music-assistant/hass-music-assistant/main/screenshots/screen4.png)
-
-![Preview image](https://raw.githubusercontent.com/music-assistant/hass-music-assistant/main/screenshots/screen5.png)
-
-</details>
+### Documentation
 
----
+See here https://music-assistant.io
 
 ## Installation of the Music Assistant Server
 
-You need the Music Assistant Server running in your network, which is docker based so easy to deploy.
-If you are running Home Assistant OS or Home Assistant supervisor, you can skip this step as the Home Assistant integration will take care of installing the Music Assistant Server for you as an add-on.
-
-[See here for manual steps how to deploy the Music Assistant Server.](https://github.com/music-assistant/server)
-
 MA requires a 64bit Operating System and a minimum of 2GB of RAM on the physical device or the container (physical devices are recommended to have 4GB+ if they are running anything else)
 
-## Installation of the Home Assistant (beta) integration
+Installation instructions are here https://music-assistant.io/installation/
 
-- Make sure that you have the [Home Assistant Community Store](https://hacs.xyz/) installed.
-- Within HACS, search for `Music Assistant` and click the entry in the search results.
-- Click the big (blue) button at the bottom for `Download`.
-- Click the button again and in the dialog make sure `Show beta versions` is selected if you want to use those versions.
-- Download the desired version
-- Restart Home Assistant.
-- Go to Configuration -> Integrations and click the big `+` button.
-- Look for Music Assistant and click to add it.
-- If Music Assistant does not show, refresh your browser (cache).
-- The Music Assistant integration is ready for use.
+## Installation of the Home Assistant integration
 
-NOTE: You need to set-up the players and music sources within Music Assistant itself.
-If you are running Music Assistant in docker, you need to access the webinterface at http://youripaddress:8095. When running the Home Assistant add-on, you can access the webinterface from the add-on (a shortcut can be added to the sidebar) which is more secure than via the port.
+See here https://music-assistant.io/integration/installation/
 
 ## OpenAI features
 
 During [Chapter 5 of "Year of the Voice"](https://www.youtube.com/live/djEkgoS5dDQ?si=pt8-qYH3PTpsnOq9&t=3699), [JLo](https://blog.jlpouffier.fr/chatgpt-powered-music-search-engine-on-a-local-voice-assistant/) showed something he had been working on to use the OpenAI integration along with Music Assistant. We now have this feature baked in to the integration code directly, although some extra setup is still required.
-- You need to create/add another OpenAI integration that is purely for Music Assistant.
-- Add the prompt found [here](https://github.com/music-assistant/hass-music-assistant/blob/main/prompt/prompt.txt) to the configuration of the the OpenAI integration.
-- Add a directory in your Home Assistant `config` dir name `custom_sentences/en`
-- Add the file found [here](https://github.com/music-assistant/hass-music-assistant/blob/main/custom_sentences/en/play_media_on_media_player.yaml), to that dir.
-- When setting up the Music Assistant integration, make sure that you select the correct Conversation Agent and also
-allow the auto-exposure of Mass media players to Assist
-
-![Preview image](https://raw.githubusercontent.com/music-assistant/hass-music-assistant/main/screenshots/screen6.png)
-
-## Usage and notes
-
-- Music from your music sources will be automatically loaded into the Music Assistant library. If you have multiple sources, they will be merged as one library.
-- In this first implementation there's only support for "Library items", so your favourited artists, albums and playlists. In a later release we'll provide options to browse the recommendations of the various streaming providers.
-- Items on disk are not favourited by default. You can see all items if you deselect the "in library" filter (the heart) and decide for yourself what you want in your favourites.
-- Note that at the first startup it can take a while before data is available (first sync), the Music Assistant UI will notify you about tasks that are in progress.
-- Music sources are synced at addon (re)start and every 3 hours.
-- If a song is available on multiple providers (e.g. Spotify and a flac file on disk), the file/stream with the highest quality is always preferred when starting a stream.
-- Music Assistant uses a custom stream port (TCP 8095 by default) to stream audio to players. Players must be able to reach the Home Assistant instance and this port. If you're running one of the recommended Home Assistant installation methods, this is all handled for you, otherwise you will have to make sure you're running HA in HOST network mode. Note: If the default port 8095 is occupied, the next port will be tried, and so on.
-- The HA integration will create new media_player entities for those player types which are supported natively by MA. To see the names of those players then go to SETTINGS>>DEVICES&SERVICES>>INTEGRATIONS>>MUSIC ASSISTANT. It is these players that need to be targeted in your automations.
-- See the [GitHub discussion](https://github.com/orgs/music-assistant/discussions/710#discussioncomment-7987528) for more detailed information
+
+See the instructions here https://music-assistant.io/integration/installation/#openai-features
 
 ## I need help, I have feedback
 
-- [issue tracker](https://github.com/music-assistant/hass-music-assistant/issues) to create bug reports, please include detailed info and logfiles. Please check if your issue has already been reported.
-- [feature requests](https://github.com/music-assistant/hass-music-assistant/discussions/categories/feature-requests-and-ideas): Give your vote to an existing request, join the discussion or add a new request.
+- [Documentation](https://music-assistant.io)
+- [Issue tracker](https://github.com/music-assistant/hass-music-assistant/issues) to create bug reports, please include detailed info and logfiles. Please check if your issue has already been reported.
+- [Feature requests](https://github.com/music-assistant/hass-music-assistant/discussions/categories/feature-requests-and-ideas): Give your vote to an existing request, join the discussion or add a new request.
 - [Q&A section](https://github.com/music-assistant/hass-music-assistant/discussions/categories/q-a-faq) Frequently asked questions and tutorials
-- [discord community](https://discord.gg/kaVm8hGpne) Join the community and get support!
+- [Discord community](https://discord.gg/kaVm8hGpne) Join the community and get support!
 
 ## I want to help
 
-With a large project like this, there is always enough todo. Not only with actual writing of code but also in documentation, providing support, testing etc. Ofcourse you help me out greatly by donating me a few bucks but helping out can also be done in other ways:
-
-- If you like to help with the development, e.g. implementing a new music provider or fix a player specific quirk, please reach out to me on discord in a PM. I did not have time to write extended development docs but once you get the grasp of the structure it is relatively straight forward.
-- Help others out on discord or within the discussions part of Github.
-- Help out with writing documentation and HOWTO's and the FAQ's.
-- Just like [erkr](https://github.com/erkr) and [OzGav](https://github.com/OzGav) help out as a moderator on discord and Github with the load of incoming reports, request and questions. Thanks guys!
-- Make sure to like this project by clicking the "star" button and share it with others!
-
-### Donations
-
-As explained above you can also show your appreciation in all kinds of ways. Besides that donations are great for me as a small fee back for all the free time I invest in this project. For buying some test hardware and streaming provider accounts and contributions to the metadata projects.
-
-- [Github Sponsors](https://github.com/music-assistant)
-- [Buy me a Coffee](https://www.buymeacoffee.com/marcelveldt)
-
-A really big thank you in advance from me and my family!
-
-___________________________________________
-
-I hope you like my little pet project I've been working on for the last 3 years.
-I'm sure that together with the really great HA community we can grow this project into something really great. Thanks!
-
-Kind regards,
-
-Marcel
+See here https://music-assistant.io/help/