starred/audiobookshelf
1
0
Fork 0
mirror of https://github.com/advplyr/audiobookshelf.git synced 2026-05-30 23:40:40 +02:00
Code Issues 1.0k Packages Projects Releases 10 Wiki Activity

[Enhancement]: Make automatic cover search / download toggleable #1964

New Issue
Closed
opened 2026-04-25 00:01:50 +02:00 by adam · 7 comments
adam commented 2026-04-25 00:01:50 +02:00
Owner
Copy Link
Copy Source

Originally created by @kuldan5853 on GitHub (May 7, 2024).

Describe the feature/enhancement

I recently matched my library into ABS, and there are some books / shows that have no metadata that can be found online - the files are just files, and should be treated as such.

However, for some reason ABS tried to match covers to each of those files, downloading absolutely any random kind of cover or image from somewhere, but nothing that was correct for the actual files (It was also explicitly only covers, not any kind of metadata).

I had to go through 600 files one by one to unset the wrongly matched cover - and I have looked up and down the scanner settings but did not see a way to turn off this auto-matching?

Originally created by @kuldan5853 on GitHub (May 7, 2024). ### Describe the feature/enhancement I recently matched my library into ABS, and there are some books / shows that have no metadata that can be found online - the files are just files, and should be treated as such. However, for some reason ABS tried to match covers to each of those files, downloading absolutely any random kind of cover or image from somewhere, but nothing that was correct for the actual files (It was also explicitly only covers, not any kind of metadata). I had to go through 600 files one by one to unset the wrongly matched cover - and I have looked up and down the scanner settings but did not see a way to turn off this auto-matching?
adam added the enhancement label 2026-04-25 00:01:50 +02:00
adam closed this issue 2026-04-25 00:01:50 +02:00
adam commented 2026-04-25 00:01:50 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (May 7, 2024):

All retrieval of covers from the internet is manually initiated through a Match or Quick Match. By default the covers are not overwritten during a Quick Match unless you have enabled the "overwrite cover" setting, and during a normal match you have the option to get the cover or not.

Covers are automatically extracted from your media files during a scan if there is not an associated image file.

@nichwall commented on GitHub (May 7, 2024): All retrieval of covers from the internet is manually initiated through a Match or Quick Match. By default the covers are not overwritten during a Quick Match unless you have enabled the "overwrite cover" setting, and during a normal match you have the option to get the cover or not. Covers are automatically extracted from your media files during a scan if there is not an associated image file.
adam commented 2026-04-25 00:01:51 +02:00
Author
Owner
Copy Link
Copy Source

@kuldan5853 commented on GitHub (May 7, 2024):

All retrieval of covers from the internet is manually initiated through a Match or Quick Match. By default the covers are not overwritten during a Quick Match unless you have enabled the "overwrite cover" setting, and during a normal match you have the option to get the cover or not.

Covers are automatically extracted from your media files during a scan if there is not an associated image file.

That is the point though - all I did was to copy the files into the folder. I never did a manual match or quick match on those files, and it still downloaded random covers for the episodes...

The files also do not contain any embedded covers.

@kuldan5853 commented on GitHub (May 7, 2024): > All retrieval of covers from the internet is manually initiated through a Match or Quick Match. By default the covers are not overwritten during a Quick Match unless you have enabled the "overwrite cover" setting, and during a normal match you have the option to get the cover or not. > > Covers are automatically extracted from your media files during a scan if there is not an associated image file. That is the point though - all I did was to copy the files into the folder. I never did a manual match or quick match on those files, and it still downloaded random covers for the episodes... The files also do not contain any embedded covers.
adam commented 2026-04-25 00:01:52 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (May 7, 2024):

That is the point though - all I did was to copy the files into the folder. I never did a manual match or quick match on those files, and it still downloaded random covers for the episodes...

The files also do not contain any embedded covers.

Can you provide some logs for this? Based on the other issues you've opened just now it sounds like you are doing a quick match to either the files or entire library, at which point the covers are downloaded.

@nichwall commented on GitHub (May 7, 2024): > That is the point though - all I did was to copy the files into the folder. I never did a manual match or quick match on those files, and it still downloaded random covers for the episodes... > > The files also do not contain any embedded covers. Can you provide some logs for this? Based on the other issues you've opened just now it sounds like you are doing a quick match to either the files or entire library, at which point the covers are downloaded.
adam commented 2026-04-25 00:01:52 +02:00
Author
Owner
Copy Link
Copy Source

@kuldan5853 commented on GitHub (May 7, 2024):

Can you provide some logs for this? Based on the other issues you've opened just now it sounds like you are doing a quick match to either the files or entire library, at which point the covers are downloaded.

I just did an experiment, and set up a random set of music mp3s without embedded covers up as a series of "books".
All I did was to copy the files into the library folder, never did any manual quick-match or match. This is what it looks like (see attached screenshot). I also attached the server log from this event.

As you can see on the screenshot, it matched basically random cover images on music tracks..
abs.txt
Screenshot 2024-05-07 223005

@kuldan5853 commented on GitHub (May 7, 2024): > Can you provide some logs for this? Based on the other issues you've opened just now it sounds like you are doing a quick match to either the files or entire library, at which point the covers are downloaded. I just did an experiment, and set up a random set of music mp3s without embedded covers up as a series of "books". All I did was to copy the files into the library folder, never did any manual quick-match or match. This is what it looks like (see attached screenshot). I also attached the server log from this event. As you can see on the screenshot, it matched basically random cover images on music tracks.. [abs.txt](https://github.com/advplyr/audiobookshelf/files/15240554/abs.txt) ![Screenshot 2024-05-07 223005](https://github.com/advplyr/audiobookshelf/assets/168973729/3ad1529e-498c-4b55-8323-0123bd0707b3)
adam commented 2026-04-25 00:01:52 +02:00
Author
Owner
Copy Link
Copy Source

@kuldan5853 commented on GitHub (May 7, 2024):

Okay, I'm stupid.

There's a "find covers" toggle in the scanner settings...
And also a toggle for "prefer matched metadata"...

... sorry about that. I must have been very tired when configuring that.

I was looking for these options on the individual settings per library on the "scanner" tab, but it was a server wide toggle on the settings page.

@kuldan5853 commented on GitHub (May 7, 2024): Okay, I'm stupid. There's a "find covers" toggle in the scanner settings... And also a toggle for "prefer matched metadata"... ... sorry about that. I must have been very tired when configuring that. I was looking for these options on the individual settings per library on the "scanner" tab, but it was a server wide toggle on the settings page.
adam commented 2026-04-25 00:01:52 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (May 7, 2024):

Oh, glad you found that. I completely forgot about that setting. Maybe it should be moved from server settings to library settings.

Also the "prefer matched metadata". Not sure if that will lead to more confusion in the future though.

@nichwall commented on GitHub (May 7, 2024): Oh, glad you found that. I completely forgot about that setting. Maybe it should be moved from server settings to library settings. Also the "prefer matched metadata". Not sure if that will lead to *more* confusion in the future though.
adam commented 2026-04-25 00:01:52 +02:00
Author
Owner
Copy Link
Copy Source

@kuldan5853 commented on GitHub (May 7, 2024):

Oh, glad you found that. I completely forgot about that setting. Maybe it should be moved from server settings to library settings.

Yes, that is where I expected it to be (because you probably want different settings per library to begin with).

I just went through all the settings page by page when I noticed those options... anyway, I know how to prevent this happening in the future :)

@kuldan5853 commented on GitHub (May 7, 2024): > Oh, glad you found that. I completely forgot about that setting. Maybe it should be moved from server settings to library settings. Yes, that is where I expected it to be (because you probably want different settings per library to begin with). I just went through all the settings page by page when I noticed those options... anyway, I know how to prevent this happening in the future :)
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
authentication
backlog
bug
chapter editor
config-issue
ebooks
encoding/embedding
enhancement
help wanted
listening sessions & progress
planned
possible plugin
progress sync
pull-request
Mirrored from GitHub Pull Request
 sorting/filtering/searching
unable to reproduce
upload
users & permissions
waiting
No Label enhancement
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam (Adam Melkus)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#1964
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?