LTCN MUSIC brings your own music into Home Assistant. Add local or NAS files, organize the library, select a player, seek within a song where supported, follow synchronized lyrics and create a speaker group—all from the interface without editing Home Assistant configuration files.

Store music on the host

Store music on the host: upload files to /media/music for a simple setup.

Store music on a NAS

Store music on a NAS: add a network folder and build a local index so browsing does not rescan the entire NAS.

01

Open MUSIC and explore the interface

Sign in to Home Assistant and choose MUSIC in the left navigation. The library is above a fixed playback bar; phones and tablets use a compact layout. Search for songs, artists or albums at the top, then browse categories, artists, albums, songs, favorites and uploads. The playback bar provides device selection, playback controls, volume, progress and a lyrics button.

Latest MUSIC home: playback bar with lyrics, volume, device selection and seekable progress
Latest MUSIC home: playback bar with lyrics, volume, device selection and seekable progress
02

Upload music or connect a NAS

Choose Upload Music or Upload Management. For local files, select Local folder, drag files into the upload area or choose files, then run Rescan. For a NAS, add a network folder, enter its address, share path and credentials, select that source and rescan. Supported formats are MP3, FLAC, M4A, AAC, WAV, OGG and Opus.

Upload Management: local and NAS sources, files and upload area
Upload Management: local and NAS sources, files and upload area
03

Scan, search and organize the library

Rescan reads song titles, artists, albums, duration and artwork into a local index. Search by song, artist, album or filename; Chinese titles also support Pinyin search. Browse by language, genre, scene, mood, decade or artist. Use Manage Categories to add or remove tags. A song can have several tags, and you can set a default category for an artist. NAS browsing uses the index after a full scan.

Browse music by category, language, genre and scene
Browse music by category, language, genre and scene
Find an artist and open their songs
Find an artist and open their songs
Manage classifications and unclassified songs
Manage classifications and unclassified songs
Add or remove tags; an artist can have a default category
Add or remove tags; an artist can have a default category
04

Select a device, play and seek

Before playback, choose a speaker, a saved group or This browser (current device) under Select playback device at the bottom right. Then start a song. Pause, skip and volume act on the chosen target. Pause retains the current position; when the device supports resuming, playback continues from that point. The bar shows elapsed time, total duration and a draggable progress handle. Drag it to a new position and release to continue there. Automatic progress refresh pauses while you drag.

05

Favorites, playlists and restart recovery

Use the heart icon to set or remove a favorite. Create, rename and delete playlists; add, remove and reorder tracks, and start a list directly or through the internal voice assistant. After Home Assistant restarts, the queue, current position, shuffle and repeat settings are restored in a paused state without automatically making sound. Starting playback after a restart begins the current song again.

06

Automatic lyrics and line-by-line scrolling

While a song plays, select the microphone icon beside its information to open lyrics. LTCN MUSIC first checks a matching lyrics file beside the song or embedded lyrics. If none is available, it searches online using title, artist, album and duration. Timed LRC lyrics highlight and smoothly scroll line by line. If the current player supports seeking, tap a line to play near it. Use the lyrics menu to choose another match, paste lyrics or upload an LRC/TXT file; manually saved lyrics go into the cache and do not change the music file.

Lyrics view: the current line is highlighted and follows playback progress
Lyrics view: the current line is highlighted and follows playback progress
07

Create a multi-speaker group

Open Speaker Groups, choose a name and select at least two Home Assistant media players. Test each speaker first. Start Test Music to hear the group, then adjust each device’s start delay in 50 ms steps until the starts sound close together. You can combine different player types, including DLNA and Apple-compatible devices. This is start-time adjustment, not continuous drift correction.

Create and test a speaker group
Create and test a speaker group

Common questions

MUSIC is missing or keeps loading

Wait for Home Assistant to finish starting, then refresh. Check Settings → Devices & services to confirm LTCN MUSIC loaded; restart Home Assistant if needed.

Uploaded songs are not in the library

Run Rescan in MUSIC. For a NAS, confirm the network folder is connected and the correct source is selected.

A speaker works in Home Assistant but not in MUSIC

Test whether the native Home Assistant media player accepts a media URL. Stop music already playing on the device, then select it again in MUSIC.

Speakers in a group still start at different times

Retest each speaker and adjust its start delay in 50 ms steps. Network conditions can change the result.

Why can’t I drag the progress bar?

The speaker may not yet have reported a reliable duration, may not support seeking, or the current audio was not pushed by LTCN MUSIC. Wait for playback to start; the bar remains read-only when safe seeking is unavailable, including mixed-platform groups.

Lyrics are missing or the match is wrong

Check the song title and artist, then choose Rematch from the lyrics menu. You can also paste lyrics or upload the corresponding LRC/TXT file.

What happens when I delete music?

File Management deletes the actual file and removes related favorites and playlist entries. Keep a backup first; read-only NAS sources may prevent deletion.

Start with one MP3 and one speaker. Once single-speaker playback works, create a group and tune its timing.

相关新闻

Leave a Reply

Your email address will not be published. Required fields are marked *

laitecn@gmail.com

QQ
微信
Whatapp

HAIOTS