From 5957f3983351ebfa73af77f6be8fe487ee35a954 Mon Sep 17 00:00:00 2001 From: felix920506 Date: Sat, 7 Oct 2023 22:32:47 -0400 Subject: [PATCH 1/2] document fonts --- docs/general/administration/configuration.md | 20 +++++++++++++++++++ .../general/administration/troubleshooting.md | 4 ++++ docs/general/clients/codec-support.md | 4 ++++ 3 files changed, 28 insertions(+) diff --git a/docs/general/administration/configuration.md b/docs/general/administration/configuration.md index 006660b13..37718529c 100644 --- a/docs/general/administration/configuration.md +++ b/docs/general/administration/configuration.md @@ -106,3 +106,23 @@ This section lists all the configuration options available and explains their fu | `FFmpeg:analyzeduration` | `"200M"` | The value to set for the FFmpeg `analyzeduration` format option. See the FFmpg [documentation](https://ffmpeg.org/ffmpeg-formats.html#Format-Options) for more details. | | `playlists:allowDuplicates` | `True` | Whether playlists should allow duplicate items or automatically filter out duplicates. | | `PublishedServerUrl` | Server Url based on primary IP address | The Server URL to publish in udp Auto Discovery response. | + +## Fonts + +Jellyfin uses fonts to render text in many places. + +### Server Side System Fonts + +The system fonts installed on the server are used for burning in subtitles and rendering cover images. How to install them depends on the operating system. + +### Client Side System Fonts + +The system fonts installed on the client devices are used to display the text in the client interface as well as render subtitles for some clients. How to install them depends on the operating system. + +### Fallback Fonts + +The `Fallback Fonts` option is currently used by the web client to render subtitles only. This can be set to a folder containing fonts for this purpose. Lightweight formats optimized for web like woff2 are recommended. A tool to convert normal TrueType (`.ttf`) and OpenType (`.otf`) fonts to woff2 can be found [in their repo](https://github.com/google/woff2). + +### Downloading Fonts + +There are many fonts available online. [Google Fonts](https://fonts.google.com/) is a good place to download fonts for most languages. diff --git a/docs/general/administration/troubleshooting.md b/docs/general/administration/troubleshooting.md index 9574e352b..aac5cb914 100644 --- a/docs/general/administration/troubleshooting.md +++ b/docs/general/administration/troubleshooting.md @@ -178,3 +178,7 @@ UPDATE Permissions SET Value = 1 WHERE (Kind = 0 OR Kind = 3 OR Kind = 4 OR Kind .exit ``` + +## Text Not Rendering Properly + +Text may show up as boxes ☐☐☐☐☐☐ if fonts for the characters are not available. Installing fallback fonts for the affected languages can solve the problem. Please refer to [Fonts](/docs/general/administration/configuration#fonts) on where to install them. diff --git a/docs/general/clients/codec-support.md b/docs/general/clients/codec-support.md index 8b75d5fdd..27c7c69da 100644 --- a/docs/general/clients/codec-support.md +++ b/docs/general/clients/codec-support.md @@ -150,6 +150,10 @@ Content recorded OTA will typically have subtitles [embedded](https://aberdeen.i ffmpeg -f lavfi -i "movie=Ronin (1998).ts[out+subcc]" -map 0:1 "Ronin (1998).srt" ``` +### Fonts + +Text-based subtitle formats require fonts to render properly. Please refer to [Fonts](/docs/general/administration/configuration#fonts) for how to install them. + ## [Container Compatibility](https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Containers) If the container is unsupported, this will result in remuxing. The video and audio codec will remain intact but wrapped in a supported container. This is the least intensive process. Most video containers will be remuxed to use the HLS streaming protocol and TS containers. Remuxing shouldn't be a concern even for an RPi3. From 0223aea7cc98cab239003aa346e565654a8cc55e Mon Sep 17 00:00:00 2001 From: felix920506 Date: Sun, 8 Oct 2023 14:51:20 -0400 Subject: [PATCH 2/2] Clarify library cover image font --- docs/general/administration/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/administration/troubleshooting.md b/docs/general/administration/troubleshooting.md index aac5cb914..9ccf49be8 100644 --- a/docs/general/administration/troubleshooting.md +++ b/docs/general/administration/troubleshooting.md @@ -181,4 +181,4 @@ UPDATE Permissions SET Value = 1 WHERE (Kind = 0 OR Kind = 3 OR Kind = 4 OR Kind ## Text Not Rendering Properly -Text may show up as boxes ☐☐☐☐☐☐ if fonts for the characters are not available. Installing fallback fonts for the affected languages can solve the problem. Please refer to [Fonts](/docs/general/administration/configuration#fonts) on where to install them. +Text may show up as boxes ☐☐☐☐☐☐ if fonts for the characters are not available. Installing fonts for the affected languages can solve the problem. For library cover images, please install system fonts on the server system. For subtitles, the source of fonts depends on the client. Please refer to [Fonts](/docs/general/administration/configuration#fonts) on where to install them.