mirror of
https://github.com/jellyfin/jellyfin.git
synced 2026-05-04 18:09:12 +03:00
CJK fonts in library cover images not rendered correctly #2502
Reference in New Issue
Block a user
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?
Originally created by @jang-geon on GitHub (Jan 12, 2021).
Describe the bug
System (please complete the following information):
To Reproduce
Maybe CJK problem
mojibake
Screenshots
@crobibero commented on GitHub (Jan 12, 2021):
https://github.com/jellyfin/jellyfin/pull/4863 should have fixed it, I guess we'll need to handle other languages?
@jang-geon commented on GitHub (Jan 12, 2021):
I tested the Japanese by looking at #4863, but I have the same problem
@nyanmisaka commented on GitHub (Jan 12, 2021):
This result can be expected as there is no CJK font in docker image.
We should let frontend handle the fonts rendering.
@caoli5288 commented on GitHub (Apr 21, 2021):
any progress?
@bingzhangdai commented on GitHub (May 20, 2021):
manually install cjk fonts inside container does not work :(
@ClearSeve commented on GitHub (May 25, 2021):
wait for
@erri120 commented on GitHub (Jun 13, 2021):
The problem is that the Container Images only have the DejaVu font installed. I recommend getting the Noto CJK OpenType/CFF Collection (OTC) from Google and either installing ths into the container or mounting it:
You want to get the Bold version because Jellyfin only uses that for the Thumbs:
e3f55a0c54/Jellyfin.Drawing.Skia/StripCollageBuilder.cs (L127-L130)Noto CJK is under the SIL Open Font License and should be packaged with Jellyfin. I'll see if I can create a PR for this.
@bingzhangdai commented on GitHub (Aug 11, 2021):
Any updates on the PR? Can the contributors make an agreement on how to put the fonts inside the image?
@bingzhangdai commented on GitHub (Nov 5, 2021):
Any updates? Can this issue be fixed in the 10.8 release?
@baoang commented on GitHub (Dec 24, 2021):
hope so.
v10.7.7 on Ubuntu 20 package installation, the same problem occurred.
@xinyo commented on GitHub (Jan 3, 2022):
Any updates? Or can someone please point me to the right place so I can create a PR for this
@myfingerhurt commented on GitHub (Jan 5, 2022):
Haven't been fixed, still not rendered correctly in the latest release 10.7.7 windows.
Unconfirmed on 10.8.0 alpha.
@YUCLing commented on GitHub (Apr 29, 2023):
This is still not fixed in 10.8.10.
@gtgo001 commented on GitHub (Jun 15, 2023):
启用备用字体的时候，注意字体的选择即可解决此问题
@CyleAR commented on GitHub (Jun 29, 2023):
I solved it
Make your volume path like this:
then put any CJK fonts into /<your path>/fonts/<fontname>/
then restart jellyfin service and remove original cover image having □□□s
I used Pretendard font but any other CJK fonts(like noto sans CJK) will work fine
@felix920506 commented on GitHub (Oct 3, 2023):
The text is rendered server side.
I think it uses server side system fonts
@cloudiesky commented on GitHub (Jan 29, 2024):
Great! works for me.
@yamanobe96 commented on GitHub (Feb 22, 2024):
This issue has been labeled as resolved but is still not resolved
There are first aid measures in the thread, but they are too difficult for beginners to understand.
Where on earth can I get CJK fonts?
I am running jellyfin with docker from synology's container manager.
How should I write it in volume?
@gnattu commented on GitHub (Feb 22, 2024):
@yamanobe96 Noto Sans Japanese can be downloaded here: https://fonts.google.com/noto/specimen/Noto+Sans+JP
Or if you are interested in all other variants, you can get it here:
https://github.com/notofonts/noto-cjk/tree/main/Sans#downloading-noto-sans-cjk
@nyanmisaka commented on GitHub (Feb 22, 2024):
I think it's time to consider adding some CJK fonts to the docker image.
Using
fonts-noto-cjkwas discussed before but it was overkill.In addition, most of the CJK fonts used by ASS/SSA subtitles can be found here.
@yamanobe96 commented on GitHub (Feb 22, 2024):
thank you!
Thank you for your kindness.
But even if I delete the thumbnail and update it, it doesn't change
Is there a difference in how volume is written?
@nyanmisaka commented on GitHub (Feb 22, 2024):
Jellyfin uses the default fonts path of Linux instead of
/fonts.So
--volume /path/to/fonts/on/host:/usr/local/share/fonts@yamanobe96 commented on GitHub (Feb 22, 2024):
thank you
but i am not able to understand
Should I register "/path/to/fonts/on/host" and "/usr/local/share/fonts" in the volume setting?
However, the location /path/to/fonts/on/host does not exist, so it cannot be selected.
@nyanmisaka commented on GitHub (Feb 22, 2024):
Replace
/path/to/fonts/on/hostwith your/docker/jellyfin/fonts.@yamanobe96 commented on GitHub (Feb 22, 2024):
Thank you for taking the time to answer my troublesome questions!
I was able to display it successfully! thank you for your kindness
@skywolf123 commented on GitHub (Jul 18, 2024):
Okay, this issue is still unresolved until version 10.9.7
@gnattu commented on GitHub (Jul 18, 2024):
Again, there is very little we can do if your server does not install the fonts that is required. You will be responsible to install it.
@skywolf123 commented on GitHub (Jul 18, 2024):
If I use the server to install it directly, I will not ask this problem at all. The question is Docker. There is neither configured docker file to implement, nor does it have a clear official guidance to configure the font. It's so long that made this issue open so long
@nabulator commented on GitHub (Jul 18, 2024):
well, there is some advice above about how to font fonts from your local host into your docker container. @skywolf123 did you try the steps above? It seems to work for others.
Edit: there seems to have been pushback in https://github.com/jellyfin/jellyfin/pull/6182 from adding new fonts to the container directly due to size issues. It seems unlikely that a simple solution to be arrived.
@felix920506 commented on GitHub (Jul 18, 2024):
@nabulator the entire set of CJK fonts are already shipped with installs of the web client in order to properly display text in the UI. We might be able to just make Jellyfin use them for things but I'm not sure.
@gnattu commented on GitHub (Jul 18, 2024):
They are in different formats so you cannot use those directly.
@theggs commented on GitHub (Jul 29, 2024):
I have created linuxserver/jellyfin based image that pre-installed Noto CJK fonts. It will resolve this without addition configuration for the fonts.
Anyone being interested can try it: https://hub.docker.com/r/theggs/linuxserver-jellyfin-notofonts
notice: if you are using offical image before, notice that linuxserver based image has some path diiferences. It may not be harm, but I suggest to create a new container or docker compose project if you would like to change the image used.
@felix920506 commented on GitHub (Jul 29, 2024):
@theggs the Linuxserver.io image has problems with the limit on the number of ffmpeg threads and may lead to the entire system crashing. It is advised to use the official image.
@theggs commented on GitHub (Jul 29, 2024):
Thanks! I may need to transform to the official image.
@chunjiw commented on GitHub (Nov 7, 2024):
I tried many font files but it never worked, I suspect I didn't have the correct font file. There is one font "NotoSansSC-VariableFont_wght.woff2" (I got from Google Fonts then convert to woff2 using google/woff2), when I use it, the cover image shows no text, no squares, just an image. When I use static font file (like NotoSansSC-Regular) from the same zip (downloaded together from Google Fonts), the cover image again shows squares.
I'm at a loss. Can anybody point me to a place where I can get a font file that works?
@felix920506 commented on GitHub (Nov 7, 2024):
@chunjiw you should use normal .ttf or .otf fonts for system fonts
@chunjiw commented on GitHub (Nov 7, 2024):
I tried .ttf as well, it does not work in my case. I'm quite confused. The same font (NotoSansSC-VariableFont_wght), ttf file does not work (shows squares), but if I convert it to woff2, the image does not have text nor square.
I tried woff2 because it is recommended in the doc
@yamanobe96 commented on GitHub (Nov 7, 2024):
It may not be the fonts that are bad, but the way they are mounted on JELLYFIN may not be good.
Maybe someone can give you the proper advice if you show them the docker configuration screen.
@chunjiw commented on GitHub (Nov 7, 2024):
Thank you for the suggestion!
I'm using Jellyfin official image in Unraid, and I mount it as a volume. I put the font file in folder
/mnt/user/media2/fontsin the host.At previous attempts, I also tried bind mount like so:
in the "Extra Parameters" option.
I see no difference between bind mount and volume in this case.
@yamanobe96 commented on GitHub (Nov 7, 2024):
I did not specify a custom folder in my environment.
Sorry, I will leave the correct advice to someone else.
@chunjiw commented on GitHub (Nov 7, 2024):
Thank you for sharing! I change
/user/local/share/fonts/customto/user/local/share/fontsand it works. I will open another issue to correct the doc.@onword commented on GitHub (Jun 15, 2025):
For anyone using Jellyfin on TrueNAS, here is the ELI5 of what I did to enable Japanese fonts overlaid on the thumbnails:
Note: this is on TrueNAS 25.04, Jellyfin App version v10.10.7, Version v1.2.5.
Hope this helps save someone some time.
@qotuzin commented on GitHub (Jun 17, 2025):
@onword you sir, are a legend. Working for me now.
@theguymadmax commented on GitHub (Nov 7, 2025):
Closing as fixed by: https://github.com/jellyfin/jellyfin-packaging/pull/98