The Free Software Media System
Go to file
Bond_009 a4ffc7a813 Fix random failing of tests
Fully initialize the configuration manager at the init stage

```
Failed Jellyfin.Server.Integration.Tests.Controllers.ActivityLogControllerTests.ActivityLog_GetEntries_Ok [2 s]
  Error Message:
   MediaBrowser.Common.Extensions.ResourceNotFoundException : Configuration with key metadata not found.
  Stack Trace:
     at Emby.Server.Implementations.AppBase.BaseConfigurationManager.<>c__DisplayClass43_0.<GetConfiguration>b__0(String k) in D:\a\1\s\Emby.Server.Implementations\AppBase\BaseConfigurationManager.cs:line 309
   at System.Collections.Concurrent.ConcurrentDictionary`2.GetOrAdd(TKey key, Func`2 valueFactory)
   at Emby.Server.Implementations.AppBase.BaseConfigurationManager.GetConfiguration(String key) in D:\a\1\s\Emby.Server.Implementations\AppBase\BaseConfigurationManager.cs:line 300
   at MediaBrowser.Common.Configuration.ConfigurationManagerExtensions.GetConfiguration[T](IConfigurationManager manager, String key) in D:\a\1\s\MediaBrowser.Common\Configuration\IConfigurationManager.cs:line 88
   at MediaBrowser.Controller.Library.MetadataConfigurationExtensions.GetMetadataConfiguration(IConfigurationManager config) in D:\a\1\s\MediaBrowser.Controller\Library\MetadataConfigurationStore.cs:line 28
   at Emby.Server.Implementations.Library.ResolverHelper.SetDateCreated(BaseItem item, IFileSystem fileSystem, FileSystemMetadata info) in D:\a\1\s\Emby.Server.Implementations\Library\ResolverHelper.cs:line 159
   at Emby.Server.Implementations.Library.ResolverHelper.EnsureDates(IFileSystem fileSystem, BaseItem item, ItemResolveArgs args) in D:\a\1\s\Emby.Server.Implementations\Library\ResolverHelper.cs:line 153
   at Emby.Server.Implementations.Library.ResolverHelper.SetInitialItemValues(BaseItem item, ItemResolveArgs args, IFileSystem fileSystem, ILibraryManager libraryManager) in D:\a\1\s\Emby.Server.Implementations\Library\ResolverHelper.cs:line 81
   at Emby.Server.Implementations.Library.LibraryManager.ResolveItem(ItemResolveArgs args, IItemResolver[] resolvers) in D:\a\1\s\Emby.Server.Implementations\Library\LibraryManager.cs:line 480
   at Emby.Server.Implementations.Library.LibraryManager.ResolvePath(FileSystemMetadata fileInfo, IDirectoryService directoryService, IItemResolver[] resolvers, Folder parent, String collectionType, LibraryOptions libraryOptions) in D:\a\1\s\Emby.Server.Implementations\Library\LibraryManager.cs:line 618
   at Emby.Server.Implementations.Library.LibraryManager.ResolvePath(FileSystemMetadata fileInfo, Folder parent) in D:\a\1\s\Emby.Server.Implementations\Library\LibraryManager.cs:line 536
   at Emby.Server.Implementations.Library.LibraryManager.CreateRootFolder() in D:\a\1\s\Emby.Server.Implementations\Library\LibraryManager.cs:line 732
   at Emby.Server.Implementations.Library.LibraryManager.get_RootFolder() in D:\a\1\s\Emby.Server.Implementations\Library\LibraryManager.cs:line 180
   at Emby.Server.Implementations.IO.LibraryMonitor.Start() in D:\a\1\s\Emby.Server.Implementations\IO\LibraryMonitor.cs:line 135
   at Emby.Server.Implementations.IO.LibraryMonitorStartup.RunAsync() in D:\a\1\s\Emby.Server.Implementations\IO\LibraryMonitorStartup.cs:line 26
   at Emby.Server.Implementations.ApplicationHost.StartEntryPoints(IEnumerable`1 entryPoints, Boolean isBeforeStartup)+MoveNext() in D:\a\1\s\Emby.Server.Implementations\ApplicationHost.cs:line 541
   at System.Threading.Tasks.Task.WhenAll(IEnumerable`1 tasks)
   at Emby.Server.Implementations.ApplicationHost.RunStartupTasksAsync(CancellationToken cancellationToken) in D:\a\1\s\Emby.Server.Implementations\ApplicationHost.cs:line 525
   at Jellyfin.Server.Integration.Tests.JellyfinApplicationFactory.CreateServer(IWebHostBuilder builder) in D:\a\1\s\tests\Jellyfin.Server.Integration.Tests\JellyfinApplicationFactory.cs:line 101
   at Microsoft.AspNetCore.Mvc.Testing.WebApplicationFactory`1.EnsureServer()
   at Microsoft.AspNetCore.Mvc.Testing.WebApplicationFactory`1.CreateDefaultClient(DelegatingHandler[] handlers)
   at Microsoft.AspNetCore.Mvc.Testing.WebApplicationFactory`1.CreateDefaultClient(Uri baseAddress, DelegatingHandler[] handlers)
   at Microsoft.AspNetCore.Mvc.Testing.WebApplicationFactory`1.CreateClient(WebApplicationFactoryClientOptions options)
   at Microsoft.AspNetCore.Mvc.Testing.WebApplicationFactory`1.CreateClient()
   at Jellyfin.Server.Integration.Tests.Controllers.ActivityLogControllerTests.ActivityLog_GetEntries_Ok() in D:\a\1\s\tests\Jellyfin.Server.Integration.Tests\Controllers\ActivityLogControllerTests.cs:line 21
--- End of stack trace from previous location ---

```
2021-04-12 00:28:17 +02:00
.ci Run CollectArtifacts taks regardless of result from BuildPackage and BuildDocker 2021-03-10 21:09:45 +01:00
.copr Port Fedora and CentOS builds and remove web build 2020-03-23 17:32:07 -04:00
.github dotnet 5.0.2 2021-01-16 10:17:33 -07:00
.vscode Upgrade all netcore3.1 to net5.0 2020-11-15 13:31:47 -07:00
DvdLib Merge remote-tracking branch 'upstream/master' into dotnet-5 2020-11-15 11:56:35 -07:00
Emby.Dlna Fix LogUnmatchedProfile formatting 2021-04-10 17:09:45 +02:00
Emby.Drawing Fix build, increase StringBuilder starting size 2021-04-11 08:21:23 +02:00
Emby.Naming revert underscore as a multiversion separator 2021-03-15 23:24:59 +01:00
Emby.Notifications Enable NetAnalyzers for more projects 2021-04-06 20:02:06 +02:00
Emby.Photos Enable NetAnalyzers for more projects 2021-04-06 20:02:06 +02:00
Emby.Server.Implementations Fix random failing of tests 2021-04-12 00:28:17 +02:00
Jellyfin.Api (mostly)Fix ResizeFill 2021-04-11 08:21:23 +02:00
Jellyfin.Data make custompref value nullable 2021-04-07 13:09:00 +02:00
Jellyfin.Drawing.Skia Merge pull request #4988 from Bond-009/crop 2021-04-10 02:57:43 +02:00
Jellyfin.Networking Merge branch 'master' into RemoteAccessFix 2021-03-22 17:05:44 +00:00
Jellyfin.Server Fix random failing of tests 2021-04-12 00:28:17 +02:00
Jellyfin.Server.Implementations make custompref value nullable 2021-04-07 13:09:00 +02:00
MediaBrowser.Common Keep plugin status after update. 2021-04-06 20:59:47 +01:00
MediaBrowser.Controller Fix random failing of tests 2021-04-12 00:28:17 +02:00
MediaBrowser.LocalMetadata FxCop -> Net Analyzers (part 2) 2021-03-13 22:33:28 +01:00
MediaBrowser.MediaEncoding Support MKV DATE_RELEASED tag for PremiereDate 2021-04-04 15:41:01 +02:00
MediaBrowser.Model Apply suggestions from code review 2021-04-11 08:21:23 +02:00
MediaBrowser.Providers Fix possible nullref 2021-04-04 01:45:15 +02:00
MediaBrowser.XbmcMetadata Merge pull request #5467 from Ullmie02/nfo-fixes 2021-03-30 15:35:56 +02:00
RSSDP Do nothing in timer callback when device locator is disposed 2021-03-03 15:13:43 +01:00
apiclient Remove unstable npm ci task 2020-11-08 10:22:38 -07:00
debian Enable Workstation GC mode 2021-04-11 12:57:28 +02:00
deployment Remove Microsoft repo from install step 2021-03-09 12:41:51 -05:00
fedora Enable Workstation GC mode 2021-04-11 12:57:28 +02:00
tests Add tests for UserController 2021-04-09 01:04:49 +02:00
.dockerignore Fixed full pipeline, runs correctly now with `drone exec` 2019-02-12 16:21:46 +01:00
.editorconfig Fix settings in editorconfig file 2020-05-03 16:30:39 -04:00
.gitattributes Improve gitattributes for images 2019-10-08 16:54:41 +03:00
.gitignore Add ci task to publish api client 2020-09-05 23:32:21 -06:00
.npmrc Fix .npmrc 2020-10-19 14:15:05 -06:00
CONTRIBUTORS.md Merge pull request #5258 from Smith00101010/next-up-specials-fix 2021-04-10 01:38:57 +02:00
Dockerfile Use npm ci instead of npm i 2021-04-06 17:37:50 +02:00
Dockerfile.arm Use npm ci instead of npm i 2021-04-06 17:37:50 +02:00
Dockerfile.arm64 Use npm ci instead of npm i 2021-04-06 17:37:50 +02:00
Jellyfin.sln Merge branch 'master' into RemoteAccessFix 2021-03-22 17:05:44 +00:00
LICENSE Remove incorrect .md suffix from LICENSE file 2018-12-09 18:02:44 -05:00
README.md Remove forum badge 2021-03-11 09:34:10 -05:00
SharedVersion.cs Bump version to 10.8.0 for next release 2020-12-04 21:56:24 -05:00
build Add new build.sh script and symlink 2020-03-22 16:02:02 -04:00
build.sh Correct dpkg conditional logic 2020-04-25 22:12:19 -04:00
build.yaml Bump version to 10.8.0 for next release 2020-12-04 21:56:24 -05:00
bump_version Fix bad do in bump_version 2020-12-04 21:53:48 -05:00
jellyfin.code-workspace EditorConfig reformat: Non-CS files. 2019-01-13 20:45:51 +01:00
jellyfin.ruleset FxCop -> Net Analyzers (part 1) 2021-03-09 03:04:47 +01:00
nuget.config Add NuGet config file 2020-04-11 15:34:00 -04:00

README.md

Jellyfin

The Free Software Media System


Logo Banner

GPL 2.0 License Current Release Translation Status Azure Builds Docker Pull Count
Donate Submit Feature Requests Chat on Matrix Join our Subreddit Release RSS Feed Master Commits RSS Feed


Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media. It is an alternative to the proprietary Emby and Plex, to provide media from a dedicated server to end-user devices via multiple apps. Jellyfin is descended from Emby's 3.5.2 release and ported to the .NET Core framework to enable full cross-platform support. There are no strings attached, no premium licenses or features, and no hidden agendas: just a team who want to build something better and work together to achieve it. We welcome anyone who is interested in joining us in our quest!

For further details, please see our documentation page. To receive the latest updates, get help with Jellyfin, and join the community, please visit one of our communication channels. For more information about the project, please see our about page.

Want to get started?
Check out our downloads page or our installation guide, then see our quick start guide. You can also build from source.

Something not working right?
Open an Issue on GitHub.

Want to contribute?
Check out our contributing choose-your-own-adventure to see where you can help, then see our contributing guide and our community standards.

New idea or improvement?
Check out our feature request hub.

Don't see Jellyfin in your language?
Check out our Weblate instance to help translate Jellyfin and its subprojects.

Detailed Translation Status

Jellyfin Server

This repository contains the code for Jellyfin's backend server. Note that this is only one of many projects under the Jellyfin GitHub organization on GitHub. If you want to contribute, you can start by checking out our documentation to see what to work on.

Server Development

These instructions will help you get set up with a local development environment in order to contribute to this repository. Before you start, please be sure to completely read our guidelines on development contributions. Note that this project is supported on all major operating systems except FreeBSD, which is still incompatible.

Prerequisites

Before the project can be built, you must first install the .NET 5.0 SDK on your system.

Instructions to run this project from the command line are included here, but you will also need to install an IDE if you want to debug the server while it is running. Any IDE that supports .NET Core development will work, but two options are recent versions of Visual Studio (at least 2017) and Visual Studio Code.

ffmpeg will also need to be installed.

Cloning the Repository

After dependencies are installed you will need to clone a local copy of this repository. If you just want to run the server from source you can clone this repository directly, but if you are intending to contribute code changes to the project, you should set up your own fork of the repository. The following example shows how you can clone the repository directly over HTTPS.

git clone https://github.com/jellyfin/jellyfin.git

Installing the Web Client

The server is configured to host the static files required for the web client in addition to serving the backend by default. Before you can run the server, you will need to get a copy of the web client since they are not included in this repository directly.

Note that it is also possible to host the web client separately from the web server with some additional configuration, in which case you can skip this step.

There are three options to get the files for the web client.

  1. Download one of the finished builds from the Azure DevOps pipeline. You can download the build for a specific release by looking at the branches tab of the pipelines page.
  2. Build them from source following the instructions on the jellyfin-web repository
  3. Get the pre-built files from an existing installation of the server. For example, with a Windows server installation the client files are located at C:\Program Files\Jellyfin\Server\jellyfin-web

Running The Server

The following instructions will help you get the project up and running via the command line, or your preferred IDE.

Running With Visual Studio

To run the project with Visual Studio you can open the Solution (.sln) file and then press F5 to run the server.

Running With Visual Studio Code

To run the project with Visual Studio Code you will first need to open the repository directory with Visual Studio Code using the Open Folder... option.

Second, you need to install the recommended extensions for the workspace. Note that extension recommendations are classified as either "Workspace Recommendations" or "Other Recommendations", but only the "Workspace Recommendations" are required.

After the required extensions are installed, you can run the server by pressing F5.

Running From The Command Line

To run the server from the command line you can use the dotnet run command. The example below shows how to do this if you have cloned the repository into a directory named jellyfin (the default directory name) and should work on all operating systems.

cd jellyfin                          # Move into the repository directory
dotnet run --project Jellyfin.Server --webdir /absolute/path/to/jellyfin-web/dist # Run the server startup project

A second option is to build the project and then run the resulting executable file directly. When running the executable directly you can easily add command line options. Add the --help flag to list details on all the supported command line options.

  1. Build the project

    dotnet build                # Build the project
    cd bin/Debug/net5.0  # Change into the build output directory
    
  2. Execute the build output. On Linux, Mac, etc. use ./jellyfin and on Windows use jellyfin.exe.

Running The Tests

This repository also includes unit tests that are used to validate functionality as part of a CI pipeline on Azure. There are several ways to run these tests.

  1. Run tests from the command line using dotnet test
  2. Run tests in Visual Studio using the Test Explorer
  3. Run individual tests in Visual Studio Code using the associated CodeLens annotation

Advanced Configuration

The following sections describe some more advanced scenarios for running the server from source that build upon the standard instructions above.

Hosting The Web Client Separately

It is not necessary to host the frontend web client as part of the backend server. Hosting these two components separately may be useful for frontend developers who would prefer to host the client in a separate webpack development server for a tighter development loop. See the jellyfin-web repo for instructions on how to do this.

To instruct the server not to host the web content, there is a nowebclient configuration flag that must be set. This can specified using the command line switch --nowebclient or the environment variable JELLYFIN_NOWEBCONTENT=true.

Since this is a common scenario, there is also a separate launch profile defined for Visual Studio called Jellyfin.Server (nowebcontent) that can be selected from the 'Start Debugging' dropdown in the main toolbar.

NOTE: The setup wizard can not be run if the web client is hosted separately.