Help / Troubleshooting
I added music but the app does not see it
You copied an album into your music folder, or downloaded something new, and it is not in the library. It is nearly always one of these, most likely first.
The short answer
Open the Tools tab and press Rescan Library ("Find new and changed files"). That walks every registered folder for anything new or changed. If it still does not appear, that folder is almost certainly not a library folder yet: add it with Add Folder on the same tab and it is scanned straight away.
1. The folder is not one of your library folders
Vesari Stylus only looks inside the folders you registered with Add Folder. Music copied anywhere else is invisible, and rescanning will not find it.
Two ways to fix it:
- Add Folder and pick the folder the music is in. Choose the top folder of the collection, not the individual album, and avoid one inside a folder you already added, because a nested folder is dropped as redundant on the next rescan. How scanning works has more.
- Or move the music into a folder already registered, then Rescan Library.
One quirk: a junction or symlinked folder inside a library folder is not followed, so music behind one is never picked up. Add that location as a library folder in its own right.
Import Music on the Tools tab is the alternative: it copies files into a library folder and skips what you already have.
2. It is on a NAS or network drive
Folders on your PC and on attached drives are watched, so new files there appear on their own. Network drives and NAS shares are not watched. Music added to a network folder stays invisible until you press Rescan Library.
The same goes for anything copied in while the app was closed: watching only runs while Vesari Stylus is open, so a rescan is how you catch up.
3. The folder is offline
If a drive or share cannot be reached, its tracks are marked offline rather than deleted. The Tools tab names the offline folder, and in Library Health the row Offline / unreachable tracks lists what is affected, with Reconnect & re-probe to restore them once the drive is back.
On a NAS or a mapped network drive, a banner also runs across the top reading Network share unavailable, with a Retry button. An unplugged USB or local drive is handled the same way but gets no banner, so Library Health is where to look.
Nothing is lost. Reconnect the drive, press Reconnect & re-probe, then Rescan Library to pick up anything added while it was away.
One case catches people out: running Vesari Stylus as administrator hides mapped network drives, because Windows ties a mapped drive to the sign-in token that created it, and an elevated app runs under a different one. The app says so when it happens and suggests running normally: your Z: drive is fine, the elevated app just cannot see it.
4. The file type is not one the app indexes
New files are found by their extension, and the everyday formats are covered: FLAC, MP3, M4A and AAC, OGG, Opus, WAV, AIFF, WavPack, Monkey's Audio, WMA, Matroska audio, and the surround formats DTS, AC-3, E-AC-3 and TrueHD.
An extension the app does not recognise is passed over silently: files saved as .mpc, .tta, .shn or .alac, and files with no extension at all. That list is not every extension the scanner accepts, so check Supported audio formats before assuming yours is out. Playlist files such as .m3u are not tracks, so they never appear as one.
5. The file was flagged and skipped on purpose
The app checks a file's contents against its extension before reading it, so something renamed to track.flac that is really a program, script or archive is skipped and never decoded. Those files are listed in Library Health under Flagged non-audio files, with the reason. If you know a file is genuinely audio, press Allow and its folder is rescanned so it indexes. Dismiss leaves it out and stops the reminder.
6. It is in the quarantine area
When you tidy duplicates, the extra copies move into a quarantine area inside your library rather than being deleted, and scans skip it so they cannot walk back in. If a track you wanted ended up there, open the duplicate review, switch to the Quarantine tab and press Restore.
7. It is already there, just hidden
If the same recording exists in more than one place, the extra copies are hidden from the Tracks, Albums and Artists views so each track shows once. Files the app indexed but could not decode are hidden by that same filter. So a new copy of something you own may be tucked away rather than missing, and a damaged file may never show. The bar above the library counts both, as duplicates and as damaged, and Show reveals them. Why do I see two different "duplicate" numbers? goes into this.
Still nothing?
If the folder is registered, the drive is online, the files are in a supported format and a rescan still does not find them, tell us. Use the in-app option to report a problem, with the folder path and an example filename. How to report a problem shows what to send.