Documentation for Jellyfin
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Thibault e8fd536f1c
Added VSC lint on save (#519)
2 years ago
.ci send files to proper location during publish step 3 years ago
.github/workflows spelling fixes and other updates 2 years ago
.vscode Added VSC lint on save (#519) 2 years ago
general Added note about the Docker image using an outdated Mesa build 2 years ago
images upload custom-css-nopicturecast.png 2 years ago
plugin-api style improvements and client status updates 3 years ago
src Update submodule to latest 3 years ago
.editorconfig fix some spelling mistakes (#251) 3 years ago
.gitignore Update gitignore 3 years ago
.gitmodules Put submodule always at the master branch. 4 years ago
.markdownlint.yml Do not allow bare URLs 3 years ago
LICENSE Add the CC-BY-SA-4.0 license 3 years ago Fix remaining issues 3 years ago
docfx.json initial work to remove release step as a requirement 3 years ago Merge monitoring endpoints and document the Prometheus endpoint (#516) 2 years ago
toc.yml Add API Documentation in main header 2 years ago

Jellyfin Documentation

Part of the Jellyfin Project

This repository houses all documentation for Jellyfin available at and written in markdown.

Getting Started

The site is built with DocFX using DocFX Flavored Markdown. See the content section here for a quick tutorial on DocFX.

Since the site is mostly written with simple Markdown files, the easiest and fastest way to contribute is to just edit the source files directory on GitHub. For example, you could edit this README page by going to its edit page on GitHub.

Editing directly on GitHub provides a feature to preview your changes for the current document, but if you want to see your changes within the context of the actual website or make more advanced changes to the site, you will need to run a copy of the site locally.

To run the site locally, you will first need to clone this repository using git.

git clone

Next, you will need to install DocFx as a command line tool. Once installed, you can run the following command from the root directory of your cloned repository.

docfx --serve

This will build the site and start up a development server to test out your changes available at http://localhost:8080.


This repository is configured to use markdownlint for linting Markdown files.

If you are editing files within Visual Studio Code, you can install the markdownlint extension to see the linting errors as you work.

You can also easily run the linter manually using the associated markdownlint CLI.

npm install -g markdownlint-cli
markdownlint **/*.md --ignore node_modules --ignore src


The following sections explain the documentation content available for each area of the site.

Plugin API

Describe all available API surfaces and class from plugin development.


apispec is used to overwrite specific plugin API page contexts.


docs is the main custom documentation directory. All uids for the custom documentation are relative to this directory, with administration and contributing shortened to admin and contrib respectively. So for example to reference the file general/administration/ one would use xref:admin-installing with an optional anchor like xref:admin-installing#arch.


Should be used for documentation related to server setup including non-default configs for more advanced users.


Should be used for documentation related to development, translations, releases, and other ways to contribute to the project.


Any documentation related to the clients.


Any documentation related to managing the server or explaining certain features.


Naming conventions for all supported media types, such as movies or podcasts.


Any plugin documentation.