Magazine Library Type - Githubissues

Kareadita / Kavita

Kavita is a fast, feature rich, cross platform reading server. Built with the goal of being a full solution for all your reading needs. Setup your own server and share your reading collection with your friends and family.

http://www.kavitareader.com

GNU General Public License v3.0

6.29k stars 327 forks source link

Magazine Library Type #2578

Open majora2007 opened 9 months ago

majora2007 commented 9 months ago

Introduce a new library type called Magazines aimed for Magazines. The library behaves in the following ways:

[x] Dedicated parser with a limited set of naming conventions
[x] PDFs will open with the image reader instead of pdf reader due to how magazines are scanned/digitized
[x] Due to a lack of metadata, the UI will be much thinner. No storyline tab, only Volumes/Issues
[x] Group based on Date (March 23) and visible as Volume Number
[ ] Reading list mode needs to ensure image reader is choosen instead of PDF when PDF is in magazine
[ ] Support Side-car covers?
[ ] Supports non-pdf, but by default selects only PDF file types

After talking with users, this is the current proposal:

There will be a limited number of parsing configurations available
UK World - 2018 April -> Series: UK World, Volume 2018, Issue 4. Volumes will be the Year of the magazine. Issue will derive from Month (converted to a number) or an issue number supported by # character. Issue number will override the month.
PDFs will open in the image reader by default.
Storyline tab will be removed, but Volume and Issue will remain

Supported Parsing:

Wired/
--- US/
---------Wired Vol 2010 #1.pdf
---- UK/
---------Wired Vol 2010 #1.pdf

Output:
Series: Wired (US)
Series: Wired (UK)

Wired/
--- 2018/
Wired #1.pdf

Output:
Series: Wired

Need Feedback on:

Should these geozones be required in the series name: Wired (US)/ and not supported from parsing filenames and trying to split there?
Should the pdf reader be used or should the image viewer be used? (Currently trying to hack the image viewer to be used is adding significant overhead)

bhcompy commented 9 months ago

PDFs will open with the image reader instead of image reader

I assume one of those is some other kind of reader?

majora2007 commented 9 months ago

PDFs will open with the image reader instead of image reader

I assume one of those is some other kind of reader?

The image reader is what you'd experience when opening archives. From what I saw with magazines, they are mainly scans and as such, the aren't going to need the full power (or limitations) of the PDF reader itself.

Enissay commented 8 months ago

What about the folder tree requirements ? Many/most magazines have specials, and many others have geographical editions (WIRED US, UK, ME). Something like this:

wired/
├── me
├── special
├── uk
└── us

Also, some naming conventions which help keeping the collection ordered:

# 91 is the issue number
Magazine.091.2024.04.pdf

#10 is the issue number
OtherMagazine.2023.01.010.pdf

majora2007 commented 8 months ago

@Enissay I noticed different geographical editions. How would you expect them to be organized? I currently have them grouping under the issue.

Can you give me an example of Specials?

Enissay commented 8 months ago

@majora2007 Here are a few concrete examples:

How it works

Regular issues: HERE
Special issues

All About Space

Regular issues: HERE
Special issues
- Black Holes
- Space Exploration
- Apollo Missions
- ...

Enissay commented 8 months ago

I noticed different geographical editions. How would you expect them to be organized? I currently have them grouping under the issue.

What do you mean under the issue, I am new to Kavita so forgive my ignorance xD

Anyhow, an easy way is as I showed above: all editions separated in sub-folders under the same Magazine name So when I open a given magazine: I would have many sections/tabs: wired_me (for middle east edition), wired_us (for US edition), ...

wired/
├── me
├── special
├── uk
└── us

majora2007 commented 8 months ago

What I'm asking is how you are consuming them and how they are named/grouped.

For example, based on what I've done so far, you'd have: Wired (UK) Wired (US) Wired (ME)

as different Series. Then Volumes (representing the year) and Issues. Specials I can add support for as well.

The reason I broke it up like this is because UK and US editions of the same magazine Issue 1 will have different ISBNs, so it makes sense that they are broken up by series.

Is this aligned with your own understanding or are you suggesting something else and if so, what?

Enissay commented 8 months ago

Yes, that sounds reasonable enough! Not sure if the docker nightly has any of these changes but I would be glad to test it out. The current Manga/Comic options are not fully fitting my use case :>

majora2007 commented 8 months ago

It's in development, but nearing the end of the first pass and there will be a nightly soon. I HIGHLY encourage feedback as I don't collect magazines and this is being made to help the community.

Cantello commented 8 months ago

I know that this was supposed to be exclusively for magazines, but I have some old-ish newpaper archives that are also organized like maagzines, just on a daily basis. Would this overwhelm the parser or would it be okay?

Berliner Zeitung/
├─ Berliner Zeitung - 1945-05-22.pdf
├─ Berliner Zeitung - 1945-05-23.pdf
├─ Berliner Zeitung - 1945-05-24.pdf
├─ Berliner Zeitung - 1945-05-24 (Beilage).pdf
├─ Berliner Zeitung - 1945-05-25.pdf

TinuBE commented 7 months ago

I have some old Magazine from Micky Maus. I have saved the Files like this:

Micky Maus Magazin ├─ 1951 ├── Micky Maus Magazin -v1951 #01.cbz ├── Micky Maus Magazin -v1951 #02.cbz ├─ 1952 ├── Micky Maus Magazin -v1952 #01.cbz ├── Micky Maus Magazin -v1952 #02.cbz ├─ 1953 ├── Micky Maus Magazin -v1953 #01.cbz ├── Micky Maus Magazin -v1953 #02.cbz

But the Structure-Parsing does not working. I have also tested with Special (SP) instead of # . still the same.

Enissay commented 4 months ago

I know that this was supposed to be exclusively for magazines, but I have some old-ish newpaper archives that are also organized like maagzines, just on a daily basis. Would this overwhelm the parser or would it be okay?
Berliner Zeitung/
├─ Berliner Zeitung - 1945-05-22.pdf
├─ Berliner Zeitung - 1945-05-23.pdf
├─ Berliner Zeitung - 1945-05-24.pdf
├─ Berliner Zeitung - 1945-05-24 (Beilage).pdf
├─ Berliner Zeitung - 1945-05-25.pdf

I think this is similar to: https://github.com/Kareadita/Kavita/discussions/2541

nodecentral commented 1 month ago

Having a Magazine structure in Kavita would be amazing, I’ve not imported mine yet as I’ve not got a folder structure fully sorted for them yet (I have 100s) , plus as it’s not a fully supported feature, I’m prepared to wait a bit longer.

My planned (partially implemented) folder structure is theme based, so “Sport & Leisure”, “Cooking”, “Health & Fitness” etc. and I’m considering a level below e.g Entertainment / Movies

├─ Magazines
       ├─ Sport & Leisure 
              ├─ FIFA World Cup - March 2024.pdf

idij commented 2 weeks ago

I noticed that when magazines (pdf) are organized like this then the specific volume does not show a count of issues in the volume:

Title/Title Vol. 2024/Title Vol. 2024 #01
Title/Title Vol. 2024/Title Vol. 2024 #02

Whereas when named like either of these, it does show the count on the volume, but not all issues are shown when clicking on the volume or even under the issues tab. Only first issue in each volume, get shown, and so all but the first issue in a volume is inaccessible.

Title/Title Vol. 2024/Title Vol. 2024 ch01
Title/Title Vol. 2024/Title Vol. 2024 01

Also, items in Title/Title Vol. 2024/Specials don't seem to stand out in any way, and are just listed as regular issues.

Thanks for an awesome project by the way!