Skip to content

[ComicVine] Match series with ID extracted from title or folder#224

Merged
Snd-R merged 4 commits intoSnd-R:masterfrom
matt1432:master
Nov 11, 2025
Merged

[ComicVine] Match series with ID extracted from title or folder#224
Snd-R merged 4 commits intoSnd-R:masterfrom
matt1432:master

Conversation

@matt1432
Copy link
Contributor

@matt1432 matt1432 commented May 15, 2025

I've been working on automating the downloading and metadata tagging of comic books and since I can automatically add the Comicvine ID of volumes to their folder name, I thought it would be nice for Komf to pick that up and match the metadata directly with the Comicvine ID.

To achieve this, I've added the config setting comicVineIdFormat that when set, will try to find the ComicVine ID in he folder name or series title if not found in the folder name, according to the value set.

For example, I would set the value to "[cv-{id}]", which would be converted to the following RegExp: /\Q[cv-\E(?<id>\d+)\Q]\E/, and then tested against a series' folder name.

I also added the config setting comicVineIssueName that when set, will replace a null issue.name with the value set and "{number}" replaced with the corresponding issue number.

The added bookNumberRegexes are to help with the previous point.


Pre-Edit

This is my first time doing anything in Kotlin so I'm sorry if the code is really bad but this PR is mainly a feature request if you are interested in supporting my use case.

I've been working on automating the downloading and metadata tagging of comic books and since I can automatically add the Comicvine ID of volumes to their folder name, I thought it would be nice for Komf to pick that up and match the metadata directly with the Comicvine ID.

As you can see in the code I added, I'm looking at the title of a given series to check for [CV=<some-id>] and parse <some-id> to then use client.getVolume instead of client.searchVolume.

I was also thinking this could be a config setting where a user would have to enable idParsing or something along those lines and then set the idParsingRegex so it would be configurable instead of hardcoded like I did here.

I wrote this code myself just to have a working prototype for my own collection and it's been working very well.

@ThoughtzThruKeyz
Copy link

Hey! This sounds awesome, is this still working fine for you?

@matt1432
Copy link
Contributor Author

Hey! This sounds awesome, is this still working fine for you?

Yes, I've been running my personal branch for a while without issues: https://github.com/matt1432/komf/tree/personal

@ThoughtzThruKeyz
Copy link

Awesome! So does the workflow itself change at all?

@matt1432 matt1432 closed this Oct 17, 2025
@matt1432 matt1432 reopened this Oct 17, 2025
@matt1432 matt1432 changed the title feat(comicvine): look for volume id in series title [ComicVine] Match series with ID extracted from title or folder Oct 17, 2025
@matt1432 matt1432 marked this pull request as ready for review October 17, 2025 22:47
@Snd-R Snd-R merged commit 080674b into Snd-R:master Nov 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants