jellyfin/jellyfin-build
1
0
Fork 0
mirror of https://github.com/jellyfin/jellyfin-build.git synced 2024-11-23 13:59:52 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
43 Commits 3 Branches 0 Tags 352 KiB
Shell 41.7%
Roff 38.3%
Python 20%
8fbecdbc61
Go to file
Joshua M. Boniface 8fbecdbc61 Update paths to new location
2019-05-18 11:49:30 -04:00
scripts Update paths to new location 2019-05-18 11:49:30 -04:00
.gitignore More entries for gitignore 2019-05-18 11:43:57 -04:00
build Add short symlink name 2019-04-08 23:36:10 -04:00
build_client.py Support passing web branches to client builds 2019-04-14 23:21:51 -04:00
build_ffmpeg.py Add remaining build elements 2019-03-06 23:47:55 -05:00
build_plugin.py Add helpful text 2019-04-25 23:24:00 -04:00
build_server.py Add remaining build elements 2019-03-06 23:47:55 -05:00
build.py Move plugin bins too 2019-04-25 23:33:06 -04:00
build.yaml.client.sample Add more projects including sample build yaml files 2019-03-06 00:41:55 -05:00
build.yaml.ffmpeg.sample Add remaining build elements 2019-03-06 23:47:55 -05:00
build.yaml.plugin.sample Nicer comments in sample build.yaml for Plugins 2019-04-19 19:04:44 -04:00
build.yaml.server.sample Add more projects including sample build yaml files 2019-03-06 00:41:55 -05:00
bump_plugin_version Add script to bump plugin versions 2019-04-09 11:57:47 -04:00
manifest.py Some more work to make things consistent 2019-02-03 00:07:39 -05:00
projects_manifest.yaml Reenable plugin 2019-05-13 10:17:42 -04:00
README.md Update README 2019-03-08 22:02:24 -05:00

README.md

Jellyfin Build Infrastructure

This repository contains a unified build infrastructure, written in Python 3, for the Jellyfin project. It can be used to clone down, build, and release (to the server of your choosing) the various packages and components of Jellyfin.

This infrastructure is not 100% complete. Currently it's able to build:

  • The main Jellyfin server by wrapping its BASH build script. This includes the Jellyfin WebUI as an integrated submodule.
  • The Jellyfin Android and AndroidTV apps by wrapping their BASH build scripts.
  • The Jellyfin Debian/Ubuntu FFMPEG by wrapping its BASH build script.
  • Various Jellyfin plugins, described in projects_manifest.yaml, including their plugin repository metadata.

This project is primarily created and maintained by Joshua Boniface to facilitate making official Jellyfin releases as well as test various development efforts. Feedback is welcome but this must always conform to its primary usecase.

Prerequisites

Every project build by this infrastructure requires:

  1. An entry in the projects_manifest.yaml file.
  2. A build.yaml configuration inside the target repository.

All officially supported repositories will have these configurations. To add your own, see the various build.yaml.*.sample files in this repository, copy one into your repository, then submit a pull request.

As a user of this infrastructure, you should note:

  1. The repositories under the projects/ directory are safe to develop in, and in fact is designed to facilitate organizing them for heavy, multi-repository contributors.
  2. If you have existing repositories, you may move them directly to the required location and use them immediately.

Installation

  1. Clone this project onto your system.

  2. Install the required Python yaml dependency via your package manager of choice.

  3. Install Docker, as this is used by many of the automated build setups.

  4. Install the Microsoft .NET Core SDK for your system.

  5. Initialize one or more projects.

  6. Build the projects.

Usage Examples

Obtain a full help:

./build.py -h

List the available projects and their type:

./build.py --list-projects

Clone a copy of all projects into the projects/ directory:

./build.py --clone-only all

Clone only the plugins category:

./build.py --clone-only plugins

Build a single plugin, outputting the resulting binary packages into the bin/ directory:

./build.py jellyfin-plugin-anime

The resulting full plugin manifest is in bin/plugin_manifest.json. Output ZIP packages are in bin/jellyfin-plugin-anime/.

Build the Jellyfin server package for Debian, from the master branch:

./build.py server debian-package-x64

Build the Jellyfin server packages for all supported architectures and systems, from the v10.2.2 tag:

pushd projects/server/jellyfin
git checkout tags/v10.2.2
git submodule update --init
popd
./build.py server all

Note that the build.py script uses the current active branche of the project under the projects/ directory.

Build the Jellyfin Android debug APK:

./build.py jellyfin-android debug