Better absolute handling animelist

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

.dockerignore

@@ -1,8 +0,0 @@
-.git
-**/build
-**/dist
-src/Kyoo.WebApp/Front/nodes_modules
-**/bin
-**/obj
-docs
-tests

.editorconfig

@@ -9,85 +9,6 @@ indent_style = tab
 indent_size = tab
 smart_tab = true
 
-[{*.yaml,*.yml}]
+[{*.yaml,*.yml,*.nix}]
 indent_style = space
 indent_size = 2
-
-[*.cs]
-# Sort using and Import directives with System.* appearing first
-dotnet_sort_system_directives_first = true
-csharp_using_directive_placement = outside_namespace:warning
-# Avoid "this." if not necessary
-dotnet_style_qualification_for_field = false:suggestion
-dotnet_style_qualification_for_property = false:suggestion
-dotnet_style_qualification_for_method = false:suggestion
-dotnet_style_qualification_for_event = false:suggestion
-# Use language keywords instead of framework type names for type references
-dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
-dotnet_style_predefined_type_for_member_access = true:suggestion
-# Suggest more modern language features when available
-dotnet_style_object_initializer = true:suggestion
-dotnet_style_collection_initializer = true:suggestion
-dotnet_style_coalesce_expression = true:suggestion
-dotnet_style_null_propagation = true:suggestion
-dotnet_style_explicit_tuple_names = true:suggestion
-csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
-csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
-csharp_style_inlined_variable_declaration = true:suggestion
-csharp_style_conditional_delegate_call = true:suggestion
-dotnet_style_prefer_auto_properties = true
-dotnet_style_prefer_conditional_expression_over_assignment = true
-dotnet_style_prefer_conditional_expression_over_return = true
-# Disable strange throw.
-csharp_style_throw_expression = false:suggestion
-# Forbid "var" everywhere
-csharp_style_var_for_built_in_types = false:warning
-csharp_style_var_when_type_is_apparent = false:warning
-csharp_style_var_elsewhere = false:warning
-# Prefer method-like constructs to have a block body
-csharp_style_expression_bodied_methods = false:none
-csharp_style_expression_bodied_constructors = false:none
-csharp_style_expression_bodied_operators = false:none
-# Prefer property-like constructs to have an expression-body
-csharp_style_expression_bodied_properties = true:none
-csharp_style_expression_bodied_indexers = true:none
-csharp_style_expression_bodied_accessors = true:none
-# Newline settings
-csharp_new_line_before_open_brace = all
-csharp_new_line_before_else = true
-csharp_new_line_before_catch = true
-csharp_new_line_before_finally = true
-csharp_new_line_before_members_in_object_initializers = false
-csharp_new_line_before_members_in_anonymous_types = true
-# Indentation settings
-csharp_indent_case_contents = true
-csharp_indent_switch_labels = true
-# Modifiers
-dotnet_style_readonly_field = true:suggestion
-csharp_preferred_modifier_order = public, private, protected, internal, new, abstract, virtual, sealed, override, static, readonly, extern, unsafe, volatile, async:suggestion
-dotnet_style_require_accessibility_modifiers = for_non_interface_members:suggestion
-# Naming style
-dotnet_naming_symbols.privates.applicable_kinds = property,method,event,delegate
-dotnet_naming_symbols.privates.applicable_accessibilities = private
-dotnet_naming_style.underscore_pascal.capitalization = pascal_case
-dotnet_naming_style.underscore_pascal.required_prefix = _
-dotnet_naming_rule.privates_with_underscore.symbols = privates
-dotnet_naming_rule.privates_with_underscore.style = underscore_pascal
-dotnet_naming_rule.privates_with_underscore.severity = warning
-dotnet_diagnostic.IDE1006.severity = warning
-# ReSharper properties
-resharper_align_multiline_binary_expressions_chain = false
-resharper_csharp_empty_block_style = together_same_line
-resharper_indent_nested_foreach_stmt = true
-resharper_indent_nested_for_stmt = true
-resharper_indent_nested_while_stmt = true
-resharper_keep_existing_embedded_arrangement = false
-resharper_place_accessorholder_attribute_on_same_line = true
-resharper_place_simple_embedded_statement_on_same_line = false
-resharper_wrap_before_arrow_with_expressions = true
-resharper_xmldoc_attribute_indent = align_by_first_attribute
-resharper_xmldoc_indent_child_elements = RemoveIndent
-resharper_xmldoc_indent_text = RemoveIndent
-
-# Waiting for https://github.com/dotnet/roslyn/issues/44596 to get fixed.
-# file_header_template = Kyoo - A portable and vast media library solution.\nCopyright (c) Kyoo.\n\nSee AUTHORS.md and LICENSE file in the project root for full license information.\n\nKyoo is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\nany later version.\n\nKyoo is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with Kyoo. If not, see <https://www.gnu.org/licenses/>.

.env.example

@@ -0,0 +1,90 @@
+# vi: ft=sh
+# shellcheck disable=SC2034
+
+
+# Useful config options
+
+# Library root can either be an absolute path or a relative path to your docker-compose.yml file.
+LIBRARY_ROOT=./video
+# You should set this to a path where kyoo can write large amount of data, this is used as a cache by the transcoder.
+# It will automatically be cleaned up on kyoo's startup/shutdown/runtime.
+CACHE_ROOT=/tmp/kyoo_cache
+LIBRARY_LANGUAGES=en
+# A pattern (regex) to ignore video files.
+LIBRARY_IGNORE_PATTERN=".*/[dD]ownloads?/.*"
+
+# If this is true, new accounts wont have any permissions before you approve them in your admin dashboard.
+REQUIRE_ACCOUNT_VERIFICATION=true
+# Specify permissions of guest accounts, default is no permissions.
+UNLOGGED_PERMISSIONS=
+# but you can allow anyone to use your instance without account by doing:
+# UNLOGGED_PERMISSIONS=overall.read,overall.play
+# You can specify this to allow guests users to see your collection without behing able to play videos for example:
+# UNLOGGED_PERMISSIONS=overall.read
+
+# Specify permissions of new accounts.
+DEFAULT_PERMISSIONS=overall.read,overall.play
+
+# Hardware transcoding (equivalent of --profile docker compose option).
+COMPOSE_PROFILES=cpu # cpu (no hardware acceleration) or vaapi or qsv or nvidia
+# the preset used during transcode. faster means worst quality, you can probably use a slower preset with hwaccels
+# warning: using vaapi hwaccel disable presets (they are not supported).
+GOCODER_PRESET=fast
+
+
+# The following value should be set to a random sequence of characters.
+# You MUST change it when installing kyoo (for security)
+# You can input multiple api keys separated by a ,
+KYOO_APIKEYS=t7H5!@4iMNsAaSJQ49pat4jprJgTcF656if#J3
+
+# Keep those empty to use kyoo's default api key. You can also specify a custom API key if you want.
+# go to https://www.themoviedb.org/settings/api and copy the api key (not the read access token, the api key)
+THEMOVIEDB_APIKEY=
+# go to https://thetvdb.com/api-information/signup and copy the api key
+TVDB_APIKEY=
+# you can also input your subscriber's pin to support TVDB
+TVDB_PIN=
+
+
+# The url you can use to reach your kyoo instance. This is used during oidc to redirect users to your instance.
+PUBLIC_URL=http://localhost:5000
+
+# Use a builtin oidc service (google, discord, trakt, or simkl):
+# When you create a client_id, secret combo you may be asked for a redirect url. You need to specify https://YOUR-PUBLIC-URL/api/auth/logged/YOUR-SERVICE-NAME
+OIDC_DISCORD_CLIENTID=
+OIDC_DISCORD_SECRET=
+# Or add your custom one:
+OIDC_SERVICE_NAME=YourPrettyName
+OIDC_SERVICE_LOGO=https://url-of-your-logo.com
+OIDC_SERVICE_CLIENTID=
+OIDC_SERVICE_SECRET=
+OIDC_SERVICE_AUTHORIZATION=https://url-of-the-authorization-endpoint-of-the-oidc-service.com/auth
+OIDC_SERVICE_TOKEN=https://url-of-the-token-endpoint-of-the-oidc-service.com/token
+OIDC_SERVICE_PROFILE=https://url-of-the-profile-endpoint-of-the-oidc-service.com/userinfo
+OIDC_SERVICE_SCOPE="the list of scopes space separeted like email identity"
+# Token authentication method as seen in https://openid.net/specs/openid-connect-core-1_0.html#ClientAuthentication
+# Supported values: ClientSecretBasic (default) or ClientSecretPost
+# If in doupt, leave this empty.
+OIDC_SERVICE_AUTHMETHOD=ClientSecretBasic
+# on the previous list, service is the internal name of your service, you can add as many as you want.
+
+
+# Following options are optional and only useful for debugging.
+
+# To debug the front end, you can set the following to an external backend
+KYOO_URL=
+
+# Database things
+POSTGRES_USER=KyooUser
+POSTGRES_PASSWORD=KyooPassword
+POSTGRES_DB=kyooDB
+POSTGRES_SERVER=postgres
+POSTGRES_PORT=5432
+
+MEILI_HOST="http://meilisearch:7700"
+MEILI_MASTER_KEY="ghvjkgisbgkbgskegblfqbgjkebbhgwkjfb"
+
+RABBITMQ_HOST=rabbitmq
+RABBITMQ_PORT=5672
+RABBITMQ_DEFAULT_USER=kyoo
+RABBITMQ_DEFAULT_PASS=aohohunuhouhuhhoahothonseuhaoensuthoaentsuhha

.git-blame-ignore-revs

@@ -0,0 +1,3 @@
+7e6e56a366babe17e7891a5897180efbf93c00c5
+a5638203a6ecb9f372a5a61e1c8fd443bf3a17fe
+18e301f26acd7f2e97eac26c5f48377fa13956f5

.gitattributes

@@ -1,63 +1 @@
-###############################################################################
-# Set default behavior to automatically normalize line endings.
-###############################################################################
-* text=auto
-
-###############################################################################
-# Set default behavior for command prompt diff.
-#
-# This is need for earlier builds of msysgit that does not have it on by
-# default for csharp files.
-# Note: This is only used by command line
-###############################################################################
-#*.cs     diff=csharp
-
-###############################################################################
-# Set the merge driver for project and solution files
-#
-# Merging from the command prompt will add diff markers to the files if there
-# are conflicts (Merging from VS is not affected by the settings below, in VS
-# the diff markers are never inserted). Diff markers may cause the following 
-# file extensions to fail to load in VS. An alternative would be to treat
-# these files as binary and thus will always conflict and require user
-# intervention with every merge. To do so, just uncomment the entries below
-###############################################################################
-#*.sln       merge=binary
-#*.csproj    merge=binary
-#*.vbproj    merge=binary
-#*.vcxproj   merge=binary
-#*.vcproj    merge=binary
-#*.dbproj    merge=binary
-#*.fsproj    merge=binary
-#*.lsproj    merge=binary
-#*.wixproj   merge=binary
-#*.modelproj merge=binary
-#*.sqlproj   merge=binary
-#*.wwaproj   merge=binary
-
-###############################################################################
-# behavior for image files
-#
-# image files are treated as binary by default.
-###############################################################################
-#*.jpg   binary
-#*.png   binary
-#*.gif   binary
-
-###############################################################################
-# diff behavior for common document formats
-# 
-# Convert binary document formats to text before diffing them. This feature
-# is only available from the command line. Turn it on by uncommenting the 
-# entries below.
-###############################################################################
-#*.doc   diff=astextplain
-#*.DOC   diff=astextplain
-#*.docx  diff=astextplain
-#*.DOCX  diff=astextplain
-#*.dot   diff=astextplain
-#*.DOT   diff=astextplain
-#*.pdf   diff=astextplain
-#*.PDF   diff=astextplain
-#*.rtf   diff=astextplain
-#*.RTF   diff=astextplain
+*.Designer.cs linguist-generated=true

.github/ISSUE_TEMPLATE/bug-report.md

@@ -1,20 +0,0 @@
----
-name: Bug Report
-about: Create a bug report to help improve Kyoo
-title: "[BUG] "
-labels: bug
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-1. 
-
-**Expected Behavior**
-A clear and concise description of what you expected to happen.
-
-**Environment:**
- - Platform [e.g. Windows / Linux]
- - Action Version [e.g. v0.0.1 or a git commit's SHA]

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,11 @@
+name: Bug Report
+description: Create a bug report to help improve Kyoo
+labels: [bug]
+body:
+  - type: input
+    attributes:
+      label: "Kyoo's version"
+  - type: textarea
+    attributes:
+      label: What happened?
+      description: Also tell us, what did you expect to happen?

.github/ISSUE_TEMPLATE/feature-request.md

@@ -1,18 +0,0 @@
----
-name: Feature Request
-about: Suggest a new feature for Kyoo (don't forget to check projects first)
-title: "[FEATURE] "
-labels: enhancement
----
-
-**Is your feature request related to a problem? If yes, please describe.**
-A clear and concise description of what the problem is.
-
-**Describe the feature you'd like**
-A clear and concise description of what you want Kyoo to have.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,7 @@
+name: Feature Request
+description: Suggest a new feature for Kyoo (don't forget to check projects first)
+labels: [enhancement]
+body:
+  - type: textarea
+    attributes:
+      label: Feature description

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,20 +0,0 @@
-## Proposed changes
-
-Describe the big picture of your changes here to communicate to the maintainers why we should accept this pull request.
-If it fixes a bug or resolves a feature request, be sure to link to that issue.
-
-## Information
- - [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- - [ ] New public API added
- - [ ] Non-breaking changes
-
-## Checklist
-
- - [ ] I have added tests that prove my fix is effective or that my feature works
- - [ ] I have added necessary documentation (if appropriate)
-
-## Further comments
-
-If this is a relatively large or complex change, kick off the discussion by explaining why you chose the solution you did 
-and what alternatives you considered, etc...
-

.github/workflows/analysis.yml

@@ -1,65 +0,0 @@
-name: Analysis
-on: [push, pull_request, workflow_dispatch]
-
-jobs:
-  analysis:
-    name: Static Analysis
-    runs-on: ubuntu-latest
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name != github.repository
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          fetch-depth: 0  # Shallow clones should be disabled for a better relevancy of analysis
-      - name: Cache SonarCloud packages
-        uses: actions/cache@v1
-        with:
-          path: ~/sonar/cache
-          key: ${{ runner.os }}-sonar
-          restore-keys: ${{ runner.os }}-sonar
-      - name: Cache SonarCloud scanner
-        id: cache-sonar-scanner
-        uses: actions/cache@v1
-        with:
-          path: ./.sonar/scanner
-          key: ${{ runner.os }}-sonar-scanner
-          restore-keys: ${{ runner.os }}-sonar-scanner
-      - name: Install SonarCloud scanner
-        if: steps.cache-sonar-scanner.outputs.cache-hit != 'true'
-        shell: bash
-        run: |
-          mkdir -p ./.sonar/scanner
-          dotnet tool update dotnet-sonarscanner --tool-path ./.sonar/scanner
-      - name: Wait for tests to run
-        uses: lewagon/wait-on-check-action@master
-        with:
-          ref: ${{github.ref}}
-          check-name: tests
-          repo-token: ${{secrets.GITHUB_TOKEN}}
-          running-workflow-name: analysis
-          allowed-conclusions: success,skipped,cancelled,neutral,failure
-      - name: Download coverage report
-        uses: dawidd6/action-download-artifact@v2
-        with:
-          commit: ${{env.COMMIT_SHA}}
-          workflow: tests.yml
-          github_token: ${{secrets.GITHUB_TOKEN}}
-      - name: Build and analyze
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}  # Needed to get PR information, if any
-          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
-        shell: bash
-        run: |
-          find . -name 'coverage.opencover.xml'
-          dotnet build-server shutdown
-
-          ./.sonar/scanner/dotnet-sonarscanner begin \
-            -k:"AnonymusRaccoon_Kyoo" \
-            -o:"anonymus-raccoon" \
-            -d:sonar.login="${{ secrets.SONAR_TOKEN }}" \
-            -d:sonar.host.url="https://sonarcloud.io" \
-            -d:sonar.cs.opencover.reportsPaths="**/coverage.opencover.xml" \
-            -d:sonar.cs.vstest.reportsPaths="**/TestOutputResults.xml"
-
-          dotnet build --no-incremental '-p:SkipTranscoder=true;SkipWebApp=true'
-
-          ./.sonar/scanner/dotnet-sonarscanner end -d:sonar.login="${{ secrets.SONAR_TOKEN }}"

.github/workflows/build.yml

@@ -1,170 +0,0 @@
-name: Build
-on: [push, pull_request, workflow_dispatch]
-
-jobs:
-  build:
-    name: "${{matrix.artifact}}'s Build"
-    runs-on: ${{matrix.os}}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name != github.repository
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - os: ubuntu-latest
-            runtime: linux-x64
-            artifact: linux
-          - os: windows-latest
-            runtime: win-x64
-            artifact: windows
-          - os: macOS-latest
-            runtime: osx-x64
-            artifact: macos
-    steps:
-      - uses: actions/checkout@v1
-        with:
-          submodules: recursive
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v1
-        with:
-          dotnet-version: 5.0.x
-      - name: Install ffmpeg
-        shell: bash
-        run: |
-          if [[ "${{runner.os}}" == "Windows" ]]; then
-            choco install ffmpeg-shared
-          elif [[ "${{runner.os}}" == "macOS" ]]; then
-            brew install ffmpeg
-          else
-            sudo apt-get update
-            sudo apt-get install -y libavutil-dev libavcodec-dev libavformat-dev
-          fi
-      - name: Enabling windows compilations tools
-        if: matrix.artifact == 'windows'
-        uses: ilammy/msvc-dev-cmd@v1
-      - name: Select the project to build
-        shell: bash
-        run: |
-          echo "PROJECT=$([ "${{runner.os}}" == "Windows" ] \
-            && echo " -p:IncludeConsole=true -p:CheckCodingStyle=false src/Kyoo.Host.WindowsTrait" \
-            || echo " -p:CheckCodingStyle=false  src/Kyoo.Host.Console")" >> $GITHUB_ENV
-      - name: Build the app
-        env:
-          INCLUDE: ${{env.INCLUDE}};C:\Program Files\FFmpeg\include
-          LIB: ${{env.LIB}};C:\Program Files\FFmpeg\lib
-          LIBPATH: ${{env.LIBPATH}};C:\Program Files\FFmpeg\lib
-          CFLAGS: -I/usr/local/include
-          LDFLAGS: -L/usr/local/lib
-        run: dotnet publish -r ${{matrix.runtime}} -c Release -o dist ${{env.PROJECT}}
-      - name: Compression output
-        shell: bash
-        run: |
-          assets=kyoo_${{matrix.artifact}}
-          if [[ "${{runner.os}}" == "Windows" ]]; then
-            cd dist
-            cp -r "/C/Program Files/FFmpeg/bin/." .
-            7z a "../$assets.zip"
-          else
-            rootgrp=$([ "${{runner.os}}" == "macOS" ] && echo wheel || echo root)
-            sudo chown -R root:$rootgrp dist
-            tar -C dist -czf "$assets.tar.gz" .
-          fi
-      - uses: actions/upload-artifact@v2
-        with:
-          name: kyoo_${{matrix.artifact}}
-          path: |
-            *.zip
-            *.tar.gz
-
-  windows_release:
-    name: Create windows release
-    runs-on: windows-latest
-    needs: build
-    if: ${{ github.ref == 'refs/heads/master' || contains(github.ref, 'tags') }}
-    steps:
-      - uses: actions/checkout@v1
-      - name: Download windows build
-        uses: actions/download-artifact@v2
-        with:
-          name: kyoo_windows
-          path: artifact
-      - name: Unzip windows files
-        run: mkdir dist_win && 7z x artifact/kyoo_windows.zip -odist_win
-      - name: Install Inno Setup
-        shell: cmd
-        run: |
-          curl -L https://jrsoftware.org/download.php/is.exe > innosetup.exe
-          innosetup.exe /VERYSILENT /SUPPRESSMSGBOXES /Log=log.txt || (cat log.txt && exit 1)
-      - name: Create windows installer
-        shell: bash
-        run: iscc -Dkyoo=$(realpath dist_win) -O./ -Fkyoo-windows deployment/kyoo-windows.iss
-      - uses: actions/upload-artifact@v2
-        with:
-          name: kyoo_windows_installer
-          path: ./kyoo-windows.exe
-
-  release:
-    name: Create debian, rpm & arch releases
-    runs-on: ubuntu-latest
-    needs: build
-    if: ${{ github.ref == 'refs/heads/master' || contains(github.ref, 'tags') }}
-    env:
-      description: "A media browser"
-      version: v0.0.1 #${{ github.ref }}
-    steps:
-      - uses: actions/checkout@v1
-      - name: Download linux build
-        uses: actions/download-artifact@v2
-        with:
-          name: kyoo_linux
-          path: artifact
-      - name: Unzip the published files.
-        run: mkdir dist && tar -C dist -xzf artifact/kyoo_linux.tar.gz
-      - name: Create the package structure
-        run: |
-          sudo mkdir -p pkg/usr/lib/
-          sudo cp -r --no-preserve ownership dist pkg/usr/lib/kyoo
-          sudo install -Dm 644 deployment/kyoo.service -t pkg/usr/lib/systemd/system/
-          sudo install -Dm 644 deployment/kyoo.sysusers pkg/usr/lib/sysusers.d/kyoo.conf
-          sudo install -Dm 644 deployment/kyoo.tmpfiles pkg/usr/lib/tmpfiles.d/kyoo.conf
-      - name: Build debian package
-        uses: jiro4989/build-deb-action@v2
-        with:
-          package: kyoo
-          package_root: pkg
-          maintainer: Zoe Roux <zoe.roux@sdg.moe>
-          version: ${{env.version}}
-          depends: "libavutil-dev, libavcodec-dev, libavformat-dev"
-          arch: amd64
-          desc: ${{env.description}}
-      - name: Build rpm package
-        run: |
-          mkdir out
-          sudo rm -rf pkg/DEBIAN
-          rpmbuild -bb --buildroot $(pwd)/out --build-in-place --define "_rpmdir $(pwd)/rpm" deployment/kyoo.spec
-      - name: Prepare arch package
-        run: |
-          mkdir deployment/output
-          mv deployment/PKGBUILD.github deployment/PKGBUILD
-          cp -a pkg/usr deployment/output/usr
-      - uses: edlanglois/pkgbuild-action@v1
-        id: makepkg
-        with:
-          pkgdir: deployment
-          namcapDisable: true
-      - uses: actions/upload-artifact@v2
-        with:
-          name: kyoo_rpm
-          path: ./rpm/x86_64/*.rpm
-      - uses: actions/upload-artifact@v2
-        with:
-          name: kyoo_debian
-          path: ./*.deb
-      - uses: actions/upload-artifact@v2
-        with:
-          name: kyoo_arch
-          path: ${{steps.makepkg.outputs.pkgfile0}}
-
-#  new-version:
-#    if: startsWith(github.ref, 'refs/tags/v')
-#    runs-on: ubuntu-latest
-

.github/workflows/coding-style.yml

@@ -1,15 +1,56 @@
-name: CodingStyle
+name: Coding Style
 on: [pull_request, workflow_dispatch]
 
 jobs:
-  build:
-    name: "Coding style check"
+  back:
+    name: "Lint Back"
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./back
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check coding style
+        run: |
+          dotnet tool restore
+          dotnet csharpier . --check
+
+  front:
+    name: "Lint Front"
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./front
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Biome
+        uses: biomejs/setup-biome@v2
+        with:
+          version: latest
+
+      - name: Run Biome
+        run: biome ci .
+
+  scanner:
+    name: "Lint scanner/autosync"
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v1
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v1
+      - uses: actions/checkout@v4
+
+      - uses: chartboost/ruff-action@v1
         with:
-          dotnet-version: 5.0.x
-      - name: Build the app
-        run: dotnet build -p:CheckCodingStyle=true -p:TreatWarningsAsErrors=true '-p:SkipTranscoder=true;SkipWebApp=true'
+          args: format --check
+
+  transcoder:
+    name: "Lint transcoder"
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./transcoder
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Run go fmt
+        run: if [ "$(gofmt -s -l . | wc -l)" -gt 0 ]; then exit 1; fi

.github/workflows/docker.yml

@@ -1,36 +1,123 @@
 name: Docker
-on: [push, pull_request, workflow_dispatch]
+on:
+  push:
+    branches:
+      - master
+      - next
+    tags:
+      - v*
+  pull_request:
+  workflow_dispatch:
 
 jobs:
   build:
     runs-on: ubuntu-latest
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name != github.repository
+    permissions:
+      contents: read
+      packages: write
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - context: ./back
+            dockerfile: Dockerfile
+            label: back
+            image: zoriya/kyoo_back
+
+          - context: ./back
+            dockerfile: Dockerfile.migrations
+            label: migrations
+            image: zoriya/kyoo_migrations
+
+          - context: ./front
+            dockerfile: Dockerfile
+            label: front
+            image: zoriya/kyoo_front
+
+          - context: ./scanner
+            dockerfile: Dockerfile
+            label: scanner
+            image: zoriya/kyoo_scanner
+
+          - context: ./autosync
+            dockerfile: Dockerfile
+            label: autosync
+            image: zoriya/kyoo_autosync
+
+          - context: ./transcoder
+            dockerfile: Dockerfile
+            label: transcoder
+            image: zoriya/kyoo_transcoder
+    name: Build ${{matrix.label}}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
+
+      - uses: dorny/paths-filter@v3
+        id: filter
         with:
-          submodules: recursive
+          filters: |
+            should_run:
+              - '${{matrix.context}}/**'
+
       - name: Docker meta
         id: meta
-        uses: crazy-max/ghaction-docker-meta@v2
+        uses: docker/metadata-action@v5
         with:
-          images: ghcr.io/${{github.repository_owner}}/Kyoo
+          images: |
+            docker.io/${{matrix.image}}
+            ghcr.io/${{matrix.image}}
           tags: |
-            type=ref,event=tag
+            type=edge
             type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+
+      - name: Check if a package should be pushed
+        run: |
+          echo "SHOULD_PUSH=$([ "${GITHUB_REF##*/}" == "master" ] || [ "${GITHUB_REF##*/}" == "next" ] || [ "${GITHUB_REF_TYPE}" == "tag" ] && echo "true" || echo "false")" >> $GITHUB_ENV
+
       - name: Set up QEMU
-        uses: docker/setup-qemu-action@v1
+        uses: docker/setup-qemu-action@v3
+
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v1
+        uses: docker/setup-buildx-action@v3
+
       - name: Login to DockerHub
-        uses: docker/login-action@v1 
+        if: env.SHOULD_PUSH == 'true'
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+
+      - name: Login to GitHub Container Registry
+        if: env.SHOULD_PUSH == 'true'
+        uses: docker/login-action@v3
         with:
           registry: ghcr.io
-          username: ${{github.repository_owner}}
-          password: ${{secrets.GITHUB_TOKEN}}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Build and push
         id: docker_build
-        uses: docker/build-push-action@v2
+        uses: docker/build-push-action@v5
+        if: steps.filter.outputs.should_run == 'true' || github.event_name == 'workflow_dispatch' || startsWith(github.event.ref, 'refs/tags/v')
         with:
-          context: .
-          push: true
+          context: ${{matrix.context}}
+          file: ${{matrix.context}}/${{matrix.dockerfile}}
+          platforms: linux/amd64,linux/arm64
+          build-args: |
+            VERSION=0.0.0
+          push: ${{env.SHOULD_PUSH}}
           tags: ${{steps.meta.outputs.tags}}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Sync README.MD
+        if: env.SHOULD_PUSH == 'true'
+        uses: ms-jpq/sync-dockerhub-readme@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: ${{ matrix.image }}
+          readme: "./README.md"

.github/workflows/documentation.yml

@@ -1,32 +0,0 @@
-name: Update the documentation
-
-on:
-  push:
-    branches:
-      - master
-
-jobs:
-  Building:
-    runs-on: [ubuntu-latest]
-    steps:
-      - uses: actions/checkout@v1
-      - uses: nikeee/docfx-action@v1.0.0
-        name: Build Documentation
-        with:
-          args: docs/docfx.json
-      - name: Update the docs
-        run: |
-          cd docs/_site
-          sudo chown $(whoami):$(whoami) . -R
-          echo -n docs.kyoo.moe > CNAME
-          git config --global user.email "${GITHUB_ACTOR}@github.com"
-          git config --global user.name "${GITHUB_ACTOR}"
-          git init
-          git add -A
-          git commit -m "Deploying the documentation"
-          git remote add origin https://${GITHUB_ACTOR}:${GITHUB_TOKEN}@${GITHUB_REPO}
-          git checkout -b gh-pages
-          git push --force origin gh-pages
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GITHUB_REPO: "github.com/AnonymusRaccoon/Kyoo"

.github/workflows/native-build.yml

@@ -0,0 +1,64 @@
+name: Native build
+on:
+  push:
+    tags:
+     - v*
+
+jobs:
+  update:
+    name: Expo Build
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./front
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Check for EXPO_TOKEN
+        run: |
+          if [ -z "${{ secrets.EXPO_TOKEN }}" ]; then
+            echo "You must provide an EXPO_TOKEN secret linked to this project's Expo account in this repo's secrets. Learn more: https://docs.expo.dev/eas-update/github-actions"
+            exit 1
+          fi
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18.x
+          cache: yarn
+          cache-dependency-path: front/yarn.lock
+
+      - name: Setup Expo
+        uses: expo/expo-github-action@v8
+        with:
+          expo-version: latest
+          eas-version: latest
+          token: ${{ secrets.EXPO_TOKEN }}
+
+      - name: Install dependencies
+        run: yarn install --immutable
+
+      - name: Build Mobile Release
+        run: yarn build:mobile:apk | tee log.txt
+
+      - name: Parse Asset URL
+        id: url
+        run: |
+          ASSET_URL=$(cat log.txt | jq '.[0].artifacts.buildUrl' -r)
+          echo The android url is $ASSET_URL
+          echo "assetUrl=$ASSET_URL" >> $GITHUB_OUTPUT
+
+      - name: Download APK Asset
+        run: wget -O kyoo.apk ${{ steps.url.outputs.assetUrl }}
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: kyoo.apk
+          path: ./front/kyoo.apk
+
+      - name: Upload release artifacts
+        uses: softprops/action-gh-release@v2
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          files: ./front/kyoo.apk

.github/workflows/native-update.yml

@@ -0,0 +1,43 @@
+name: Native update
+on:
+  push:
+    tags:
+      - v*
+
+jobs:
+  update:
+    name: Expo Update
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./front
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Check for EXPO_TOKEN
+        run: |
+          if [ -z "${{ secrets.EXPO_TOKEN }}" ]; then
+            echo "You must provide an EXPO_TOKEN secret linked to this project's Expo account in this repo's secrets. Learn more: https://docs.expo.dev/eas-update/github-actions"
+            exit 1
+          fi
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18.x
+          cache: yarn
+          cache-dependency-path: front/yarn.lock
+
+      - name: Setup Expo
+        uses: expo/expo-github-action@v8
+        with:
+          expo-version: latest
+          eas-version: latest
+          token: ${{ secrets.EXPO_TOKEN }}
+
+      - name: Install dependencies
+        run: yarn install --immutable
+
+      - name: Publish update
+        run: yarn update

.github/workflows/release.yml

@@ -1,44 +1,30 @@
 name: Release
-
 on:
   push:
     tags:
-      - v*
-  workflow_dispatch:
+     - v*
 
 jobs:
-  release:
+  update:
+    name: Release
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - name: Set commit environment
-        run: echo "COMMIT_SHA=$(git rev-list -n 1 ${{github.ref}})" >> $GITHUB_ENV
-      - name: Wait for builds & tests to finish
-        uses: lewagon/wait-on-check-action@master
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set correct versions
+        run: |
+          VERSION=${{ github.ref_name }}
+          VERSION=${VERSION:1} # Remove v prefix
+          VERSION=${VERSION%.*} # Remove minor version
+          sed "s/edge/$VERSION/" -i docker-compose.yml
+
+      - uses: actions/upload-artifact@v4
         with:
-          ref: ${{github.ref}}
-          repo-token: ${{secrets.GITHUB_TOKEN}}
-          running-workflow-name: release
-          allowed-conclusions: success,skipped,cancelled,neutral
-      - name: Download artifacts
-        uses: dawidd6/action-download-artifact@v2
+          name: docker-compose.yml
+          path: ./docker-compose.yml
+
+      - name: Upload release artifacts
+        uses: softprops/action-gh-release@v2
         with:
-          commit: ${{env.COMMIT_SHA}}
-          workflow: build.yml
-          path: ./artifacts
-          github_token: ${{secrets.GITHUB_TOKEN}}
-      # - name: Public the abstractions to nuget
-      #   id: publish_nuget
-      #   uses: rohith/publish-nuget@v2
-      #   with:
-      #     PROJECT_FILE_PATH: Kyoo.Abstractions/Kyoo.Abstractions.csproj
-      #     PACKAGE_NAME: Kyoo.Abstractions
-      #     VERSION_REGEX: ^\s*<PackageVersion>(.*)<\/PackageVersion>\s*$
-      #     NUGET_KEY: ${{secrets.NUGET_API_KEY}}
-      #     INCLUDE_SYMBOLS: true
-      - name: Create Release
-        uses: ncipollo/release-action@v1
-        with:
-          generateReleaseNotes: true
-          artifacts: ./artifacts/**/*
-          token: ${{secrets.GITHUB_TOKEN}}
+          files: ./docker-compose.yml

.github/workflows/robot.yml

@@ -0,0 +1,50 @@
+name: RobotTests
+on:
+  push:
+    branches:
+      - master
+      - next
+  pull_request:
+
+
+jobs:
+  test:
+    name: Run Robot Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Pull images
+        run: |
+          cp .env.example .env
+          docker compose version
+          docker compose pull
+
+      - name: Docker cache
+        uses: satackey/action-docker-layer-caching@v0.0.11
+        continue-on-error: true
+
+      - name: Start the service
+        run: |
+          docker compose up -d back postgres traefik meilisearch --wait
+
+      - name: Perform healthchecks
+        run: |
+          docker compose ps -a
+          docker compose logs
+          wget --retry-connrefused --retry-on-http-error=502 http://localhost:8901/api/health || (docker compose logs && exit 1)
+
+      - name: Run robot tests
+        run: |
+          pip install -r back/tests/robot/requirements.txt
+          robot -d out back/tests/robot/
+
+      - name: Show logs
+        if: failure()
+        run: docker compose logs
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: results
+          path: out
+

.github/workflows/tests.yml

@@ -1,48 +0,0 @@
-name: Testing
-
-on: [push, pull_request]
-
-jobs:
-  tests:
-    runs-on: ubuntu-latest
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name != github.repository
-    container: mcr.microsoft.com/dotnet/sdk:5.0
-    services:
-      postgres:
-        image: postgres
-        env:
-          POSTGRES_PASSWORD: postgres
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-    steps:
-    - uses: actions/checkout@v2
-    - name: Restore dependencies
-      run: dotnet restore
-    - name: Build
-      run: |
-        dotnet build --no-restore '-p:SkipWebApp=true;SkipTranscoder=true' -p:CopyLocalLockFileAssemblies=true
-        cp ./src/Kyoo.Abstractions/bin/Debug/net5.0/Microsoft.Extensions.DependencyInjection.Abstractions.dll ./tests/Kyoo.Tests/bin/Debug/net5.0/
-    - name: Test
-      run: dotnet test --no-build '-p:CollectCoverage=true;CoverletOutputFormat=opencover' --logger "trx;LogFileName=TestOutputResults.xml"
-      env:
-        POSTGRES_HOST: postgres
-        POSTGRES_USERNAME: postgres
-        POSTGRES_PASSWORD: postgres
-    - name: Sanitize coverage output
-      if: ${{ always() }}
-      run: sed -i "s'$(pwd)'.'" tests/Kyoo.Tests/coverage.opencover.xml
-    - name: Upload tests results
-      if: ${{ always() }}
-      uses: actions/upload-artifact@v2
-      with:
-        name: results.xml
-        path: "**/TestOutputResults.xml"
-    - name: Upload coverage report
-      if: ${{ always() }}
-      uses: actions/upload-artifact@v2
-      with:
-        name: coverage.xml
-        path: "**/coverage.opencover.xml"

.gitignore

@@ -1,353 +1,8 @@
-## PROJECT CUSTOM IGNORES
-# Transcoder build (auto generated from Kyoo.Transcoder sub-project)
-Kyoo/Transcoder/Kyoo.Transcoder.dll
-Kyoo/Transcoder/Kyoo.Transcoder.ilk
-Kyoo/Transcoder/Kyoo.Transcoder.lib
-Kyoo/Transcoder/Kyoo.Transcoder.pdb
-Kyoo/Transcoder/Kyoo.Transcoder.exp
-
-libtranscoder.so
-libtranscoder.dylib
-transcoder.dll
-
-## Ignore Visual Studio temporary files, build results, and
-## files generated by popular Visual Studio add-ons.
-##
-## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
-
-# User-specific files
-*.rsuser
-*.suo
-*.user
-*.userosscache
-*.sln.docstates
-
-# User-specific files (MonoDevelop/Xamarin Studio)
-*.userprefs
-
-# Build results
-[Dd]ebug/
-[Dd]ebugPublic/
-[Rr]elease/
-[Rr]eleases/
-x64/
-x86/
-[Aa][Rr][Mm]/
-[Aa][Rr][Mm]64/
-bld/
-[Bb]in/
-[Oo]bj/
-[Ll]og/
-
-# Visual Studio 2015/2017 cache/options directory
-.vs/
-# Uncomment if you have tasks that create the project's static files in wwwroot
-#wwwroot/
-
-# Visual Studio 2017 auto generated files
-Generated\ Files/
-
-# MSTest test Results
-[Tt]est[Rr]esult*/
-[Bb]uild[Ll]og.*
-
-# NUNIT
-*.VisualState.xml
-TestResult.xml
-
-# Build Results of an ATL Project
-[Dd]ebugPS/
-[Rr]eleasePS/
-dlldata.c
-
-# Benchmark Results
-BenchmarkDotNet.Artifacts/
-
-# .NET Core
-project.lock.json
-project.fragment.lock.json
-artifacts/
-
-# StyleCop
-StyleCopReport.xml
-
-# Files built by Visual Studio
-*_i.c
-*_p.c
-*_h.h
-*.ilk
-*.meta
-*.obj
-*.iobj
-*.pch
-*.pdb
-*.ipdb
-*.pgc
-*.pgd
-*.rsp
-*.sbr
-*.tlb
-*.tli
-*.tlh
-*.tmp
-*.tmp_proj
-*_wpftmp.csproj
-*.log
-*.vspscc
-*.vssscc
-.builds
-*.pidb
-*.svclog
-*.scc
-
-# Chutzpah Test files
-_Chutzpah*
-
-# Visual C++ cache files
-ipch/
-*.aps
-*.ncb
-*.opendb
-*.opensdf
-*.sdf
-*.cachefile
-*.VC.db
-*.VC.VC.opendb
-
-# Visual Studio profiler
-*.psess
-*.vsp
-*.vspx
-*.sap
-
-# Visual Studio Trace Files
-*.e2e
-
-# TFS 2012 Local Workspace
-$tf/
-
-# Guidance Automation Toolkit
-*.gpState
-
-# ReSharper is a .NET coding add-in
-_ReSharper*/
-*.[Rr]e[Ss]harper
-*.DotSettings.user
-
-# JustCode is a .NET coding add-in
-.JustCode
-
-# TeamCity is a build add-in
-_TeamCity*
-
-# DotCover is a Code Coverage Tool
-*.dotCover
-
-# AxoCover is a Code Coverage Tool
-.axoCover/*
-!.axoCover/settings.json
-
-# Visual Studio code coverage results
-*.coverage
-*.coveragexml
-
-# NCrunch
-_NCrunch_*
-.*crunch*.local.xml
-nCrunchTemp_*
-
-# MightyMoose
-*.mm.*
-AutoTest.Net/
-
-# Web workbench (sass)
-.sass-cache/
-
-# Installshield output folder
-[Ee]xpress/
-
-# DocProject is a documentation generator add-in
-DocProject/buildhelp/
-DocProject/Help/*.HxT
-DocProject/Help/*.HxC
-DocProject/Help/*.hhc
-DocProject/Help/*.hhk
-DocProject/Help/*.hhp
-DocProject/Help/Html2
-DocProject/Help/html
-
-# Click-Once directory
-publish/
-
-# Publish Web Output
-*.[Pp]ublish.xml
-*.azurePubxml
-# Note: Comment the next line if you want to checkin your web deploy settings,
-# but database connection strings (with potential passwords) will be unencrypted
-*.pubxml
-*.publishproj
-
-# Microsoft Azure Web App publish settings. Comment the next line if you want to
-# checkin your Azure Web App publish settings, but sensitive information contained
-# in these scripts will be unencrypted
-PublishScripts/
-
-# NuGet Packages
-*.nupkg
-# The packages folder can be ignored because of Package Restore
-**/[Pp]ackages/*
-# except build/, which is used as an MSBuild target.
-!**/[Pp]ackages/build/
-# Uncomment if necessary however generally it will be regenerated when needed
-#!**/[Pp]ackages/repositories.config
-# NuGet v3's project.json files produces more ignorable files
-*.nuget.props
-*.nuget.targets
-
-# Microsoft Azure Build Output
-csx/
-*.build.csdef
-
-# Microsoft Azure Emulator
-ecf/
-rcf/
-
-# Windows Store app package directories and files
-AppPackages/
-BundleArtifacts/
-Package.StoreAssociation.xml
-_pkginfo.txt
-*.appx
-
-# Visual Studio cache files
-# files ending in .cache can be ignored
-*.[Cc]ache
-# but keep track of directories ending in .cache
-!?*.[Cc]ache/
-
-# Others
-ClientBin/
-~$*
-*~
-*.dbmdl
-*.dbproj.schemaview
-*.jfm
-*.pfx
-*.publishsettings
-orleans.codegen.cs
-
-# Including strong name files can present a security risk
-# (https://github.com/github/gitignore/pull/2483#issue-259490424)
-#*.snk
-
-# Since there are multiple workflows, uncomment next line to ignore bower_components
-# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
-#bower_components/
-
-# RIA/Silverlight projects
-Generated_Code/
-
-# Backup & report files from converting an old project file
-# to a newer Visual Studio version. Backup files are not needed,
-# because we have git ;-)
-_UpgradeReport_Files/
-Backup*/
-UpgradeLog*.XML
-UpgradeLog*.htm
-ServiceFabricBackup/
-*.rptproj.bak
-
-# SQL Server files
-*.mdf
-*.ldf
-*.ndf
-
-# Business Intelligence projects
-*.rdl.data
-*.bim.layout
-*.bim_*.settings
-*.rptproj.rsuser
-*- Backup*.rdl
-
-# Microsoft Fakes
-FakesAssemblies/
-
-# GhostDoc plugin setting file
-*.GhostDoc.xml
-
-# Node.js Tools for Visual Studio
-.ntvs_analysis.dat
-node_modules/
-
-# Visual Studio 6 build log
-*.plg
-
-# Visual Studio 6 workspace options file
-*.opt
-
-# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
-*.vbw
-
-# Visual Studio LightSwitch build output
-**/*.HTMLClient/GeneratedArtifacts
-**/*.DesktopClient/GeneratedArtifacts
-**/*.DesktopClient/ModelManifest.xml
-**/*.Server/GeneratedArtifacts
-**/*.Server/ModelManifest.xml
-_Pvt_Extensions
-
-# Paket dependency manager
-.paket/paket.exe
-paket-files/
-
-# FAKE - F# Make
-.fake/
-
-# JetBrains Rider
-.idea/
-*.sln.iml
-
-# CodeRush personal settings
-.cr/personal
-
-# Python Tools for Visual Studio (PTVS)
-__pycache__/
-*.pyc
-
-# Cake - Uncomment if you are using it
-# tools/**
-# !tools/packages.config
-
-# Tabs Studio
-*.tss
-
-# Telerik's JustMock configuration file
-*.jmconfig
-
-# BizTalk build output
-*.btp.cs
-*.btm.cs
-*.odx.cs
-*.xsd.cs
-
-# OpenCover UI analysis results
-OpenCover/
-
-# Azure Stream Analytics local run output
-ASALocalRun/
-
-# MSBuild Binary and Structured Log
-*.binlog
-
-# NVidia Nsight GPU debugger configuration file
-*.nvuser
-
-# MFractors (Xamarin productivity tool) working folder
-.mfractor/
-
-# Local History for Visual Studio
-.localhistory/
-
-# BeatPulse healthcheck temp database
-healthchecksdb
-/Kyoo/TheTVDB-Credentials.json
+/video
+.env
+.venv
+.idea
+.vscode
+log.html
+output.xml
+report.html

.gitmodules

@@ -1,4 +0,0 @@
-[submodule "transcoder"]
-	path = src/Kyoo.Transcoder
-	url = ../Kyoo.Transcoder.git
-	branch = master

.pg_format

@@ -0,0 +1,5 @@
+tabs=1
+function-case=1 #lowercase
+keyword-case=1
+type-case=1
+no-space-function=1

AUTHORS.md

@@ -1,4 +1,4 @@
 # Authors
 Ordered by the date of the first commit.
 
-* Zoe Roux ([@AnonymusRaccoon](http://github.com/AnonymusRaccoon))
+* Zoe Roux ([@zoriya](http://github.com/zoriya))

CONTRIBUTING.md

@@ -3,21 +3,19 @@
 Hi there! We're thrilled that you'd like to contribute to this project. Your help is essential for keeping it great.
 
 Contributions to this project are [released](https://docs.github.com/en/github/site-policy/github-terms-of-service#6-contributions-under-repository-license)
-to the public under the [GPL-3.0 License](https://github.com/AnonymusRaccoon/Kyoo/blob/master/LICENSE).
+to the public under the [GPL-3.0 License](https://github.com/zoriya/Kyoo/blob/master/LICENSE).
 
 ## Submitting a pull request
 
-1. [Fork](https://github.com/AnonymusRaccoon/Kyoo/fork) and clone the repository
-2. Install the toolstack and/or download precompiled binaries for the transcoder (see [Development & Build](https://github.com/AnonymusRaccoon/Kyoo#development--build))
-3. Create a new branch: `git checkout -b my-branch-name`
-4. Make your changes (Please try to follow the same coding style as what has already been made - indent with tabs, align with spaces etc)
-5. Make sure the tests pass: `dotnet tests`
-6. Push to your fork and [submit a pull request](https://github.com/AnonymusRaccoon/Kyoo/compare)
-7. Pat your self on the back and wait for your pull request to be reviewed and merged.
+1. [Fork](https://github.com/zoriya/Kyoo/fork) and clone the repository
+2. Create a new branch: `git checkout -b my-branch-name`
+3. Make your changes (Please try to follow the same coding style as what has already been made - indent with tabs, align with spaces etc).
+Don't forget to run the auto-formatter.
+4. Push to your fork and [submit a pull request](https://github.com/zoriya/Kyoo/compare)
+5. Pat your self on the back and wait for your pull request to be reviewed and merged.
 
 Here are a few things you can do that will increase the likelihood of your pull request being accepted:
 
-- Write tests.
 - Make sure the `README.md` and any other relevant **documentation are kept up-to-date**.
 - We try to follow [SemVer v2.0.0](https://semver.org/). Randomly breaking public APIs is not an option.
 - Keep your change as focused as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as **separate pull requests**.

Dockerfile

@@ -1,25 +0,0 @@
-FROM gcc:latest as transcoder
-RUN apt-get update && apt-get install -y cmake make libavutil-dev libavcodec-dev libavformat-dev
-WORKDIR /transcoder
-COPY src/Kyoo.Transcoder .
-RUN cmake . && make -j
-
-FROM node:14-alpine as webapp
-WORKDIR /webapp
-COPY front .
-RUN npm install -g @angular/cli
-RUN yarn install --frozen-lockfile
-RUN yarn run build --configuration production
-
-FROM mcr.microsoft.com/dotnet/sdk:5.0 as builder
-COPY . .
-RUN dotnet publish -c Release -o /opt/kyoo '-p:SkipWebApp=true;SkipTranscoder=true;CheckCodingStyle=false' src/Kyoo.Host.Console
-
-FROM mcr.microsoft.com/dotnet/aspnet:5.0
-RUN apt-get update && apt-get install -y libavutil-dev libavcodec-dev libavformat-dev
-EXPOSE 5000
-COPY --from=builder /opt/kyoo /usr/lib/kyoo
-COPY --from=transcoder /transcoder/libtranscoder.so /usr/lib/kyoo
-COPY --from=webapp /webapp/dist/* /usr/lib/kyoo/wwwroot/
-CMD ["/usr/lib/kyoo/Kyoo.Host.Console"]
-

INSTALLING.md

@@ -0,0 +1,90 @@
+# Installing TLDR
+
+1. Install docker & docker-compose
+2. Download the
+   [`docker-compose.yml`](https://github.com/zoriya/kyoo/releases/latest/download/docker-compose.yml) and
+   [`.env`](https://raw.githubusercontent.com/zoriya/Kyoo/master/.env.example) files
+3. Fill the `.env` file with your configuration options
+4. Look at [Hardware Acceleration section](#Hardware-Acceleration) if you need it
+5. Run `docker compose up -d` and see kyoo at `http://localhost:8901`
+
+# Installing
+
+To install Kyoo, you need docker and docker-compose. Those can be installed from here for
+[Linux](https://docs.docker.com/engine/install/)
+[Mac](https://docs.docker.com/desktop/install/mac-install/)
+or [Windows](https://docs.docker.com/desktop/install/windows-install/). Docker is used to run each services of Kyoo in
+an isolated environment with all the dependencies they need.
+
+Kyoo also needs 2 files to work properly. The first should be downloaded from the latest release artifact, the other needs to be filled in with your configurations.
+Those files can be put in any directory of your choice.
+
+Those files are:
+
+- A `docker-compose.yml` (simply download docker-compose.yml from [the latest release](https://github.com/zoriya/kyoo/releases/latest/download/docker-compose.yml)).
+- A `.env` file that you will need to **fill**. Look at the example [.env.example](https://raw.githubusercontent.com/zoriya/Kyoo/master/.env.example)
+
+> If you want an explanation of what are those files, you can read the following:
+> The `docker-compose.yml` file describes the different services of Kyoo, where they should be downloaded and their start order. \
+> The `.env` file contains all the configuration options that the services in `docker-compose.yml` will read.
+
+If you need hardware acceleration, look at [Hardware Acceleration section](#Hardware-Acceleration) if you need it
+
+The next and last step is actually starting Kyoo. To do that, open a terminal in the same directory as the 3 configurations files
+and run `docker-compose up -d`.
+
+Congratulation, everything is now ready to use Kyoo. You can navigate to `http://localhost:8901` on a web browser to see your instance of Kyoo.
+
+# Updating
+
+Updating Kyoo is exactly the same as installing it. Get an updated version of the `docker-compose.yml` file and
+unsure that your `.env` contains all the options specified in the updated `.env.example` file.
+
+After that, you will need to update Kyoo's services. For that, open a terminal in the configuration's directory and run
+the command `docker-compose pull`. You are now ready to restart Kyoo, you can run `docker-compose up -d`.
+
+# Uninstalling
+
+To uninstall Kyoo, you need to open a terminal in the configuration's directory and run `docker-compose down`. This will
+stop Kyoo's services. You can then remove the configuration files.
+
+# Hardware Acceleration
+
+## VA-API (intel, amd)
+
+First install necessary drivers on your system, when running `vainfo` you should have something like this:
+```
+libva info: VA-API version 1.20.0
+libva info: Trying to open /run/opengl-driver/lib/dri/iHD_drv_video.so
+libva info: Found init function __vaDriverInit_1_20
+libva info: va_openDriver() returns 0
+vainfo: VA-API version: 1.20 (libva 2.20.1)
+vainfo: Driver version: Intel iHD driver for Intel(R) Gen Graphics - 23.3.5 ()
+vainfo: Supported profile and entrypoints
+      VAProfileH264Main               :	VAEntrypointVLD
+      VAProfileH264Main               :	VAEntrypointEncSlice
+      ...Truncated...
+      VAProfileHEVCSccMain444_10      :	VAEntrypointVLD
+      VAProfileHEVCSccMain444_10      :	VAEntrypointEncSliceLP
+```
+Kyoo will default to use your primary card (located at `/dev/dri/renderD128`). If you need to specify a secondary one, you
+can use the `GOCODER_VAAPI_RENDERER` env-var to specify `/dev/dri/renderD129` or another one.
+
+Then you can simply run kyoo using `docker compose --profile vaapi up -d` (notice the `--profile vaapi` added)
+You can also add `COMPOSE_PROFILES=vaapi` to your `.env` instead of adding the `--profile` flag.
+
+## Nvidia
+
+To enable nvidia hardware acceleration, first install necessary drivers on your system.
+
+Then, install the [nvidia-container-toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html), you can simply
+follow the instructions on the official webpage or your distribution wiki.
+
+To test if everything works, you can run `sudo docker run --rm --gpus all ubuntu nvidia-smi`. If your version of docker is older,
+you might need to add `--runtime nvidia` like so: `sudo docker run --rm --runtime=nvidia --gpus all ubuntu nvidia-smi`
+
+After that, you can now use `docker compose --profile nvidia up -d` to start kyoo with nvidia hardware acceleration (notice the `--profile nvidia` added).
+You can also add `COMPOSE_PROFILES=nvidia` to your `.env` instead of adding the `--profile` flag.
+
+Note that most nvidia cards have an artificial limit on the number of encodes. You can confirm your card limit [here](https://developer.nvidia.com/video-encode-and-decode-gpu-support-matrix-new).
+This limit can also be removed by applying an [unofficial patch](https://github.com/keylase/nvidia-patch) to you driver.

Kyoo.sln

@@ -1,116 +0,0 @@
-Microsoft Visual Studio Solution File, Format Version 12.00
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Kyoo.Core", "src\Kyoo.Core\Kyoo.Core.csproj", "{0F8275B6-C7DD-42DF-A168-755C81B1C329}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Abstractions", "src\Kyoo.Abstractions\Kyoo.Abstractions.csproj", "{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Database", "src\Kyoo.Database\Kyoo.Database.csproj", "{6F91B645-F785-46BB-9C4F-1EFC83E489B6}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Postgresql", "src\Kyoo.Postgresql\Kyoo.Postgresql.csproj", "{3213C96D-0BF3-460B-A8B5-B9977229408A}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Authentication", "src\Kyoo.Authentication\Kyoo.Authentication.csproj", "{7A841335-6523-47DB-9717-80AA7BD943FD}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.SqLite", "src\Kyoo.SqLite\Kyoo.SqLite.csproj", "{6515380E-1E57-42DA-B6E3-E1C8A848818A}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.TheTvdb", "src\Kyoo.TheTvdb\Kyoo.TheTvdb.csproj", "{D06BF829-23F5-40F3-A62D-627D9F4B4D6C}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.TheMovieDb", "src\Kyoo.TheMovieDb\Kyoo.TheMovieDb.csproj", "{BAB270D4-E0EA-4329-BA65-512FDAB01001}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Tests", "tests\Kyoo.Tests\Kyoo.Tests.csproj", "{0C8AA7EA-E723-4532-852F-35AA4E8AFED5}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.WebApp", "src\Kyoo.WebApp\Kyoo.WebApp.csproj", "{2374D500-1ADB-4752-85DB-8BB0DDF5A8E8}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Host.WindowsTrait", "src\Kyoo.Host.WindowsTrait\Kyoo.Host.WindowsTrait.csproj", "{98851001-40DD-46A6-94B3-2F8D90722076}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Host.Console", "src\Kyoo.Host.Console\Kyoo.Host.Console.csproj", "{D8658BEA-8949-45AC-BEBB-A4FFC4F800F5}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Swagger", "src\Kyoo.Swagger\Kyoo.Swagger.csproj", "{7D1A7596-73F6-4D35-842E-A5AD9C620596}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Tests", "Tests", "{FEAE1B0E-D797-470F-9030-0EF743575ECC}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Providers", "Providers", "{8D28F5EF-0CD7-4697-A2A7-24EC31A48F21}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Databases", "Databases", "{865461CA-EC06-4B42-91CF-8723B0A9BB67}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Hosts", "Hosts", "{C569FF25-7E01-484C-9F72-5B99845AD94B}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Host.Generic", "src\Kyoo.Host.Generic\Kyoo.Host.Generic.csproj", "{0938459E-2E2B-457F-8120-7D8CA93866A6}"
-EndProject
-Global
-	GlobalSection(SolutionConfigurationPlatforms) = preSolution
-		Debug|Any CPU = Debug|Any CPU
-		Release|Any CPU = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{0F8275B6-C7DD-42DF-A168-755C81B1C329}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{0F8275B6-C7DD-42DF-A168-755C81B1C329}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{0F8275B6-C7DD-42DF-A168-755C81B1C329}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{0F8275B6-C7DD-42DF-A168-755C81B1C329}.Release|Any CPU.Build.0 = Release|Any CPU
-		{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}.Release|Any CPU.Build.0 = Release|Any CPU
-		{6F91B645-F785-46BB-9C4F-1EFC83E489B6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{6F91B645-F785-46BB-9C4F-1EFC83E489B6}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{6F91B645-F785-46BB-9C4F-1EFC83E489B6}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{6F91B645-F785-46BB-9C4F-1EFC83E489B6}.Release|Any CPU.Build.0 = Release|Any CPU
-		{3213C96D-0BF3-460B-A8B5-B9977229408A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{3213C96D-0BF3-460B-A8B5-B9977229408A}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{3213C96D-0BF3-460B-A8B5-B9977229408A}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{3213C96D-0BF3-460B-A8B5-B9977229408A}.Release|Any CPU.Build.0 = Release|Any CPU
-		{7A841335-6523-47DB-9717-80AA7BD943FD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{7A841335-6523-47DB-9717-80AA7BD943FD}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{7A841335-6523-47DB-9717-80AA7BD943FD}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{7A841335-6523-47DB-9717-80AA7BD943FD}.Release|Any CPU.Build.0 = Release|Any CPU
-		{6515380E-1E57-42DA-B6E3-E1C8A848818A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{6515380E-1E57-42DA-B6E3-E1C8A848818A}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{6515380E-1E57-42DA-B6E3-E1C8A848818A}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{6515380E-1E57-42DA-B6E3-E1C8A848818A}.Release|Any CPU.Build.0 = Release|Any CPU
-		{D06BF829-23F5-40F3-A62D-627D9F4B4D6C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{D06BF829-23F5-40F3-A62D-627D9F4B4D6C}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{D06BF829-23F5-40F3-A62D-627D9F4B4D6C}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{D06BF829-23F5-40F3-A62D-627D9F4B4D6C}.Release|Any CPU.Build.0 = Release|Any CPU
-		{BAB270D4-E0EA-4329-BA65-512FDAB01001}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{BAB270D4-E0EA-4329-BA65-512FDAB01001}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{BAB270D4-E0EA-4329-BA65-512FDAB01001}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{BAB270D4-E0EA-4329-BA65-512FDAB01001}.Release|Any CPU.Build.0 = Release|Any CPU
-		{0C8AA7EA-E723-4532-852F-35AA4E8AFED5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{0C8AA7EA-E723-4532-852F-35AA4E8AFED5}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{0C8AA7EA-E723-4532-852F-35AA4E8AFED5}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{0C8AA7EA-E723-4532-852F-35AA4E8AFED5}.Release|Any CPU.Build.0 = Release|Any CPU
-		{2374D500-1ADB-4752-85DB-8BB0DDF5A8E8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{2374D500-1ADB-4752-85DB-8BB0DDF5A8E8}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{2374D500-1ADB-4752-85DB-8BB0DDF5A8E8}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{2374D500-1ADB-4752-85DB-8BB0DDF5A8E8}.Release|Any CPU.Build.0 = Release|Any CPU
-		{4FF1ECD9-6EEF-4440-B037-A661D78FB04D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{4FF1ECD9-6EEF-4440-B037-A661D78FB04D}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{4FF1ECD9-6EEF-4440-B037-A661D78FB04D}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{4FF1ECD9-6EEF-4440-B037-A661D78FB04D}.Release|Any CPU.Build.0 = Release|Any CPU
-		{98851001-40DD-46A6-94B3-2F8D90722076}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{98851001-40DD-46A6-94B3-2F8D90722076}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{98851001-40DD-46A6-94B3-2F8D90722076}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{98851001-40DD-46A6-94B3-2F8D90722076}.Release|Any CPU.Build.0 = Release|Any CPU
-		{D8658BEA-8949-45AC-BEBB-A4FFC4F800F5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{D8658BEA-8949-45AC-BEBB-A4FFC4F800F5}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{D8658BEA-8949-45AC-BEBB-A4FFC4F800F5}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{D8658BEA-8949-45AC-BEBB-A4FFC4F800F5}.Release|Any CPU.Build.0 = Release|Any CPU
-		{7D1A7596-73F6-4D35-842E-A5AD9C620596}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{7D1A7596-73F6-4D35-842E-A5AD9C620596}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{7D1A7596-73F6-4D35-842E-A5AD9C620596}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{7D1A7596-73F6-4D35-842E-A5AD9C620596}.Release|Any CPU.Build.0 = Release|Any CPU
-		{0938459E-2E2B-457F-8120-7D8CA93866A6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{0938459E-2E2B-457F-8120-7D8CA93866A6}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{0938459E-2E2B-457F-8120-7D8CA93866A6}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{0938459E-2E2B-457F-8120-7D8CA93866A6}.Release|Any CPU.Build.0 = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(NestedProjects) = preSolution
-		{0C8AA7EA-E723-4532-852F-35AA4E8AFED5} = {FEAE1B0E-D797-470F-9030-0EF743575ECC}
-		{BAB270D4-E0EA-4329-BA65-512FDAB01001} = {8D28F5EF-0CD7-4697-A2A7-24EC31A48F21}
-		{D06BF829-23F5-40F3-A62D-627D9F4B4D6C} = {8D28F5EF-0CD7-4697-A2A7-24EC31A48F21}
-		{6F91B645-F785-46BB-9C4F-1EFC83E489B6} = {865461CA-EC06-4B42-91CF-8723B0A9BB67}
-		{3213C96D-0BF3-460B-A8B5-B9977229408A} = {865461CA-EC06-4B42-91CF-8723B0A9BB67}
-		{6515380E-1E57-42DA-B6E3-E1C8A848818A} = {865461CA-EC06-4B42-91CF-8723B0A9BB67}
-		{D8658BEA-8949-45AC-BEBB-A4FFC4F800F5} = {C569FF25-7E01-484C-9F72-5B99845AD94B}
-		{98851001-40DD-46A6-94B3-2F8D90722076} = {C569FF25-7E01-484C-9F72-5B99845AD94B}
-		{0938459E-2E2B-457F-8120-7D8CA93866A6} = {C569FF25-7E01-484C-9F72-5B99845AD94B}
-	EndGlobalSection
-EndGlobal

PRIVACY.md

@@ -0,0 +1,44 @@
+# Privacy Policy for Kyoo
+
+Effective Date: 2023-06-15
+
+Thank you for using Kyoo. This Privacy Policy outlines how we collect, use, and protect your personal information when you use our service. We are committed to ensuring the privacy and security of your data. Please read this policy carefully to understand our practices regarding your information.
+
+### 1. Information We Collect:
+
+We collect and store only the email addresses you provide during the registration process. No other personal information is requested or stored.
+
+### 2. Use of Personal Information:
+
+We use your email address solely for the purpose of user authentication and login. We do not use, access, or share your email address with any third parties.
+
+### 3. Data Storage and Security:
+
+All personal information, limited to email addresses, is stored securely on our self-hosted servers. We take appropriate technical and organizational measures to protect against unauthorized access, alteration, disclosure, or destruction of your personal information.
+
+### 4. Data Sharing:
+
+We do not share any personal information, including email addresses, with any third parties. Your data remains confidential and is used only for the purposes stated in this Privacy Policy.
+
+### 5. Account Deletion:
+
+You have the right to delete your Kyoo account at any time. To do so, please click on the `Delete your account` button on the account's menu of the app/website. Upon account deletion, all associated personal information, including your email address, will be permanently and irreversibly removed from our servers.
+
+### 6. Cookies and Tracking Technologies:
+
+Kyoo does not use any cookies or tracking technologies to collect or store user information.
+
+### 7. Legal Basis for Processing:
+
+Our collection and processing of your email address is based on your consent, as it is necessary for the performance of the contract between you and Kyoo.
+
+### 8. Changes to this Privacy Policy:
+
+We may update this Privacy Policy from time to time. Any changes will be posted on this page, and the effective date will be indicated at the top of the policy. Please review this policy periodically for any updates.
+
+### 9. Contact Us:
+
+If you have any questions, concerns, or requests regarding this Privacy Policy or the processing of your personal information, please contact us at https://github.com/zoriya/kyoo/issues.
+
+
+By using Kyoo, you acknowledge and agree to the practices described in this Privacy Policy.

README.md

@@ -1,96 +1,90 @@
-# <img width="24px" src="./icons/icon-256x256.png" alt="Kyoo"> Kyoo
-<p>
-  <a href="https://github.com/AnonymusRaccoon/Kyoo/actions/workflows/build.yml"><img src="https://img.shields.io/github/workflow/status/AnonymusRaccoon/Kyoo/Build?style=flat-square" alt="Build status"></a>
-  <a href="https://github.com/AnonymusRaccoon/Kyoo/actions/workflows/tests.yml"><img src="https://img.shields.io/github/workflow/status/AnonymusRaccoon/Kyoo/Testing?label=tests&style=flat-square" alt="Tests status"></a>
-  <a href="https://github.com/users/AnonymusRaccoon/packages/container/package/kyoo"><img src="https://img.shields.io/github/workflow/status/AnonymusRaccoon/Kyoo/Docker?label=docker&style=flat-square" alt="Docker status"/></a>
-  <a href="https://sonarcloud.io/dashboard?id=AnonymusRaccoon_Kyoo"><img src="https://img.shields.io/sonar/tests/AnonymusRaccoon_Kyoo?compact_message&server=https%3A%2F%2Fsonarcloud.io&style=flat-square" alt="Test report"></a>
-  <a href="https://sonarcloud.io/dashboard?id=AnonymusRaccoon_Kyoo"><img src="https://img.shields.io/sonar/coverage/AnonymusRaccoon_Kyoo?server=https%3A%2F%2Fsonarcloud.io&style=flat-square" alt="Coverage"></a>
-  <a href="./LICENSE"><img src="https://img.shields.io/github/license/AnonymusRaccoon/Kyoo?style=flat-square" alt="License"></a>
+# <img width="24px" src="./icons/icon-256x256.png" alt=""> Kyoo
+
+Kyoo is a self-hosted media server focused on video content (Movies, Series & Anime). It is an alternative to Jellyfin or Plex.
+
+It aims to have a low amount of maintenance needed (no folder structure required nor manual metadata edits). Media not being scanned correctly (even with weird names) is considered a bug.
+
+Kyoo does not have a plugin system and aim to have every features built-in (see [#Features](#-features) for the list).
+
+![Kyoo in Action](https://raw.githubusercontent.com/zoriya/kyoo/screens/home.png)
+
+## 🌐 Getting Started
+
+- **[Installation](./INSTALLING.md):** Basic installation guidelines, how to start Kyoo, enable OIDC or hardware transcoding.
+- **[Join the discord](https://discord.gg/E6Apw3aFaA):** Ask questions, talk about the development, feature you might want or bugs you might encounter.
+- **[API Documentation](https://kyoo.zoriya.dev/api/doc):** The API to integrate Kyoo with other services, if you have any questions, please ask on github or discord!
+- **[Contributing](./CONTRIBUTING.md):** Feel free to open issues, submit pull requests, and contribute to making Kyoo even better. We need you!
+
+[![](https://discord.com/api/guilds/1216460898139635753/widget.png?style=banner2)](https://discord.gg/zpA74Qpvj5)
+
+## 🚀 Features
+
+- **Dynamic Transcoding:** Transcode your media to any quality, change on the fly with auto quality, and seek instantly without waiting for the transcoder.
+
+- **Video Preview Thumbnails:** Simply hover the video's progress bar and see a preview of the video.
+
+- **Meilisearch-Powered Search:** Advanced, typo-resilient search system powered by Meilisearch.
+
+- **OIDC Connection:** Connect using any OIDC compliant service (Google, Discord, Authelia, you name it).
+
+- **Watch List Scrubbing Support:** Your watch list is automatically synced to connected services (SIMKL and soon others [#351](https://github.com/zoriya/Kyoo/issues/351), [#352](https://github.com/zoriya/Kyoo/issues/352)). No need to manually mark episodes as watched.
+
+- **Download and Offline Support:** Download videos to watch them without internet access, you progress will automatically be synced next time your devices goes online.
+
+- **Enhanced Subtitle Support:** Subtitles are important, Kyoo supports SSA/ASS and uses the video's embedded fonts when available.
+
+- **Anime Name Parsing**: While there are still some issues (see [#466](https://github.com/zoriya/Kyoo/issues/466), Kyoo will match weird anime names (like `[Some-Stuffs] Jojo's Bizarre Adventure Stone Ocean 24 (1920x1080 Blu-Ray Opus) [2750810F].mkv`) without issue.
+
+- **Cloud Native:** Still an ongoing effort (see [#357](https://github.com/zoriya/Kyoo/issues/357)) but Kyoo is made with the idea that it could run distributed or standalone, on an RPI or on huge home-datacenters.
+
+## 📺 Clients
+
+Clients is a bit part of media servers but for now, Kyoo's focus is on features. Only a web version and an android apps are available for now. The front is written with react-native (expo) so adapting for others platform is possible. Here is a rough roadmap of clients supports:
+- Today: Web & Android
+- End of 2024: Chromecast support
+- Summer 2025: Android TV app
+
+Apple devices are not planned for now because I do not own any of their device, and it requires $100/year.
+
+If you would like to have a client sooner or on devices not listed on the roadmap, come hang on the discord and consider contributing to Kyoo.
+
+## 📖 Translations
+
+If Kyoo is not available on your language, you can use [weblate](https://hosted.weblate.org/engage/kyoo/) to add translations easily.
+
+[![Translation status](https://hosted.weblate.org/widget/kyoo/kyoo/multi-auto.svg)](https://hosted.weblate.org/engage/kyoo/)
+
+## 📜 Why another media-browser?
+
+From a technical standpoint, both Jellyfin and Plex lean on SQLite and confine everything within a single container, Kyoo takes a different route. We're not afraid to bring in additional containers when it makes sense – whether for specialized features like Meilisearch powering our search system or for scalability, as seen with our transcoder.
+
+Kyoo embraces the "setup once, forget about it" philosophy. Unlike Plex and Jellyfin, we don't burden you with manual file renaming or specific folder structures. Kyoo seamlessly works with files straight from your download directory, minimizing the maintenance headache for server admins.
+
+Kyoo narrows its focus to movies, TV shows, and anime streaming. No music, ebooks, or games – just pure cinematic delight.
+
+## 🔗 Live Demo
+
+Curious to see Kyoo in action? Check out our live demo featuring copyright-free movies at [kyoo.zoriya.dev](https://kyoo.zoriya.dev). Special thanks to the Blender Studio for providing open-source movies available for all.
+
+## 👀 Screens
+
+![Web Show](https://raw.githubusercontent.com/zoriya/kyoo/screens/show-details.png)
+
+![Desktop Scrubber](https://raw.githubusercontent.com/zoriya/kyoo/screens/hover-scrubber.png)
+
+![Touch Scrubber](https://raw.githubusercontent.com/zoriya/kyoo/screens/bottom-scrubber.png)
+
+![Collection](https://raw.githubusercontent.com/zoriya/kyoo/screens/collection.png)
+
+![List](https://raw.githubusercontent.com/zoriya/kyoo/screens/list.png)
+
+<p align="center">
+	<img
+		src="https://raw.githubusercontent.com/zoriya/kyoo/screens/android-movie.png"
+		alt="Android Movie"
+		width="350"
+	/>
 </p>
+Ready to elevate your streaming experience? Dive into Kyoo now! 🎬🎉
 
-Kyoo is an open-source media browser which allow you to stream your movies, tv-shows or anime.
-It is an alternative to Plex, Emby or Jellyfin.
-
-Kyoo has been created from scratch, it is not a fork. Everything is and always will be free and open-source.
-
-Feel free to open issues or pull requests, all contribution are welcomed.
-
-## Getting started
-
-- [Installation](https://docs.kyoo.moe/start/install.html)
-- [Setting Up](https://docs.kyoo.moe/start/setting_up.html)
-- [Api Documentation](https://demo.kyoo.moe/redoc)
-- [Documentation (work in progress)](https://docs.kyoo.moe)
-- [Contributing](./CONTRIBUTING.md)
-
-## Features
- - Manage your movies, tv-series & anime
- - Download metadata automatically
- - Transmux files to make them available on every platform (Transcode coming soon)
- - Account system with a permission system
- - Handle subtitles natively with embedded fonts (ass, subrip or vtt)
- - Entirely free and works without internet (when metadata have already been downloaded)
- - Works on Linux, Windows, Docker and probably Mac
- - A powerful plugin system
-
-## Live Demo
-
-You can see a live demo with copyright-free movies here: [demo.kyoo.moe](https://demo.kyoo.moe).
-Thanks to the [blender studio](https://www.blender.org/about/studio/) for providing open-source movies available for all.
-
-The demo server is simply created using the following docker compose:
-
-```yml
-version: "3.8"
-
-services:
-    kyoo:
-        image: ghcr.io/anonymusraccoon/kyoo:master
-        restart: on-failure
-        environment:
-            - KYOO_DATADIR=/var/lib/kyoo
-            - BASICS__PUBLICURL=https://demo.kyoo.moe
-            - BASICS__MetadataInShow=false
-            - DATABASE__ENABLED=postgres
-            - DATABASE__CONFIGURATIONS__POSTGRES__SERVER=postgres
-            - DATABASE__CONFIGURATIONS__POSTGRES__USER ID=kyoo
-            - DATABASE__CONFIGURATIONS__POSTGRES__PASSWORD=kyooPassword
-            - TVDB__APIKEY=TheTvDbApiKey
-            - THE-MOVIEDB__APIKEY=TheMovieDbApiKey
-        ports:
-            - "80:5000"
-        depends_on:
-            - postgres
-        volumes:
-            - kyoo:/var/lib/kyoo
-            - video:/video
-    postgres:
-        image: "postgres"
-        restart: on-failure
-        environment:
-            - POSTGRES_USER=kyoo
-            - POSTGRES_PASSWORD=kyooPassword
-        volumes:
-            - db:/var/lib/postgresql/data
-
-volumes:
-    kyoo:
-    video:
-    db:
-```
-
-## Screens
-
-![Show](../screens/show.png?raw=true)
-- - -
-![Show Dropdown](../screens/show_dropdown.png?raw=true)
-- - -
-![Browse](../screens/browse.png?raw=true)
-- - -
-![Filters](../screens/filters.png?raw=true)
-- - -
-![People](../screens/people.png?raw=true)
-- - -
-![Player](../screens/player.png?raw=true)
-- - -
-![Search](../screens/search.png?raw=true)
+<!-- vim: set wrap: -->

autosync/.gitignore

@@ -0,0 +1 @@
+__pycache__

autosync/Dockerfile

@@ -0,0 +1,8 @@
+FROM python:3.12
+WORKDIR /app
+
+COPY ./requirements.txt .
+RUN pip3 install -r ./requirements.txt
+
+COPY . .
+ENTRYPOINT ["python3", "-m", "autosync"]

autosync/autosync/__init__.py

@@ -0,0 +1,11 @@
+async def main():
+	import logging
+	from autosync.services.simkl import Simkl
+	from autosync.services.aggregate import Aggregate
+	from autosync.consumer import Consumer
+
+	logging.basicConfig(level=logging.INFO)
+
+	service = Aggregate([Simkl()])
+	async with Consumer() as consumer:
+		await consumer.listen(service)

autosync/autosync/__main__.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env python
+
+import asyncio
+import autosync
+
+asyncio.run(autosync.main())

autosync/autosync/consumer.py

@@ -0,0 +1,51 @@
+import asyncio
+from msgspec import json
+import os
+from logging import getLogger
+from aio_pika import ExchangeType, connect_robust
+from aio_pika.abc import AbstractIncomingMessage
+
+from autosync.services.service import Service
+from autosync.models.message import Message
+
+
+logger = getLogger(__name__)
+
+
+class Consumer:
+	QUEUE = "autosync"
+
+	async def __aenter__(self):
+		self._con = await connect_robust(
+			host=os.environ.get("RABBITMQ_HOST", "rabbitmq"),
+			port=int(os.environ.get("RABBITMQ_PORT", "5672")),
+			login=os.environ.get("RABBITMQ_DEFAULT_USER", "guest"),
+			password=os.environ.get("RABBITMQ_DEFAULT_PASS", "guest"),
+		)
+		self._channel = await self._con.channel()
+		self._exchange = await self._channel.declare_exchange(
+			"events.watched", type=ExchangeType.TOPIC
+		)
+		self._queue = await self._channel.declare_queue(self.QUEUE)
+		await self._queue.bind(self._exchange, routing_key="#")
+		return self
+
+	async def __aexit__(self, exc_type, exc_value, exc_tb):
+		await self._con.close()
+
+	async def listen(self, service: Service):
+		async def on_message(message: AbstractIncomingMessage):
+			try:
+				msg = json.decode(message.body, type=Message)
+				service.update(msg.value.user, msg.value.resource, msg.value)
+				await message.ack()
+			except Exception as e:
+				logger.exception("Unhandled error", exc_info=e)
+				await message.reject()
+
+		# Allow up to 20 requests to run in parallel on the same listener.
+		# Since most work is calling API not doing that is a waste.
+		await self._channel.set_qos(prefetch_count=20)
+		await self._queue.consume(on_message)
+		logger.info("Listening for autosync.")
+		await asyncio.Future()

autosync/autosync/models/episode.py

@@ -0,0 +1,12 @@
+from msgspec import Struct
+from autosync.models.show import Show
+
+from .metadataid import EpisodeID
+
+
+class Episode(Struct, rename="camel", tag_field="kind", tag="episode"):
+	external_id: dict[str, EpisodeID]
+	show: Show
+	season_number: int
+	episode_number: int
+	absolute_number: int

autosync/autosync/models/message.py

@@ -0,0 +1,17 @@
+from msgspec import Struct
+from autosync.models.episode import Episode
+from autosync.models.movie import Movie
+from autosync.models.show import Show
+from autosync.models.user import User
+from autosync.models.watch_status import WatchStatus
+
+
+class WatchStatusMessage(WatchStatus):
+	user: User
+	resource: Movie | Show | Episode
+
+
+class Message(Struct, rename="camel"):
+	action: str
+	type: str
+	value: WatchStatusMessage

autosync/autosync/models/metadataid.py

@@ -0,0 +1,14 @@
+from msgspec import Struct
+from typing import Optional
+
+
+class MetadataID(Struct, rename="camel"):
+	data_id: str
+	link: Optional[str]
+
+
+class EpisodeID(Struct, rename="camel"):
+	show_id: str
+	season: Optional[int]
+	episode: int
+	link: Optional[str]

autosync/autosync/models/movie.py

@@ -0,0 +1,15 @@
+from typing import Optional
+from datetime import date
+from msgspec import Struct
+
+from .metadataid import MetadataID
+
+
+class Movie(Struct, rename="camel", tag_field="kind", tag="movie"):
+	name: str
+	air_date: Optional[date]
+	external_id: dict[str, MetadataID]
+
+	@property
+	def year(self):
+		return self.air_date.year if self.air_date is not None else None

autosync/autosync/models/show.py

@@ -0,0 +1,15 @@
+from typing import Optional
+from datetime import date
+from msgspec import Struct
+
+from .metadataid import MetadataID
+
+
+class Show(Struct, rename="camel", tag_field="kind", tag="show"):
+	name: str
+	start_air: Optional[date]
+	external_id: dict[str, MetadataID]
+
+	@property
+	def year(self):
+		return self.start_air.year if self.start_air is not None else None

autosync/autosync/models/user.py

@@ -0,0 +1,26 @@
+from msgspec import Struct
+from datetime import datetime
+from typing import Optional
+
+
+class JwtToken(Struct):
+	token_type: str
+	access_token: str
+	refresh_token: Optional[str]
+	expire_at: datetime
+
+
+class ExternalToken(Struct, rename="camel"):
+	id: str
+	username: str
+	profile_url: Optional[str]
+	token: JwtToken
+
+
+class User(Struct, rename="camel", tag_field="kind", tag="user"):
+	id: str
+	username: str
+	email: str
+	permissions: list[str]
+	settings: dict[str, str]
+	external_id: dict[str, ExternalToken]

autosync/autosync/models/watch_status.py

@@ -0,0 +1,21 @@
+from datetime import datetime
+from typing import Optional
+from enum import Enum
+
+from msgspec import Struct
+
+
+class Status(str, Enum):
+	COMPLETED = "Completed"
+	WATCHING = "Watching"
+	DROPED = "Droped"
+	PLANNED = "Planned"
+	DELETED = "Deleted"
+
+
+class WatchStatus(Struct, rename="camel"):
+	added_date: datetime
+	played_date: Optional[datetime]
+	status: Status
+	watched_time: Optional[int]
+	watched_percent: Optional[int]

autosync/autosync/services/aggregate.py

@@ -0,0 +1,28 @@
+from logging import getLogger
+from autosync.services.service import Service
+from ..models.user import User
+from ..models.show import Show
+from ..models.movie import Movie
+from ..models.episode import Episode
+from ..models.watch_status import WatchStatus
+
+logger = getLogger(__name__)
+
+
+class Aggregate(Service):
+	def __init__(self, services: list[Service]):
+		self._services = [x for x in services if x.enabled]
+		logger.info("Autosync enabled with %s", [x.name for x in self._services])
+
+	@property
+	def name(self) -> str:
+		return "aggragate"
+
+	def update(self, user: User, resource: Movie | Show | Episode, status: WatchStatus):
+		for service in self._services:
+			try:
+				service.update(user, resource, status)
+			except Exception as e:
+				logger.exception(
+					"Unhandled error on autosync %s:", service.name, exc_info=e
+				)

autosync/autosync/services/service.py

@@ -0,0 +1,21 @@
+from abc import abstractmethod, abstractproperty
+
+from ..models.user import User
+from ..models.show import Show
+from ..models.movie import Movie
+from ..models.episode import Episode
+from ..models.watch_status import WatchStatus
+
+
+class Service:
+	@abstractproperty
+	def name(self) -> str:
+		raise NotImplementedError
+
+	@abstractproperty
+	def enabled(self) -> bool:
+		return True
+
+	@abstractmethod
+	def update(self, user: User, resource: Movie | Show | Episode, status: WatchStatus):
+		raise NotImplementedError

autosync/autosync/services/simkl.py

@@ -0,0 +1,117 @@
+import os
+import requests
+from logging import getLogger
+from autosync.models.metadataid import MetadataID
+
+from autosync.services.service import Service
+from ..models.user import User
+from ..models.show import Show
+from ..models.movie import Movie
+from ..models.episode import Episode
+from ..models.watch_status import WatchStatus, Status
+
+logger = getLogger(__name__)
+
+
+class Simkl(Service):
+	def __init__(self) -> None:
+		self._api_key = os.environ.get("OIDC_SIMKL_CLIENTID")
+
+	@property
+	def name(self) -> str:
+		return "simkl"
+
+	@property
+	def enabled(self) -> bool:
+		return self._api_key is not None
+
+	def update(self, user: User, resource: Movie | Show | Episode, status: WatchStatus):
+		if "simkl" not in user.external_id or self._api_key is None:
+			return
+
+		watch_date = status.played_date or status.added_date
+
+		if isinstance(resource, Episode):
+			if status.status != Status.COMPLETED:
+				return
+
+			resp = requests.post(
+				"https://api.simkl.com/sync/history",
+				json={
+					"shows": [
+						{
+							"watched_at": watch_date.isoformat(),
+							"title": resource.show.name,
+							"year": resource.show.year,
+							"ids": self._map_external_ids(resource.show.external_id),
+							"seasons": [
+								{
+									"number": resource.season_number,
+									"episodes": [{"number": resource.episode_number}],
+								},
+								{
+									"number": 1,
+									"episodes": [{"number": resource.absolute_number}],
+								},
+							],
+						}
+					]
+				},
+				headers={
+					"Authorization": f"Bearer {user.external_id['simkl'].token.access_token}",
+					"simkl-api-key": self._api_key,
+				},
+			)
+			logger.info("Simkl response: %s %s", resp.status_code, resp.text)
+			return
+
+		category = "movies" if isinstance(resource, Movie) else "shows"
+
+		simkl_status = self._map_status(status.status)
+		if simkl_status is None:
+			return
+
+		resp = requests.post(
+			"https://api.simkl.com/sync/add-to-list",
+			json={
+				category: [
+					{
+						"to": simkl_status,
+						"watched_at": watch_date.isoformat()
+						if status.status == Status.COMPLETED
+						else None,
+						"title": resource.name,
+						"year": resource.year,
+						"ids": self._map_external_ids(resource.external_id),
+					}
+				]
+			},
+			headers={
+				"Authorization": f"Bearer {user.external_id['simkl'].token.access_token}",
+				"simkl-api-key": self._api_key,
+			},
+		)
+		logger.info("Simkl response: %s %s", resp.status_code, resp.text)
+
+	def _map_status(self, status: Status):
+		match status:
+			case Status.COMPLETED:
+				return "completed"
+			case Status.WATCHING:
+				return "watching"
+			case Status.COMPLETED:
+				return "completed"
+			case Status.PLANNED:
+				return "plantowatch"
+			case Status.DELETED:
+				# do not delete items on simkl, most of deleted status are for a rewatch.
+				return None
+			case _:
+				return None
+
+	def _map_external_ids(self, ids: dict[str, MetadataID]):
+		return {service: id.data_id for service, id in ids.items()} | {
+			"tmdb": int(ids["themoviedatabase"].data_id)
+			if "themoviedatabase" in ids
+			else None
+		}

autosync/pyproject.toml

@@ -0,0 +1,2 @@
+[tool.ruff.format]
+indent-style = "tab"

autosync/requirements.txt

@@ -0,0 +1,3 @@
+aio-pika
+msgspec
+requests

back/.config/dotnet-tools.json

@@ -0,0 +1,18 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-ef": {
+      "version": "8.0.6",
+      "commands": [
+        "dotnet-ef"
+      ]
+    },
+    "csharpier": {
+      "version": "0.28.2",
+      "commands": [
+        "dotnet-csharpier"
+      ]
+    }
+  }
+}

back/.dockerignore

@@ -0,0 +1,17 @@
+Dockerfile
+Dockerfile.dev
+Dockerfile.*
+.dockerignore
+.gitignore
+docker-compose.yml
+README.md
+**/build
+**/dist
+**/bin
+**/obj
+out
+docs
+tests
+front
+video
+nginx.conf.template

back/.editorconfig

@@ -0,0 +1,99 @@
+root = false
+
+[*]
+charset = utf-8
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+indent_style = tab
+indent_size = tab
+smart_tab = true
+
+[*.cs]
+csharp_prefer_braces = false
+dotnet_diagnostic.IDE0046.severity = none
+dotnet_diagnostic.IDE0055.severity = none
+dotnet_diagnostic.IDE0058.severity = none
+dotnet_diagnostic.IDE0130.severity = none
+
+# Convert to file-scoped namespace
+csharp_style_namespace_declarations = file_scoped:warning
+# Sort using and Import directives with System.* appearing first
+dotnet_sort_system_directives_first = true
+csharp_using_directive_placement = outside_namespace:warning
+# Avoid "this." if not necessary
+dotnet_style_qualification_for_field = false:suggestion
+dotnet_style_qualification_for_property = false:suggestion
+dotnet_style_qualification_for_method = false:suggestion
+dotnet_style_qualification_for_event = false:suggestion
+# Use language keywords instead of framework type names for type references
+dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
+dotnet_style_predefined_type_for_member_access = true:suggestion
+# Suggest more modern language features when available
+dotnet_style_object_initializer = true:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+dotnet_style_explicit_tuple_names = true:suggestion
+csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
+csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
+csharp_style_inlined_variable_declaration = true:suggestion
+csharp_style_conditional_delegate_call = true:suggestion
+dotnet_style_prefer_auto_properties = true
+dotnet_style_prefer_conditional_expression_over_assignment = true
+dotnet_style_prefer_conditional_expression_over_return = true
+# Disable strange throw.
+csharp_style_throw_expression = false:suggestion
+# Forbid "var" everywhere
+csharp_style_var_for_built_in_types = false:suggestion
+csharp_style_var_when_type_is_apparent = false:suggestion
+csharp_style_var_elsewhere = false:suggestion
+# Prefer method-like constructs to have a block body
+csharp_style_expression_bodied_methods = false:none
+csharp_style_expression_bodied_constructors = false:none
+csharp_style_expression_bodied_operators = false:none
+# Prefer property-like constructs to have an expression-body
+csharp_style_expression_bodied_properties = true:none
+csharp_style_expression_bodied_indexers = true:none
+csharp_style_expression_bodied_accessors = true:none
+# Newline settings
+csharp_new_line_before_open_brace = all
+csharp_new_line_before_else = true
+csharp_new_line_before_catch = true
+csharp_new_line_before_finally = true
+csharp_new_line_before_members_in_object_initializers = false
+csharp_new_line_before_members_in_anonymous_types = true
+# Indentation settings
+csharp_indent_case_contents = true
+csharp_indent_switch_labels = true
+# Modifiers
+dotnet_style_readonly_field = true:suggestion
+dotnet_style_require_accessibility_modifiers = for_non_interface_members:suggestion
+# Naming style
+dotnet_naming_symbols.privates.applicable_kinds = property,method,event,delegate
+dotnet_naming_symbols.privates.applicable_accessibilities = private
+dotnet_naming_style.underscore_pascal.capitalization = pascal_case
+dotnet_naming_style.underscore_pascal.required_prefix = _
+dotnet_naming_rule.privates_with_underscore.symbols = privates
+dotnet_naming_rule.privates_with_underscore.style = underscore_pascal
+dotnet_naming_rule.privates_with_underscore.severity = warning
+dotnet_diagnostic.IDE1006.severity = warning
+# ReSharper properties
+resharper_align_multiline_binary_expressions_chain = false
+resharper_csharp_empty_block_style = together_same_line
+resharper_indent_nested_foreach_stmt = true
+resharper_indent_nested_for_stmt = true
+resharper_indent_nested_while_stmt = true
+resharper_keep_existing_embedded_arrangement = false
+resharper_place_accessorholder_attribute_on_same_line = true
+resharper_place_simple_embedded_statement_on_same_line = false
+resharper_wrap_before_arrow_with_expressions = true
+resharper_xmldoc_attribute_indent = align_by_first_attribute
+resharper_xmldoc_indent_child_elements = RemoveIndent
+resharper_xmldoc_indent_text = RemoveIndent
+# Switch on enum
+dotnet_diagnostic.CS8509.severity=error # missing switch case for named enum value
+dotnet_diagnostic.CS8524.severity=none # missing switch case for unnamed enum value
+
+# Waiting for https://github.com/dotnet/roslyn/issues/44596 to get fixed.
+# file_header_template = Kyoo - A portable and vast media library solution.\nCopyright (c) Kyoo.\n\nSee AUTHORS.md and LICENSE file in the project root for full license information.\n\nKyoo is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\nany later version.\n\nKyoo is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with Kyoo. If not, see <https://www.gnu.org/licenses/>.

back/.gitignore

@@ -0,0 +1,352 @@
+out
+libtranscoder.so
+libtranscoder.dylib
+transcoder.dll
+kyoo_datadir
+
+video
+.env
+
+## Ignore Visual Studio temporary files, build results, and
+## files generated by popular Visual Studio add-ons.
+##
+## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
+
+# User-specific files
+*.rsuser
+*.suo
+*.user
+*.userosscache
+*.sln.docstates
+
+# User-specific files (MonoDevelop/Xamarin Studio)
+*.userprefs
+
+# Build results
+[Dd]ebug/
+[Dd]ebugPublic/
+[Rr]elease/
+[Rr]eleases/
+x64/
+x86/
+[Aa][Rr][Mm]/
+[Aa][Rr][Mm]64/
+bld/
+[Bb]in/
+[Oo]bj/
+[Ll]og/
+
+# Visual Studio 2015/2017 cache/options directory
+.vs/
+# Uncomment if you have tasks that create the project's static files in wwwroot
+#wwwroot/
+
+# Visual Studio 2017 auto generated files
+Generated\ Files/
+
+# MSTest test Results
+[Tt]est[Rr]esult*/
+[Bb]uild[Ll]og.*
+
+# NUNIT
+*.VisualState.xml
+TestResult.xml
+
+# Build Results of an ATL Project
+[Dd]ebugPS/
+[Rr]eleasePS/
+dlldata.c
+
+# Benchmark Results
+BenchmarkDotNet.Artifacts/
+
+# .NET Core
+project.lock.json
+project.fragment.lock.json
+artifacts/
+
+# StyleCop
+StyleCopReport.xml
+
+# Files built by Visual Studio
+*_i.c
+*_p.c
+*_h.h
+*.ilk
+*.meta
+*.obj
+*.iobj
+*.pch
+*.pdb
+*.ipdb
+*.pgc
+*.pgd
+*.sbr
+*.tlb
+*.tli
+*.tlh
+*.tmp
+*.tmp_proj
+*_wpftmp.csproj
+*.log
+*.vspscc
+*.vssscc
+.builds
+*.pidb
+*.svclog
+*.scc
+
+# Chutzpah Test files
+_Chutzpah*
+
+# Visual C++ cache files
+ipch/
+*.aps
+*.ncb
+*.opendb
+*.opensdf
+*.sdf
+*.cachefile
+*.VC.db
+*.VC.VC.opendb
+
+# Visual Studio profiler
+*.psess
+*.vsp
+*.vspx
+*.sap
+
+# Visual Studio Trace Files
+*.e2e
+
+# TFS 2012 Local Workspace
+$tf/
+
+# Guidance Automation Toolkit
+*.gpState
+
+# ReSharper is a .NET coding add-in
+_ReSharper*/
+*.[Rr]e[Ss]harper
+*.DotSettings.user
+
+# JustCode is a .NET coding add-in
+.JustCode
+
+# TeamCity is a build add-in
+_TeamCity*
+
+# DotCover is a Code Coverage Tool
+*.dotCover
+
+# AxoCover is a Code Coverage Tool
+.axoCover/*
+!.axoCover/settings.json
+
+# Visual Studio code coverage results
+*.coverage
+*.coveragexml
+
+# NCrunch
+_NCrunch_*
+.*crunch*.local.xml
+nCrunchTemp_*
+
+# MightyMoose
+*.mm.*
+AutoTest.Net/
+
+# Web workbench (sass)
+.sass-cache/
+
+# Installshield output folder
+[Ee]xpress/
+
+# DocProject is a documentation generator add-in
+DocProject/buildhelp/
+DocProject/Help/*.HxT
+DocProject/Help/*.HxC
+DocProject/Help/*.hhc
+DocProject/Help/*.hhk
+DocProject/Help/*.hhp
+DocProject/Help/Html2
+DocProject/Help/html
+
+# Click-Once directory
+publish/
+
+# Publish Web Output
+*.[Pp]ublish.xml
+*.azurePubxml
+# Note: Comment the next line if you want to checkin your web deploy settings,
+# but database connection strings (with potential passwords) will be unencrypted
+*.pubxml
+*.publishproj
+
+# Microsoft Azure Web App publish settings. Comment the next line if you want to
+# checkin your Azure Web App publish settings, but sensitive information contained
+# in these scripts will be unencrypted
+PublishScripts/
+
+# NuGet Packages
+*.nupkg
+# The packages folder can be ignored because of Package Restore
+**/[Pp]ackages/*
+# except build/, which is used as an MSBuild target.
+!**/[Pp]ackages/build/
+# Uncomment if necessary however generally it will be regenerated when needed
+#!**/[Pp]ackages/repositories.config
+# NuGet v3's project.json files produces more ignorable files
+*.nuget.props
+*.nuget.targets
+
+# Microsoft Azure Build Output
+csx/
+*.build.csdef
+
+# Microsoft Azure Emulator
+ecf/
+rcf/
+
+# Windows Store app package directories and files
+AppPackages/
+BundleArtifacts/
+Package.StoreAssociation.xml
+_pkginfo.txt
+*.appx
+
+# Visual Studio cache files
+# files ending in .cache can be ignored
+*.[Cc]ache
+# but keep track of directories ending in .cache
+!?*.[Cc]ache/
+
+# Others
+ClientBin/
+~$*
+*~
+*.dbmdl
+*.dbproj.schemaview
+*.jfm
+*.pfx
+*.publishsettings
+orleans.codegen.cs
+
+# Including strong name files can present a security risk
+# (https://github.com/github/gitignore/pull/2483#issue-259490424)
+#*.snk
+
+# Since there are multiple workflows, uncomment next line to ignore bower_components
+# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
+#bower_components/
+
+# RIA/Silverlight projects
+Generated_Code/
+
+# Backup & report files from converting an old project file
+# to a newer Visual Studio version. Backup files are not needed,
+# because we have git ;-)
+_UpgradeReport_Files/
+Backup*/
+UpgradeLog*.XML
+UpgradeLog*.htm
+ServiceFabricBackup/
+*.rptproj.bak
+
+# SQL Server files
+*.mdf
+*.ldf
+*.ndf
+
+# Business Intelligence projects
+*.rdl.data
+*.bim.layout
+*.bim_*.settings
+*.rptproj.rsuser
+*- Backup*.rdl
+
+# Microsoft Fakes
+FakesAssemblies/
+
+# GhostDoc plugin setting file
+*.GhostDoc.xml
+
+# Node.js Tools for Visual Studio
+.ntvs_analysis.dat
+node_modules/
+
+# Visual Studio 6 build log
+*.plg
+
+# Visual Studio 6 workspace options file
+*.opt
+
+# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
+*.vbw
+
+# Visual Studio LightSwitch build output
+**/*.HTMLClient/GeneratedArtifacts
+**/*.DesktopClient/GeneratedArtifacts
+**/*.DesktopClient/ModelManifest.xml
+**/*.Server/GeneratedArtifacts
+**/*.Server/ModelManifest.xml
+_Pvt_Extensions
+
+# Paket dependency manager
+.paket/paket.exe
+paket-files/
+
+# FAKE - F# Make
+.fake/
+
+# JetBrains Rider
+.idea/
+*.sln.iml
+
+# CodeRush personal settings
+.cr/personal
+
+# Python Tools for Visual Studio (PTVS)
+__pycache__/
+*.pyc
+
+# Cake - Uncomment if you are using it
+# tools/**
+# !tools/packages.config
+
+# Tabs Studio
+*.tss
+
+# Telerik's JustMock configuration file
+*.jmconfig
+
+# BizTalk build output
+*.btp.cs
+*.btm.cs
+*.odx.cs
+*.xsd.cs
+
+# OpenCover UI analysis results
+OpenCover/
+
+# Azure Stream Analytics local run output
+ASALocalRun/
+
+# MSBuild Binary and Structured Log
+*.binlog
+
+# NVidia Nsight GPU debugger configuration file
+*.nvuser
+
+# MFractors (Xamarin productivity tool) working folder
+.mfractor/
+
+# Local History for Visual Studio
+.localhistory/
+
+# BeatPulse healthcheck temp database
+healthchecksdb
+/Kyoo/TheTVDB-Credentials.json
+
+.vscode
+.netcoredbg_hist

back/Dockerfile

@@ -0,0 +1,29 @@
+FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:8.0 as builder
+ARG TARGETARCH
+WORKDIR /kyoo
+
+COPY Kyoo.sln ./Kyoo.sln
+COPY nuget.config ./nuget.config
+COPY src/Directory.Build.props src/Directory.Build.props
+COPY src/Kyoo.Authentication/Kyoo.Authentication.csproj src/Kyoo.Authentication/Kyoo.Authentication.csproj
+COPY src/Kyoo.Abstractions/Kyoo.Abstractions.csproj src/Kyoo.Abstractions/Kyoo.Abstractions.csproj
+COPY src/Kyoo.Core/Kyoo.Core.csproj src/Kyoo.Core/Kyoo.Core.csproj
+COPY src/Kyoo.Postgresql/Kyoo.Postgresql.csproj src/Kyoo.Postgresql/Kyoo.Postgresql.csproj
+COPY src/Kyoo.Meilisearch/Kyoo.Meilisearch.csproj src/Kyoo.Meilisearch/Kyoo.Meilisearch.csproj
+COPY src/Kyoo.RabbitMq/Kyoo.RabbitMq.csproj src/Kyoo.RabbitMq/Kyoo.RabbitMq.csproj
+COPY src/Kyoo.Swagger/Kyoo.Swagger.csproj src/Kyoo.Swagger/Kyoo.Swagger.csproj
+RUN dotnet restore -a $TARGETARCH
+
+COPY . .
+ARG VERSION
+RUN dotnet publish -a $TARGETARCH --no-restore -c Release -o /app "-p:Version=${VERSION:-"0.0.0-dev"}" src/Kyoo.Core
+
+FROM mcr.microsoft.com/dotnet/aspnet:8.0
+RUN apt-get update && apt-get install -y curl
+COPY --from=builder /app /app
+
+WORKDIR /app
+EXPOSE 5000
+# The back can take a long time to start if meilisearch is initializing
+HEALTHCHECK --interval=5s --retries=15 CMD curl --fail http://localhost:5000/health || exit
+ENTRYPOINT ["/app/kyoo"]

back/Dockerfile.dev

@@ -0,0 +1,22 @@
+FROM mcr.microsoft.com/dotnet/sdk:8.0
+RUN apt-get update && apt-get install -y curl
+WORKDIR /app
+
+COPY Kyoo.sln ./Kyoo.sln
+COPY nuget.config ./nuget.config
+COPY src/Directory.Build.props src/Directory.Build.props
+COPY src/Kyoo.Authentication/Kyoo.Authentication.csproj src/Kyoo.Authentication/Kyoo.Authentication.csproj
+COPY src/Kyoo.Abstractions/Kyoo.Abstractions.csproj src/Kyoo.Abstractions/Kyoo.Abstractions.csproj
+COPY src/Kyoo.Core/Kyoo.Core.csproj src/Kyoo.Core/Kyoo.Core.csproj
+COPY src/Kyoo.Postgresql/Kyoo.Postgresql.csproj src/Kyoo.Postgresql/Kyoo.Postgresql.csproj
+COPY src/Kyoo.Meilisearch/Kyoo.Meilisearch.csproj src/Kyoo.Meilisearch/Kyoo.Meilisearch.csproj
+COPY src/Kyoo.RabbitMq/Kyoo.RabbitMq.csproj src/Kyoo.RabbitMq/Kyoo.RabbitMq.csproj
+COPY src/Kyoo.Swagger/Kyoo.Swagger.csproj src/Kyoo.Swagger/Kyoo.Swagger.csproj
+RUN dotnet restore
+
+WORKDIR /app
+EXPOSE 5000
+ENV DOTNET_USE_POLLING_FILE_WATCHER 1
+# HEALTHCHECK --interval=5s CMD curl --fail http://localhost:5000/health || exit
+HEALTHCHECK CMD true
+ENTRYPOINT ["dotnet", "watch", "--non-interactive", "run", "--no-restore", "--project", "/app/src/Kyoo.Core"]

back/Dockerfile.migrations

@@ -0,0 +1,30 @@
+FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:8.0 as builder
+ARG TARGETARCH
+WORKDIR /kyoo
+
+COPY .config/dotnet-tools.json .config/dotnet-tools.json
+RUN dotnet tool restore
+
+COPY Kyoo.sln ./Kyoo.sln
+COPY nuget.config ./nuget.config
+COPY src/Directory.Build.props src/Directory.Build.props
+COPY src/Kyoo.Authentication/Kyoo.Authentication.csproj src/Kyoo.Authentication/Kyoo.Authentication.csproj
+COPY src/Kyoo.Abstractions/Kyoo.Abstractions.csproj src/Kyoo.Abstractions/Kyoo.Abstractions.csproj
+COPY src/Kyoo.Core/Kyoo.Core.csproj src/Kyoo.Core/Kyoo.Core.csproj
+COPY src/Kyoo.Postgresql/Kyoo.Postgresql.csproj src/Kyoo.Postgresql/Kyoo.Postgresql.csproj
+COPY src/Kyoo.Meilisearch/Kyoo.Meilisearch.csproj src/Kyoo.Meilisearch/Kyoo.Meilisearch.csproj
+COPY src/Kyoo.RabbitMq/Kyoo.RabbitMq.csproj src/Kyoo.RabbitMq/Kyoo.RabbitMq.csproj
+COPY src/Kyoo.Swagger/Kyoo.Swagger.csproj src/Kyoo.Swagger/Kyoo.Swagger.csproj
+RUN dotnet restore -a $TARGETARCH
+
+COPY . .
+RUN dotnet build
+RUN dotnet ef migrations bundle \
+	--msbuildprojectextensionspath out/obj/Kyoo.Postgresql \
+	--no-build --self-contained -r linux-${TARGETARCH} -f \
+	-o /app/migrate -p src/Kyoo.Postgresql --verbose
+
+FROM mcr.microsoft.com/dotnet/runtime-deps:8.0
+COPY --from=builder /app/migrate /app/migrate
+
+ENTRYPOINT ["/app/migrate"]

back/Kyoo.ruleset

@@ -2,6 +2,7 @@
 	<Rules AnalyzerId="StyleCop.Analyzers" RuleNamespace="StyleCop.CSharp.MaintainabilityRules">
 		<Rule Id="SA1413" Action="None" />        <!-- UseTrailingCommasInMultiLineInitializers -->
 		<Rule Id="SA1414" Action="None" />        <!-- UseTrailingCommasInMultiLineInitializers -->
+		<Rule Id="SA1114" Action="None" />        <!-- UseTrailingCommasInMultiLineInitializers -->
 	</Rules>
 	<Rules AnalyzerId="StyleCop.Analyzers" RuleNamespace="StyleCop.CSharp.OrderingRules">
 		<Rule Id="SA1201" Action="None" />        <!-- ElementsMustAppearInTheCorrectOrder -->
@@ -27,18 +28,20 @@
 		<Rule Id="SA1027" Action="None"/>         <!-- UseTabsCorrectly (smarts tabs are broken). TODO find a way to enable smart tabs -->
 	</Rules>
 	<Rules AnalyzerId="StyleCop.Analyzers" RuleNamespace="StyleCop.CSharp.LayoutRules">
+		<Rule Id="SA1402" Action="None"/>         <!-- SingleClassPerFile -->
+		<Rule Id="SA1649" Action="None"/>         <!-- Class name must be filename -->
 		<Rule Id="SA1503" Action="None"/>         <!-- BracesMustNotBeOmitted -->
+		<Rule Id="SA1512" Action="None"/>         <!-- Let me comment -->
 		<Rule Id="SA1520" Action="None"/>         <!-- UseBracesConsistently -->
 		<Rule Id="SA1515" Action="None"/>         <!-- SingleLineCommentMustBePrecededByBlankLine -->
 		<Rule Id="SA1513" Action="None"/>         <!-- ClosingBraceMustBeFollowedByBlankLine -->
 	</Rules>
 	<Rules AnalyzerId="StyleCop.Analyzers" RuleNamespace="StyleCop.CSharp.DocumentationRules">
+		<Rule Id="SA1600" Action="None" />        <!-- Elements Shuld be Documented -->
+		<Rule Id="SA1602" Action="None" />        <!-- Enums should be documented -->
 		<Rule Id="SA1642" Action="None" />        <!-- ConstructorSummaryDocumentationMustBeginWithStandardText -->
 		<Rule Id="SA1643" Action="None" />        <!-- DestructorSummaryDocumentationMustBeginWithStandardText -->
 		<Rule Id="SA1623" Action="None" />        <!-- PropertySummaryDocumentationMustMatchAccessors -->
-
-
-
-		<Rule Id="SA1629" Action="None" />        <!-- DocumentationTextMustEndWithAPeriod TODO remove this, this is only temporary -->
+		<Rule Id="SA1629" Action="None" />        <!-- DocumentationTextMustEndWithAPeriod -->
 	</Rules>
 </RuleSet>

back/Kyoo.sln

@@ -0,0 +1,64 @@
+Microsoft Visual Studio Solution File, Format Version 12.00
+#
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Kyoo.Core", "src\Kyoo.Core\Kyoo.Core.csproj", "{0F8275B6-C7DD-42DF-A168-755C81B1C329}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Abstractions", "src\Kyoo.Abstractions\Kyoo.Abstractions.csproj", "{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Postgresql", "src\Kyoo.Postgresql\Kyoo.Postgresql.csproj", "{3213C96D-0BF3-460B-A8B5-B9977229408A}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Authentication", "src\Kyoo.Authentication\Kyoo.Authentication.csproj", "{7A841335-6523-47DB-9717-80AA7BD943FD}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Swagger", "src\Kyoo.Swagger\Kyoo.Swagger.csproj", "{7D1A7596-73F6-4D35-842E-A5AD9C620596}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.Meilisearch", "src\Kyoo.Meilisearch\Kyoo.Meilisearch.csproj", "{F8E6018A-FD51-40EB-99FF-A26BA59F2762}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kyoo.RabbitMq", "src\Kyoo.RabbitMq\Kyoo.RabbitMq.csproj", "{B97AD4A8-E6E6-41CD-87DF-5F1326FD7198}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{0F8275B6-C7DD-42DF-A168-755C81B1C329}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{0F8275B6-C7DD-42DF-A168-755C81B1C329}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{0F8275B6-C7DD-42DF-A168-755C81B1C329}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{0F8275B6-C7DD-42DF-A168-755C81B1C329}.Release|Any CPU.Build.0 = Release|Any CPU
+		{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{BAB2CAE1-AC28-4509-AA3E-8DC75BD59220}.Release|Any CPU.Build.0 = Release|Any CPU
+		{3213C96D-0BF3-460B-A8B5-B9977229408A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{3213C96D-0BF3-460B-A8B5-B9977229408A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{3213C96D-0BF3-460B-A8B5-B9977229408A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{3213C96D-0BF3-460B-A8B5-B9977229408A}.Release|Any CPU.Build.0 = Release|Any CPU
+		{7A841335-6523-47DB-9717-80AA7BD943FD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7A841335-6523-47DB-9717-80AA7BD943FD}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7A841335-6523-47DB-9717-80AA7BD943FD}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7A841335-6523-47DB-9717-80AA7BD943FD}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6515380E-1E57-42DA-B6E3-E1C8A848818A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6515380E-1E57-42DA-B6E3-E1C8A848818A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6515380E-1E57-42DA-B6E3-E1C8A848818A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6515380E-1E57-42DA-B6E3-E1C8A848818A}.Release|Any CPU.Build.0 = Release|Any CPU
+		{2374D500-1ADB-4752-85DB-8BB0DDF5A8E8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{2374D500-1ADB-4752-85DB-8BB0DDF5A8E8}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{2374D500-1ADB-4752-85DB-8BB0DDF5A8E8}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{2374D500-1ADB-4752-85DB-8BB0DDF5A8E8}.Release|Any CPU.Build.0 = Release|Any CPU
+		{4FF1ECD9-6EEF-4440-B037-A661D78FB04D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{4FF1ECD9-6EEF-4440-B037-A661D78FB04D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4FF1ECD9-6EEF-4440-B037-A661D78FB04D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{4FF1ECD9-6EEF-4440-B037-A661D78FB04D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{7D1A7596-73F6-4D35-842E-A5AD9C620596}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7D1A7596-73F6-4D35-842E-A5AD9C620596}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7D1A7596-73F6-4D35-842E-A5AD9C620596}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7D1A7596-73F6-4D35-842E-A5AD9C620596}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F8E6018A-FD51-40EB-99FF-A26BA59F2762}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F8E6018A-FD51-40EB-99FF-A26BA59F2762}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F8E6018A-FD51-40EB-99FF-A26BA59F2762}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F8E6018A-FD51-40EB-99FF-A26BA59F2762}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B97AD4A8-E6E6-41CD-87DF-5F1326FD7198}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B97AD4A8-E6E6-41CD-87DF-5F1326FD7198}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B97AD4A8-E6E6-41CD-87DF-5F1326FD7198}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B97AD4A8-E6E6-41CD-87DF-5F1326FD7198}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+EndGlobal

back/ef.rsp

@@ -0,0 +1,4 @@
+--project
+src/Kyoo.Postgresql
+--msbuildprojectextensionspath
+out/obj/Kyoo.Postgresql

back/nuget.config

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+	<packageSources>
+		<clear/>
+		<add key="feedz" value="https://f.feedz.io/zoriya/entityframeworkcore-projectables/nuget/index.json"/>
+		<add key="nuget" value="https://api.nuget.org/v3/index.json"/>
+	</packageSources>
+	<disabledPackageSources>
+		<clear/>
+	</disabledPackageSources>
+	<fallbackPackageFolders>
+		<clear/>
+	</fallbackPackageFolders>
+</configuration>

back/src/Directory.Build.props

@@ -0,0 +1,47 @@
+<Project>
+	<PropertyGroup>
+		<TargetFramework>net8.0</TargetFramework>
+		<LangVersion>default</LangVersion>
+		<Nullable>enable</Nullable>
+		<Company>Kyoo</Company>
+		<Authors>Kyoo</Authors>
+		<Copyright>Copyright (c) Kyoo</Copyright>
+		<PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
+		<PackageLicenseExpression>GPL-3.0-or-later</PackageLicenseExpression>
+		<RequireLicenseAcceptance>true</RequireLicenseAcceptance>
+
+		<RepositoryUrl>https://github.com/zoriya/Kyoo</RepositoryUrl>
+		<RepositoryType>git</RepositoryType>
+		<PublishRepositoryUrl>true</PublishRepositoryUrl>
+		<PackageProjectUrl>https://github.com/zoriya/Kyoo</PackageProjectUrl>
+
+		<PackageVersion>1.0.0</PackageVersion>
+		<IncludeSymbols>true</IncludeSymbols>
+		<SymbolPackageFormat>snupkg</SymbolPackageFormat>
+
+		<ApplicationIcon>$(MSBuildThisFileDirectory)../icon.ico</ApplicationIcon>
+
+		<GenerateDocumentationFile>true</GenerateDocumentationFile>
+	</PropertyGroup>
+
+	<PropertyGroup>
+		<CheckCodingStyle Condition="$(CheckCodingStyle) == ''">true</CheckCodingStyle>
+	</PropertyGroup>
+
+	<PropertyGroup>
+		<BaseIntermediateOutputPath>$(MsBuildThisFileDirectory)/../out/obj/$(MSBuildProjectName)</BaseIntermediateOutputPath>
+		<BaseOutputPath>$(MsBuildThisFileDirectory)/../out/bin/$(MSBuildProjectName)</BaseOutputPath>
+	</PropertyGroup>
+
+	<ItemGroup Condition="$(CheckCodingStyle) == true">
+		<None Include="$(MSBuildThisFileDirectory)../.editorconfig" Link=".editorconfig" Visible="false" />
+	</ItemGroup>
+
+	<PropertyGroup Condition="$(CheckCodingStyle) == true">
+		<CodeAnalysisRuleSet>$(MSBuildThisFileDirectory)../Kyoo.ruleset</CodeAnalysisRuleSet>
+		<NoWarn>1591;1305;8618;SYSLIB1045;CS1573</NoWarn>
+		<!-- <AnalysisMode>All</AnalysisMode> -->
+	</PropertyGroup>
+
+	<!-- vim: ft=xml -->
+</Project>

back/src/Kyoo.Abstractions/Controllers/IIssueRepository.cs

@@ -0,0 +1,35 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Kyoo.Abstractions.Models;
+using Kyoo.Abstractions.Models.Utils;
+
+namespace Kyoo.Abstractions.Controllers;
+
+public interface IIssueRepository
+{
+	Task<ICollection<Issue>> GetAll(Filter<Issue>? filter = default);
+
+	Task<int> GetCount(Filter<Issue>? filter = default);
+
+	Task<Issue> Upsert(Issue issue);
+
+	Task DeleteAll(Filter<Issue>? filter = default);
+}

back/src/Kyoo.Abstractions/Controllers/ILibraryManager.cs

@@ -0,0 +1,80 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using Kyoo.Abstractions.Models;
+
+namespace Kyoo.Abstractions.Controllers;
+
+/// <summary>
+/// An interface to interact with the database. Every repository is mapped through here.
+/// </summary>
+public interface ILibraryManager
+{
+	IRepository<T> Repository<T>()
+		where T : IResource, IQuery;
+
+	/// <summary>
+	/// The repository that handle libraries items (a wrapper around shows and collections).
+	/// </summary>
+	IRepository<ILibraryItem> LibraryItems { get; }
+
+	/// <summary>
+	/// The repository that handle new items.
+	/// </summary>
+	IRepository<INews> News { get; }
+
+	/// <summary>
+	/// The repository that handle watched items.
+	/// </summary>
+	IWatchStatusRepository WatchStatus { get; }
+
+	/// <summary>
+	/// The repository that handle collections.
+	/// </summary>
+	IRepository<Collection> Collections { get; }
+
+	/// <summary>
+	/// The repository that handle shows.
+	/// </summary>
+	IRepository<Movie> Movies { get; }
+
+	/// <summary>
+	/// The repository that handle shows.
+	/// </summary>
+	IRepository<Show> Shows { get; }
+
+	/// <summary>
+	/// The repository that handle seasons.
+	/// </summary>
+	IRepository<Season> Seasons { get; }
+
+	/// <summary>
+	/// The repository that handle episodes.
+	/// </summary>
+	IRepository<Episode> Episodes { get; }
+
+	/// <summary>
+	/// The repository that handle studios.
+	/// </summary>
+	IRepository<Studio> Studios { get; }
+
+	/// <summary>
+	/// The repository that handle users.
+	/// </summary>
+	IRepository<User> Users { get; }
+}

back/src/Kyoo.Abstractions/Controllers/IPermissionValidator.cs

@@ -0,0 +1,46 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using Kyoo.Abstractions.Models.Permissions;
+using Microsoft.AspNetCore.Mvc.Filters;
+
+namespace Kyoo.Abstractions.Controllers;
+
+/// <summary>
+/// A service to validate permissions.
+/// </summary>
+public interface IPermissionValidator
+{
+	/// <summary>
+	/// Create an IAuthorizationFilter that will be used to validate permissions.
+	/// This can registered with any lifetime.
+	/// </summary>
+	/// <param name="attribute">The permission attribute to validate.</param>
+	/// <returns>An authorization filter used to validate the permission.</returns>
+	IFilterMetadata Create(PermissionAttribute attribute);
+
+	/// <summary>
+	/// Create an IAuthorizationFilter that will be used to validate permissions.
+	/// This can registered with any lifetime.
+	/// </summary>
+	/// <param name="attribute">
+	/// A partial attribute to validate. See <see cref="PartialPermissionAttribute"/>.
+	/// </param>
+	/// <returns>An authorization filter used to validate the permission.</returns>
+	IFilterMetadata Create(PartialPermissionAttribute attribute);
+}

back/src/Kyoo.Abstractions/Controllers/IRepository.cs

@@ -0,0 +1,267 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Kyoo.Abstractions.Models;
+using Kyoo.Abstractions.Models.Exceptions;
+using Kyoo.Abstractions.Models.Utils;
+
+namespace Kyoo.Abstractions.Controllers;
+
+/// <summary>
+/// A common repository for every resources.
+/// </summary>
+/// <typeparam name="T">The resource's type that this repository manage.</typeparam>
+public interface IRepository<T> : IBaseRepository
+	where T : IResource, IQuery
+{
+	/// <summary>
+	/// The event handler type for all events of this repository.
+	/// </summary>
+	/// <param name="resource">The resource created/modified/deleted</param>
+	/// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+	public delegate Task ResourceEventHandler(T resource);
+
+	/// <summary>
+	/// Get a resource from it's ID.
+	/// </summary>
+	/// <param name="id">The id of the resource</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <exception cref="ItemNotFoundException">If the item could not be found.</exception>
+	/// <returns>The resource found</returns>
+	Task<T> Get(Guid id, Include<T>? include = default);
+
+	/// <summary>
+	/// Get a resource from it's slug.
+	/// </summary>
+	/// <param name="slug">The slug of the resource</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <exception cref="ItemNotFoundException">If the item could not be found.</exception>
+	/// <returns>The resource found</returns>
+	Task<T> Get(string slug, Include<T>? include = default);
+
+	/// <summary>
+	/// Get the first resource that match the predicate.
+	/// </summary>
+	/// <param name="filter">A predicate to filter the resource.</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <param name="sortBy">A custom sort method to handle cases where multiples items match the filters.</param>
+	/// <param name="reverse">Reverse the sort.</param>
+	/// <param name="afterId">Select the first element after this id if it was in a list.</param>
+	/// <exception cref="ItemNotFoundException">If the item could not be found.</exception>
+	/// <returns>The resource found</returns>
+	Task<T> Get(
+		Filter<T> filter,
+		Include<T>? include = default,
+		Sort<T>? sortBy = default,
+		bool reverse = false,
+		Guid? afterId = default
+	);
+
+	/// <summary>
+	/// Get a resource from it's ID or null if it is not found.
+	/// </summary>
+	/// <param name="id">The id of the resource</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>The resource found</returns>
+	Task<T?> GetOrDefault(Guid id, Include<T>? include = default);
+
+	/// <summary>
+	/// Get a resource from it's slug or null if it is not found.
+	/// </summary>
+	/// <param name="slug">The slug of the resource</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>The resource found</returns>
+	Task<T?> GetOrDefault(string slug, Include<T>? include = default);
+
+	/// <summary>
+	/// Get the first resource that match the predicate or null if it is not found.
+	/// </summary>
+	/// <param name="filter">A predicate to filter the resource.</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <param name="sortBy">A custom sort method to handle cases where multiples items match the filters.</param>
+	/// <param name="reverse">Reverse the sort.</param>
+	/// <param name="afterId">Select the first element after this id if it was in a list.</param>
+	/// <returns>The resource found</returns>
+	Task<T?> GetOrDefault(
+		Filter<T>? filter,
+		Include<T>? include = default,
+		Sort<T>? sortBy = default,
+		bool reverse = false,
+		Guid? afterId = default
+	);
+
+	/// <summary>
+	/// Search for resources with the database.
+	/// </summary>
+	/// <param name="query">The query string.</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>A list of resources found</returns>
+	Task<ICollection<T>> Search(string query, Include<T>? include = default);
+
+	/// <summary>
+	/// Get every resources that match all filters
+	/// </summary>
+	/// <param name="filter">A filter predicate</param>
+	/// <param name="sort">Sort information about the query (sort by, sort order)</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <param name="limit">How pagination should be done (where to start and how many to return)</param>
+	/// <returns>A list of resources that match every filters</returns>
+	Task<ICollection<T>> GetAll(
+		Filter<T>? filter = null,
+		Sort<T>? sort = default,
+		Include<T>? include = default,
+		Pagination? limit = default
+	);
+
+	/// <summary>
+	/// Get the number of resources that match the filter's predicate.
+	/// </summary>
+	/// <param name="filter">A filter predicate</param>
+	/// <returns>How many resources matched that filter</returns>
+	Task<int> GetCount(Filter<T>? filter = null);
+
+	/// <summary>
+	/// Map a list of ids to a list of items (keep the order).
+	/// </summary>
+	/// <param name="ids">The list of items id.</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>A list of resources mapped from ids.</returns>
+	Task<ICollection<T>> FromIds(IList<Guid> ids, Include<T>? include = default);
+
+	/// <summary>
+	/// Create a new resource.
+	/// </summary>
+	/// <param name="obj">The item to register</param>
+	/// <returns>The resource registers and completed by database's information (related items and so on)</returns>
+	Task<T> Create(T obj);
+
+	/// <summary>
+	/// Create a new resource if it does not exist already. If it does, the existing value is returned instead.
+	/// </summary>
+	/// <param name="obj">The object to create</param>
+	/// <returns>The newly created item or the existing value if it existed.</returns>
+	Task<T> CreateIfNotExists(T obj);
+
+	/// <summary>
+	/// Called when a resource has been created.
+	/// </summary>
+	static event ResourceEventHandler OnCreated;
+
+	/// <summary>
+	/// Callback that should be called after a resource has been created.
+	/// </summary>
+	/// <param name="obj">The resource newly created.</param>
+	/// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+	protected static Task OnResourceCreated(T obj) => OnCreated?.Invoke(obj) ?? Task.CompletedTask;
+
+	/// <summary>
+	/// Edit a resource and replace every property
+	/// </summary>
+	/// <param name="edited">The resource to edit, it's ID can't change.</param>
+	/// <exception cref="ItemNotFoundException">If the item is not found</exception>
+	/// <returns>The resource edited and completed by database's information (related items and so on)</returns>
+	Task<T> Edit(T edited);
+
+	/// <summary>
+	/// Edit only specific properties of a resource
+	/// </summary>
+	/// <param name="id">The id of the resource to edit</param>
+	/// <param name="patch">
+	/// A method that will be called when you need to update every properties that you want to
+	/// persist.
+	/// </param>
+	/// <exception cref="ItemNotFoundException">If the item is not found</exception>
+	/// <returns>The resource edited and completed by database's information (related items and so on)</returns>
+	Task<T> Patch(Guid id, Func<T, T> patch);
+
+	/// <summary>
+	/// Called when a resource has been edited.
+	/// </summary>
+	static event ResourceEventHandler OnEdited;
+
+	/// <summary>
+	/// Callback that should be called after a resource has been edited.
+	/// </summary>
+	/// <param name="obj">The resource newly edited.</param>
+	/// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+	protected static Task OnResourceEdited(T obj) => OnEdited?.Invoke(obj) ?? Task.CompletedTask;
+
+	/// <summary>
+	/// Delete a resource by it's ID
+	/// </summary>
+	/// <param name="id">The ID of the resource</param>
+	/// <exception cref="ItemNotFoundException">If the item is not found</exception>
+	/// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+	Task Delete(Guid id);
+
+	/// <summary>
+	/// Delete a resource by it's slug
+	/// </summary>
+	/// <param name="slug">The slug of the resource</param>
+	/// <exception cref="ItemNotFoundException">If the item is not found</exception>
+	/// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+	Task Delete(string slug);
+
+	/// <summary>
+	/// Delete a resource
+	/// </summary>
+	/// <param name="obj">The resource to delete</param>
+	/// <exception cref="ItemNotFoundException">If the item is not found</exception>
+	/// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+	Task Delete(T obj);
+
+	/// <summary>
+	/// Delete all resources that match the predicate.
+	/// </summary>
+	/// <param name="filter">A predicate to filter resources to delete. Every resource that match this will be deleted.</param>
+	/// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+	Task DeleteAll(Filter<T> filter);
+
+	/// <summary>
+	/// Called when a resource has been edited.
+	/// </summary>
+	static event ResourceEventHandler OnDeleted;
+
+	/// <summary>
+	/// Callback that should be called after a resource has been deleted.
+	/// </summary>
+	/// <param name="obj">The resource newly deleted.</param>
+	/// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+	protected static Task OnResourceDeleted(T obj) => OnDeleted?.Invoke(obj) ?? Task.CompletedTask;
+}
+
+/// <summary>
+/// A base class for repositories. Every service implementing this will be handled by the <see cref="ILibraryManager"/>.
+/// </summary>
+public interface IBaseRepository
+{
+	/// <summary>
+	/// The type for witch this repository is responsible or null if non applicable.
+	/// </summary>
+	Type RepositoryType { get; }
+}
+
+public interface IUserRepository : IRepository<User>
+{
+	Task<User?> GetByExternalId(string provider, string id);
+	Task<User> AddExternalToken(Guid userId, string provider, ExternalToken token);
+	Task<User> DeleteExternalToken(Guid userId, string provider);
+}

back/src/Kyoo.Abstractions/Controllers/IScanner.cs

@@ -1,4 +1,4 @@
-// Kyoo - A portable and vast media library solution.
+// Kyoo - A portable and vast media library solution.
 // Copyright (c) Kyoo.
 //
 // See AUTHORS.md and LICENSE file in the project root for full license information.
@@ -17,12 +17,12 @@
 // along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
 
 using System;
+using System.Threading.Tasks;
 
-namespace Kyoo.Abstractions.Models.Attributes
+namespace Kyoo.Abstractions.Controllers;
+
+public interface IScanner
 {
-	/// <summary>
-	/// Remove an property from the serialization pipeline. It will simply be skipped.
-	/// </summary>
-	[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)]
-	public class SerializeIgnoreAttribute : Attribute { }
+	Task SendRescanRequest();
+	Task SendRefreshRequest(string kind, Guid id);
 }

back/src/Kyoo.Abstractions/Controllers/ISearchManager.cs

@@ -0,0 +1,119 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System.Threading.Tasks;
+using Kyoo.Abstractions.Models;
+using Kyoo.Abstractions.Models.Utils;
+
+namespace Kyoo.Abstractions.Controllers;
+
+/// <summary>
+/// The service to search items.
+/// </summary>
+public interface ISearchManager
+{
+	/// <summary>
+	/// Search for items.
+	/// </summary>
+	/// <param name="query">The seach query.</param>
+	/// <param name="sortBy">Sort information about the query (sort by, sort order)</param>
+	/// <param name="pagination">How pagination should be done (where to start and how many to return)</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>A list of resources that match every filters</returns>
+	public Task<SearchPage<ILibraryItem>.SearchResult> SearchItems(
+		string? query,
+		Sort<ILibraryItem> sortBy,
+		SearchPagination pagination,
+		Include<ILibraryItem>? include = default
+	);
+
+	/// <summary>
+	/// Search for movies.
+	/// </summary>
+	/// <param name="query">The seach query.</param>
+	/// <param name="sortBy">Sort information about the query (sort by, sort order)</param>
+	/// <param name="pagination">How pagination should be done (where to start and how many to return)</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>A list of resources that match every filters</returns>
+	public Task<SearchPage<Movie>.SearchResult> SearchMovies(
+		string? query,
+		Sort<Movie> sortBy,
+		SearchPagination pagination,
+		Include<Movie>? include = default
+	);
+
+	/// <summary>
+	/// Search for shows.
+	/// </summary>
+	/// <param name="query">The seach query.</param>
+	/// <param name="sortBy">Sort information about the query (sort by, sort order)</param>
+	/// <param name="pagination">How pagination should be done (where to start and how many to return)</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>A list of resources that match every filters</returns>
+	public Task<SearchPage<Show>.SearchResult> SearchShows(
+		string? query,
+		Sort<Show> sortBy,
+		SearchPagination pagination,
+		Include<Show>? include = default
+	);
+
+	/// <summary>
+	/// Search for collections.
+	/// </summary>
+	/// <param name="query">The seach query.</param>
+	/// <param name="sortBy">Sort information about the query (sort by, sort order)</param>
+	/// <param name="pagination">How pagination should be done (where to start and how many to return)</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>A list of resources that match every filters</returns>
+	public Task<SearchPage<Collection>.SearchResult> SearchCollections(
+		string? query,
+		Sort<Collection> sortBy,
+		SearchPagination pagination,
+		Include<Collection>? include = default
+	);
+
+	/// <summary>
+	/// Search for episodes.
+	/// </summary>
+	/// <param name="query">The seach query.</param>
+	/// <param name="sortBy">Sort information about the query (sort by, sort order)</param>
+	/// <param name="pagination">How pagination should be done (where to start and how many to return)</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>A list of resources that match every filters</returns>
+	public Task<SearchPage<Episode>.SearchResult> SearchEpisodes(
+		string? query,
+		Sort<Episode> sortBy,
+		SearchPagination pagination,
+		Include<Episode>? include = default
+	);
+
+	/// <summary>
+	/// Search for studios.
+	/// </summary>
+	/// <param name="query">The seach query.</param>
+	/// <param name="sortBy">Sort information about the query (sort by, sort order)</param>
+	/// <param name="pagination">How pagination should be done (where to start and how many to return)</param>
+	/// <param name="include">The related fields to include.</param>
+	/// <returns>A list of resources that match every filters</returns>
+	public Task<SearchPage<Studio>.SearchResult> SearchStudios(
+		string? query,
+		Sort<Studio> sortBy,
+		SearchPagination pagination,
+		Include<Studio>? include = default
+	);
+}

back/src/Kyoo.Abstractions/Controllers/IThumbnailsManager.cs

@@ -0,0 +1,41 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.IO;
+using System.Threading.Tasks;
+using Kyoo.Abstractions.Models;
+
+namespace Kyoo.Abstractions.Controllers;
+
+public interface IThumbnailsManager
+{
+	Task DownloadImages<T>(T item)
+		where T : IThumbnails;
+
+	Task DownloadImage(Image? image, string what);
+
+	string GetImagePath(Guid imageId, ImageQuality quality);
+
+	Task DeleteImages<T>(T item)
+		where T : IThumbnails;
+
+	Task<Stream> GetUserImage(Guid userId);
+
+	Task SetUserImage(Guid userId, Stream? image);
+}

back/src/Kyoo.Abstractions/Controllers/IWatchStatusRepository.cs

@@ -0,0 +1,83 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Kyoo.Abstractions.Models;
+using Kyoo.Abstractions.Models.Utils;
+
+namespace Kyoo.Abstractions.Controllers;
+
+/// <summary>
+/// A local repository to handle watched items
+/// </summary>
+public interface IWatchStatusRepository
+{
+	public delegate Task ResourceEventHandler<T>(T resource);
+
+	Task<ICollection<IWatchlist>> GetAll(
+		Filter<IWatchlist>? filter = default,
+		Include<IWatchlist>? include = default,
+		Pagination? limit = default
+	);
+
+	Task<MovieWatchStatus?> GetMovieStatus(Guid movieId, Guid userId);
+
+	Task<MovieWatchStatus?> SetMovieStatus(
+		Guid movieId,
+		Guid userId,
+		WatchStatus status,
+		int? watchedTime,
+		int? percent
+	);
+
+	static event ResourceEventHandler<WatchStatus<Movie>> OnMovieStatusChangedHandler;
+	protected static Task OnMovieStatusChanged(WatchStatus<Movie> obj) =>
+		OnMovieStatusChangedHandler?.Invoke(obj) ?? Task.CompletedTask;
+
+	Task DeleteMovieStatus(Guid movieId, Guid userId);
+
+	Task<ShowWatchStatus?> GetShowStatus(Guid showId, Guid userId);
+
+	Task<ShowWatchStatus?> SetShowStatus(Guid showId, Guid userId, WatchStatus status);
+
+	static event ResourceEventHandler<WatchStatus<Show>> OnShowStatusChangedHandler;
+	protected static Task OnShowStatusChanged(WatchStatus<Show> obj) =>
+		OnShowStatusChangedHandler?.Invoke(obj) ?? Task.CompletedTask;
+
+	Task DeleteShowStatus(Guid showId, Guid userId);
+
+	Task<EpisodeWatchStatus?> GetEpisodeStatus(Guid episodeId, Guid userId);
+
+	/// <param name="watchedTime">Where the user has stopped watching. Only usable if Status
+	/// is <see cref="WatchStatus.Watching"/></param>
+	Task<EpisodeWatchStatus?> SetEpisodeStatus(
+		Guid episodeId,
+		Guid userId,
+		WatchStatus status,
+		int? watchedTime,
+		int? percent
+	);
+
+	static event ResourceEventHandler<WatchStatus<Episode>> OnEpisodeStatusChangedHandler;
+	protected static Task OnEpisodeStatusChanged(WatchStatus<Episode> obj) =>
+		OnEpisodeStatusChangedHandler?.Invoke(obj) ?? Task.CompletedTask;
+
+	Task DeleteEpisodeStatus(Guid episodeId, Guid userId);
+}

back/src/Kyoo.Abstractions/Extensions.cs

@@ -0,0 +1,64 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Security.Claims;
+using Kyoo.Abstractions.Models.Exceptions;
+using Kyoo.Authentication.Models;
+
+namespace Kyoo.Authentication;
+
+/// <summary>
+/// Extension methods.
+/// </summary>
+public static class Extensions
+{
+	/// <summary>
+	/// Get the permissions of an user.
+	/// </summary>
+	/// <param name="user">The user</param>
+	/// <returns>The list of permissions</returns>
+	public static ICollection<string> GetPermissions(this ClaimsPrincipal user)
+	{
+		return user.Claims.FirstOrDefault(x => x.Type == Claims.Permissions)?.Value.Split(',')
+			?? Array.Empty<string>();
+	}
+
+	/// <summary>
+	/// Get the id of the current user or null if unlogged or invalid.
+	/// </summary>
+	/// <param name="user">The user.</param>
+	/// <returns>The id of the user or null.</returns>
+	public static Guid? GetId(this ClaimsPrincipal user)
+	{
+		Claim? value = user.FindFirst(Claims.Id);
+		if (Guid.TryParse(value?.Value, out Guid id))
+			return id;
+		return null;
+	}
+
+	public static Guid GetIdOrThrow(this ClaimsPrincipal user)
+	{
+		Guid? ret = user.GetId();
+		if (ret == null)
+			throw new UnauthorizedException();
+		return ret.Value;
+	}
+}

back/src/Kyoo.Abstractions/Kyoo.Abstractions.csproj

@@ -1,18 +1,17 @@
 <Project Sdk="Microsoft.NET.Sdk">
 	<PropertyGroup>
-		<TargetFramework>net5.0</TargetFramework>
-		<LangVersion>default</LangVersion>
 		<Title>Kyoo.Abstractions</Title>
 		<Description>Base package to create plugins for Kyoo.</Description>
 		<RootNamespace>Kyoo.Abstractions</RootNamespace>
 	</PropertyGroup>
 
 	<ItemGroup>
-		<PackageReference Include="Autofac" Version="6.2.0" />
-		<PackageReference Include="JetBrains.Annotations" Version="2021.2.0" />
+		<PackageReference Include="Dapper" Version="2.1.44" />
+		<PackageReference Include="EntityFrameworkCore.Projectables" Version="4.1.4-prebeta" />
 		<PackageReference Include="Microsoft.AspNetCore.Mvc.Abstractions" Version="2.2.0" />
-		<PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="5.0.0" />
-		<PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="5.0.0" />
-		<PackageReference Include="System.ComponentModel.Composition" Version="5.0.0" />
+		<PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="8.0.0" />
+		<PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="8.0.1" />
+		<PackageReference Include="Sprache" Version="2.3.1" />
+		<PackageReference Include="System.ComponentModel.Composition" Version="8.0.0" />
 	</ItemGroup>
 </Project>

back/src/Kyoo.Abstractions/Models/Attributes/ApiDefinitionAttribute.cs

@@ -0,0 +1,51 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+
+namespace Kyoo.Abstractions.Models.Attributes;
+
+/// <summary>
+/// An attribute to specify on apis to specify it's documentation's name and category.
+/// If this is applied on a method, the specified method will be exploded from the controller's page and be
+/// included on the specified tag page.
+/// </summary>
+[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]
+public class ApiDefinitionAttribute : Attribute
+{
+	/// <summary>
+	/// The public name of this api.
+	/// </summary>
+	public string Name { get; }
+
+	/// <summary>
+	/// The name of the group in witch this API is. You can also specify a custom sort order using the following
+	/// format: <code>order:name</code>. Everything before the first <c>:</c> will be removed but kept for
+	/// th alphabetical ordering.
+	/// </summary>
+	public string? Group { get; set; }
+
+	/// <summary>
+	/// Create a new <see cref="ApiDefinitionAttribute"/>.
+	/// </summary>
+	/// <param name="name">The name of the api that will be used on the documentation page.</param>
+	public ApiDefinitionAttribute(string name)
+	{
+		Name = name;
+	}
+}

back/src/Kyoo.Abstractions/Models/Attributes/ComputedAttribute.cs

@@ -0,0 +1,27 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+
+namespace Kyoo.Abstractions.Models.Attributes;
+
+/// <summary>
+/// An attribute to inform that the property is computed automatically and can't be assigned manually.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property)]
+public class ComputedAttribute : NotMergeableAttribute { }

back/src/Kyoo.Abstractions/Models/Attributes/LoadableRelationAttribute.cs

@@ -17,33 +17,37 @@
 // along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
 
 using System;
-using Kyoo.Abstractions.Controllers;
 
-namespace Kyoo.Abstractions.Models.Attributes
+namespace Kyoo.Abstractions.Models.Attributes;
+
+/// <summary>
+/// The targeted relation can be loaded.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property)]
+public class LoadableRelationAttribute : Attribute
 {
 	/// <summary>
-	/// The targeted relation can be loaded via a call to <see cref="ILibraryManager.Load"/>.
+	/// The name of the field containing the related resource's ID.
 	/// </summary>
-	[AttributeUsage(AttributeTargets.Property)]
-	public class LoadableRelationAttribute : Attribute
+	public string? RelationID { get; }
+
+	public string? Sql { get; set; }
+
+	public string? On { get; set; }
+
+	public string? Projected { get; set; }
+
+	/// <summary>
+	/// Create a new <see cref="LoadableRelationAttribute"/>.
+	/// </summary>
+	public LoadableRelationAttribute() { }
+
+	/// <summary>
+	/// Create a new <see cref="LoadableRelationAttribute"/> with a baking relationID field.
+	/// </summary>
+	/// <param name="relationID">The name of the RelationID field.</param>
+	public LoadableRelationAttribute(string relationID)
 	{
-		/// <summary>
-		/// The name of the field containing the related resource's ID.
-		/// </summary>
-		public string RelationID { get; }
-
-		/// <summary>
-		/// Create a new <see cref="LoadableRelationAttribute"/>.
-		/// </summary>
-		public LoadableRelationAttribute() { }
-
-		/// <summary>
-		/// Create a new <see cref="LoadableRelationAttribute"/> with a baking relationID field.
-		/// </summary>
-		/// <param name="relationID">The name of the RelationID field.</param>
-		public LoadableRelationAttribute(string relationID)
-		{
-			RelationID = relationID;
-		}
+		RelationID = relationID;
 	}
 }

back/src/Kyoo.Abstractions/Models/Attributes/NotMergeableAttribute.cs

@@ -16,26 +16,24 @@
 // You should have received a copy of the GNU General Public License
 // along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
 
-namespace Kyoo.Authentication.Models
+using System;
+
+namespace Kyoo.Abstractions.Models.Attributes;
+
+/// <summary>
+/// Specify that a property can't be merged.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property)]
+public class NotMergeableAttribute : Attribute { }
+
+/// <summary>
+/// An interface with a method called when this object is merged.
+/// </summary>
+public interface IOnMerge
 {
 	/// <summary>
-	/// Permission options.
+	/// This function is called after the object has been merged.
 	/// </summary>
-	public class PermissionOption
-	{
-		/// <summary>
-		/// The path to get this option from the root configuration.
-		/// </summary>
-		public const string Path = "authentication:permissions";
-
-		/// <summary>
-		/// The default permissions that will be given to a non-connected user.
-		/// </summary>
-		public string[] Default { get; set; }
-
-		/// <summary>
-		/// Permissions applied to a new user.
-		/// </summary>
-		public string[] NewUser { get; set; }
-	}
+	/// <param name="merged">The object that has been merged with this.</param>
+	void OnMerge(object merged);
 }

back/src/Kyoo.Abstractions/Models/Attributes/OneOfAttribute.cs

@@ -16,21 +16,18 @@
 // You should have received a copy of the GNU General Public License
 // along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
 
-namespace Kyoo.Authentication.Models.DTO
+using System;
+
+namespace Kyoo.Abstractions.Models.Attributes;
+
+/// <summary>
+/// An attribute to inform that this interface is a type union
+/// </summary>
+[AttributeUsage(AttributeTargets.Interface)]
+public class OneOfAttribute : Attribute
 {
 	/// <summary>
-	/// A model to represent an otac request
+	/// The types this union concist of.
 	/// </summary>
-	public class OtacRequest
-	{
-		/// <summary>
-		/// The One Time Access Code
-		/// </summary>
-		public string Otac { get; set; }
-
-		/// <summary>
-		/// Should the user stay logged
-		/// </summary>
-		public bool StayLoggedIn { get; set; }
-	}
+	public Type[] Types { get; set; }
 }

back/src/Kyoo.Abstractions/Models/Attributes/Permission/PartialPermissionAttribute.cs

@@ -0,0 +1,87 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using Kyoo.Abstractions.Controllers;
+using Microsoft.AspNetCore.Mvc.Filters;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Kyoo.Abstractions.Models.Permissions;
+
+/// <summary>
+/// Specify one part of a permissions needed for the API (the kind or the type).
+/// </summary>
+[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
+public class PartialPermissionAttribute : Attribute, IFilterFactory
+{
+	/// <summary>
+	/// The needed permission type.
+	/// </summary>
+	public string? Type { get; }
+
+	/// <summary>
+	/// The needed permission kind.
+	/// </summary>
+	public Kind? Kind { get; }
+
+	/// <summary>
+	/// The group of this permission.
+	/// </summary>
+	public Group Group { get; set; }
+
+	/// <summary>
+	/// Ask a permission to run an action.
+	/// </summary>
+	/// <remarks>
+	/// With this attribute, you can only specify a type or a kind.
+	/// To have a valid permission attribute, you must specify the kind and the permission using two attributes.
+	/// Those attributes can be dispatched at different places (one on the class, one on the method for example).
+	/// If you don't put exactly two of those attributes, the permission attribute will be ill-formed and will
+	/// lead to unspecified behaviors.
+	/// </remarks>
+	/// <param name="type">The type of the action</param>
+	public PartialPermissionAttribute(string type)
+	{
+		Type = type.ToLower();
+	}
+
+	/// <summary>
+	/// Ask a permission to run an action.
+	/// </summary>
+	/// <remarks>
+	/// With this attribute, you can only specify a type or a kind.
+	/// To have a valid permission attribute, you must specify the kind and the permission using two attributes.
+	/// Those attributes can be dispatched at different places (one on the class, one on the method for example).
+	/// If you don't put exactly two of those attributes, the permission attribute will be ill-formed and will
+	/// lead to unspecified behaviors.
+	/// </remarks>
+	/// <param name="permission">The kind of permission needed.</param>
+	public PartialPermissionAttribute(Kind permission)
+	{
+		Kind = permission;
+	}
+
+	/// <inheritdoc />
+	public IFilterMetadata CreateInstance(IServiceProvider serviceProvider)
+	{
+		return serviceProvider.GetRequiredService<IPermissionValidator>().Create(this);
+	}
+
+	/// <inheritdoc />
+	public bool IsReusable => true;
+}

back/src/Kyoo.Abstractions/Models/Attributes/Permission/PermissionAttribute.cs

@@ -0,0 +1,136 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using Kyoo.Abstractions.Controllers;
+using Microsoft.AspNetCore.Mvc.Filters;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Kyoo.Abstractions.Models.Permissions;
+
+/// <summary>
+/// The kind of permission needed.
+/// </summary>
+public enum Kind
+{
+	/// <summary>
+	/// Allow the user to read for this kind of data.
+	/// </summary>
+	Read,
+
+	/// <summary>
+	/// Allow the user to write for this kind of data.
+	/// </summary>
+	Write,
+
+	/// <summary>
+	/// Allow the user to create this kind of data.
+	/// </summary>
+	Create,
+
+	/// <summary>
+	/// Allow the user to delete this kind of data.
+	/// </summary>
+	Delete,
+
+	/// <summary>
+	/// Allow the user to play this file.
+	/// </summary>
+	Play,
+}
+
+/// <summary>
+/// The group of the permission.
+/// </summary>
+public enum Group
+{
+	/// <summary>
+	/// Default group indicating no value.
+	/// </summary>
+	None,
+
+	/// <summary>
+	/// Allow all operations on basic items types.
+	/// </summary>
+	Overall,
+
+	/// <summary>
+	/// Allow operation on sensitive items like libraries path, configurations and so on.
+	/// </summary>
+	Admin
+}
+
+/// <summary>
+/// Specify permissions needed for the API.
+/// </summary>
+[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
+public class PermissionAttribute : Attribute, IFilterFactory
+{
+	/// <summary>
+	/// The needed permission as string.
+	/// </summary>
+	public string Type { get; }
+
+	/// <summary>
+	/// The needed permission kind.
+	/// </summary>
+	public Kind Kind { get; }
+
+	/// <summary>
+	/// The group of this permission.
+	/// </summary>
+	public Group Group { get; set; }
+
+	/// <summary>
+	/// Ask a permission to run an action.
+	/// </summary>
+	/// <param name="type">
+	/// The type of the action
+	/// </param>
+	/// <param name="permission">
+	/// The kind of permission needed.
+	/// </param>
+	/// <param name="group">
+	/// The group of this permission (allow grouped permission like overall.read
+	/// for all read permissions of this group).
+	/// </param>
+	public PermissionAttribute(string type, Kind permission, Group group = Group.Overall)
+	{
+		Type = type.ToLower();
+		Kind = permission;
+		Group = group;
+	}
+
+	/// <inheritdoc />
+	public IFilterMetadata CreateInstance(IServiceProvider serviceProvider)
+	{
+		return serviceProvider.GetRequiredService<IPermissionValidator>().Create(this);
+	}
+
+	/// <inheritdoc />
+	public bool IsReusable => true;
+
+	/// <summary>
+	/// Return this permission attribute as a string.
+	/// </summary>
+	/// <returns>The string representation.</returns>
+	public string AsPermissionString()
+	{
+		return Type;
+	}
+}

back/src/Kyoo.Abstractions/Models/Attributes/Permission/UserOnlyAttribute.cs

@@ -0,0 +1,30 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+
+namespace Kyoo.Abstractions.Models.Permissions;
+
+/// <summary>
+/// The annotated route can only be accessed by a logged in user.
+/// </summary>
+[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
+public class UserOnlyAttribute : Attribute
+{
+	// TODO: Implement a Filter Attribute to make this work. For now, this attribute is only useful as documentation.
+}

back/src/Kyoo.Abstractions/Models/Attributes/SqlFirstColumnAttribute.cs

@@ -16,26 +16,22 @@
 // You should have received a copy of the GNU General Public License
 // along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
 
-namespace Kyoo.Core.Models.Options
+using System;
+using Kyoo.Utils;
+
+namespace Kyoo.Abstractions.Models.Attributes;
+
+[AttributeUsage(AttributeTargets.Class)]
+public class SqlFirstColumnAttribute : Attribute
 {
 	/// <summary>
-	/// Options for media registering.
+	/// The name of the first column of the element. Used to split multiples
+	/// items on a single sql query. If not specified, it defaults to "Id".
 	/// </summary>
-	public class MediaOptions
+	public string Name { get; set; }
+
+	public SqlFirstColumnAttribute(string name)
 	{
-		/// <summary>
-		/// The path of this options
-		/// </summary>
-		public const string Path = "Media";
-
-		/// <summary>
-		/// A regex for episodes
-		/// </summary>
-		public string[] Regex { get; set; }
-
-		/// <summary>
-		/// A regex for subtitles
-		/// </summary>
-		public string[] SubtitleRegex { get; set; }
+		Name = name.ToSnakeCase();
 	}
 }

back/src/Kyoo.Abstractions/Models/Exceptions/DuplicatedItemException.cs

@@ -16,21 +16,19 @@
 // You should have received a copy of the GNU General Public License
 // along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
 
-namespace Kyoo.TheTvdb.Models
+using System;
+
+namespace Kyoo.Abstractions.Models.Exceptions;
+
+/// <summary>
+/// An exception raised when an item already exists in the database.
+/// </summary>
+[Serializable]
+public class DuplicatedItemException(object? existing = null)
+	: Exception("Already exists in the database.")
 {
 	/// <summary>
-	/// The option containing the api key for the tvdb.
+	/// The existing object.
 	/// </summary>
-	public class TvdbOption
-	{
-		/// <summary>
-		/// The path to get this option from the root configuration.
-		/// </summary>
-		public const string Path = "tvdb";
-
-		/// <summary>
-		/// The api key of the tvdb.
-		/// </summary>
-		public string ApiKey { get; set; }
-	}
+	public object? Existing { get; } = existing;
 }

back/src/Kyoo.Abstractions/Models/Exceptions/ItemNotFoundException.cs

@@ -18,23 +18,24 @@
 
 using System;
 
-namespace Kyoo.Abstractions.Models.Attributes
+namespace Kyoo.Abstractions.Models.Exceptions;
+
+/// <summary>
+/// An exception raised when an item could not be found.
+/// </summary>
+[Serializable]
+public class ItemNotFoundException : Exception
 {
 	/// <summary>
-	/// Specify that a property can't be merged.
+	/// Create a default <see cref="ItemNotFoundException"/> with no message.
 	/// </summary>
-	[AttributeUsage(AttributeTargets.Property)]
-	public class NotMergeableAttribute : Attribute { }
+	public ItemNotFoundException()
+		: base("Item not found") { }
 
 	/// <summary>
-	/// An interface with a method called when this object is merged.
+	/// Create a new <see cref="ItemNotFoundException"/> with a message
 	/// </summary>
-	public interface IOnMerge
-	{
-		/// <summary>
-		/// This function is called after the object has been merged.
-		/// </summary>
-		/// <param name="merged">The object that has been merged with this.</param>
-		void OnMerge(object merged);
-	}
+	/// <param name="message">The message of the exception</param>
+	public ItemNotFoundException(string message)
+		: base(message) { }
 }

back/src/Kyoo.Abstractions/Models/Exceptions/UnauthorizedException.cs

@@ -0,0 +1,31 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+
+namespace Kyoo.Abstractions.Models.Exceptions;
+
+[Serializable]
+public class UnauthorizedException : Exception
+{
+	public UnauthorizedException()
+		: base("User not authenticated or token invalid.") { }
+
+	public UnauthorizedException(string message)
+		: base(message) { }
+}

back/src/Kyoo.Abstractions/Models/Genre.cs

@@ -0,0 +1,50 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// A genre that allow one to specify categories for shows.
+/// </summary>
+public enum Genre
+{
+	Action,
+	Adventure,
+	Animation,
+	Comedy,
+	Crime,
+	Documentary,
+	Drama,
+	Family,
+	Fantasy,
+	History,
+	Horror,
+	Music,
+	Mystery,
+	Romance,
+	ScienceFiction,
+	Thriller,
+	War,
+	Western,
+	Kids,
+	News,
+	Reality,
+	Soap,
+	Talk,
+	Politics,
+}

back/src/Kyoo.Abstractions/Models/ILibraryItem.cs

@@ -0,0 +1,31 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using Kyoo.Abstractions.Controllers;
+using Kyoo.Abstractions.Models.Attributes;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// A show, a movie or a collection.
+/// </summary>
+[OneOf(Types = new[] { typeof(Show), typeof(Movie), typeof(Collection) })]
+public interface ILibraryItem : IResource, IThumbnails, IMetadata, IAddedDate, IQuery
+{
+	static Sort IQuery.DefaultSort => new Sort<ILibraryItem>.By(nameof(Movie.Name));
+}

back/src/Kyoo.Abstractions/Models/INews.cs

@@ -0,0 +1,31 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using Kyoo.Abstractions.Controllers;
+using Kyoo.Abstractions.Models.Attributes;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// A show, a movie or a collection.
+/// </summary>
+[OneOf(Types = [typeof(Episode), typeof(Movie)])]
+public interface INews : IResource, IThumbnails, IAddedDate, IQuery
+{
+	static Sort IQuery.DefaultSort => new Sort<INews>.By(nameof(AddedDate), true);
+}

back/src/Kyoo.Abstractions/Models/IWatchlist.cs

@@ -0,0 +1,27 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using Kyoo.Abstractions.Models.Attributes;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// A watch list item.
+/// </summary>
+[OneOf(Types = new[] { typeof(Show), typeof(Movie) })]
+public interface IWatchlist : IResource, IThumbnails, IMetadata, IAddedDate { }

back/src/Kyoo.Abstractions/Models/Issues.cs

@@ -0,0 +1,52 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.Collections.Generic;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// An issue that occured on kyoo.
+/// </summary>
+public class Issue : IAddedDate
+{
+	/// <summary>
+	/// The type of issue (for example, "Scanner" if this issue was created due to scanning error).
+	/// </summary>
+	public string Domain { get; set; }
+
+	/// <summary>
+	/// Why this issue was caused? An unique cause that can be used to identify this issue.
+	/// For the scanner, a cause should be a video path.
+	/// </summary>
+	public string Cause { get; set; }
+
+	/// <summary>
+	/// A human readable string explaining why this issue occured.
+	/// </summary>
+	public string Reason { get; set; }
+
+	/// <summary>
+	/// Some extra data that could store domain-specific info.
+	/// </summary>
+	public Dictionary<string, object> Extra { get; set; } = new();
+
+	/// <inheritdoc/>
+	public DateTime AddedDate { get; set; }
+}

back/src/Kyoo.Abstractions/Models/MetadataID.cs

@@ -0,0 +1,61 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// ID and link of an item on an external provider.
+/// </summary>
+public class MetadataId
+{
+	/// <summary>
+	/// The ID of the resource on the external provider.
+	/// </summary>
+	public string DataId { get; set; }
+
+	/// <summary>
+	/// The URL of the resource on the external provider.
+	/// </summary>
+	public string? Link { get; set; }
+}
+
+/// <summary>
+/// ID informations about an episode.
+/// </summary>
+public class EpisodeId
+{
+	/// <summary>
+	/// The Id of the show on the metadata database.
+	/// </summary>
+	public string ShowId { get; set; }
+
+	/// <summary>
+	/// The season number or null if absolute numbering is used in this database.
+	/// </summary>
+	public int? Season { get; set; }
+
+	/// <summary>
+	/// The episode number or absolute number if Season is null.
+	/// </summary>
+	public int Episode { get; set; }
+
+	/// <summary>
+	/// The URL of the resource on the external provider.
+	/// </summary>
+	public string? Link { get; set; }
+}

back/src/Kyoo.Abstractions/Models/Page.cs

@@ -0,0 +1,105 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System.Collections.Generic;
+using System.Linq;
+using Kyoo.Utils;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// A page of resource that contains information about the pagination of resources.
+/// </summary>
+/// <typeparam name="T">The type of resource contained in this page.</typeparam>
+public class Page<T>
+	where T : IResource
+{
+	/// <summary>
+	/// The link of the current page.
+	/// </summary>
+	public string This { get; }
+
+	/// <summary>
+	/// The link of the first page.
+	/// </summary>
+	public string First { get; }
+
+	/// <summary>
+	/// The link of the previous page.
+	/// </summary>
+	public string? Previous { get; }
+
+	/// <summary>
+	/// The link of the next page.
+	/// </summary>
+	public string? Next { get; }
+
+	/// <summary>
+	/// The number of items in the current page.
+	/// </summary>
+	public int Count => Items.Count;
+
+	/// <summary>
+	/// The list of items in the page.
+	/// </summary>
+	public ICollection<T> Items { get; }
+
+	/// <summary>
+	/// Create a new <see cref="Page{T}"/>.
+	/// </summary>
+	/// <param name="items">The list of items in the page.</param>
+	/// <param name="this">The link of the current page.</param>
+	/// <param name="previous">The link of the previous page.</param>
+	/// <param name="next">The link of the next page.</param>
+	/// <param name="first">The link of the first page.</param>
+	public Page(ICollection<T> items, string @this, string? previous, string? next, string first)
+	{
+		Items = items;
+		This = @this;
+		Previous = previous;
+		Next = next;
+		First = first;
+	}
+
+	/// <summary>
+	/// Create a new <see cref="Page{T}"/> and compute the urls.
+	/// </summary>
+	/// <param name="items">The list of items in the page.</param>
+	/// <param name="url">The base url of the resources available from this page.</param>
+	/// <param name="query">The list of query strings of the current page</param>
+	/// <param name="limit">The number of items requested for the current page.</param>
+	public Page(ICollection<T> items, string url, Dictionary<string, string> query, int limit)
+	{
+		Items = items;
+		This = url + query.ToQueryString();
+		if (items.Count > 0 && query.ContainsKey("afterID"))
+		{
+			query["afterID"] = items.First().Id.ToString();
+			query["reverse"] = "true";
+			Previous = url + query.ToQueryString();
+		}
+		query.Remove("reverse");
+		if (items.Count == limit && limit > 0)
+		{
+			query["afterID"] = items.Last().Id.ToString();
+			Next = url + query.ToQueryString();
+		}
+		query.Remove("afterID");
+		First = url + query.ToQueryString();
+	}
+}

back/src/Kyoo.Abstractions/Models/Patch.cs

@@ -0,0 +1,46 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+using System.Text.Json;
+using Kyoo.Abstractions.Models;
+
+namespace Kyoo.Models;
+
+public class Patch<T> : Dictionary<string, JsonDocument>
+	where T : class, IResource
+{
+	public Guid? Id => this.GetValueOrDefault(nameof(IResource.Id))?.Deserialize<Guid>();
+
+	public string? Slug => this.GetValueOrDefault(nameof(IResource.Slug))?.Deserialize<string>();
+
+	public T Apply(T current)
+	{
+		foreach ((string property, JsonDocument value) in this)
+		{
+			PropertyInfo prop = typeof(T).GetProperty(
+				property,
+				BindingFlags.IgnoreCase | BindingFlags.Public | BindingFlags.Instance
+			)!;
+			prop.SetValue(current, value.Deserialize(prop.PropertyType));
+		}
+		return current;
+	}
+}

back/src/Kyoo.Abstractions/Models/Resources/Collection.cs

@@ -0,0 +1,100 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+using System.Text.Json.Serialization;
+using Kyoo.Abstractions.Controllers;
+using Kyoo.Utils;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// A class representing collections of <see cref="Show"/>.
+/// </summary>
+public class Collection
+	: IQuery,
+		IResource,
+		IMetadata,
+		IThumbnails,
+		IAddedDate,
+		IRefreshable,
+		ILibraryItem
+{
+	public static Sort DefaultSort => new Sort<Collection>.By(nameof(Collection.Name));
+
+	/// <inheritdoc />
+	public Guid Id { get; set; }
+
+	/// <inheritdoc />
+	[MaxLength(256)]
+	public string Slug { get; set; }
+
+	/// <summary>
+	/// The name of this collection.
+	/// </summary>
+	public string Name { get; set; }
+
+	/// <summary>
+	/// The description of this collection.
+	/// </summary>
+	public string? Overview { get; set; }
+
+	/// <inheritdoc />
+	public DateTime AddedDate { get; set; }
+
+	/// <inheritdoc />
+	public Image? Poster { get; set; }
+
+	/// <inheritdoc />
+	public Image? Thumbnail { get; set; }
+
+	/// <inheritdoc />
+	public Image? Logo { get; set; }
+
+	/// <summary>
+	/// The list of movies contained in this collection.
+	/// </summary>
+	[JsonIgnore]
+	public ICollection<Movie>? Movies { get; set; }
+
+	/// <summary>
+	/// The list of shows contained in this collection.
+	/// </summary>
+	[JsonIgnore]
+	public ICollection<Show>? Shows { get; set; }
+
+	/// <inheritdoc />
+	public Dictionary<string, MetadataId> ExternalId { get; set; } = new();
+
+	/// <inheritdoc />
+	public DateTime? NextMetadataRefresh { get; set; }
+
+	public Collection() { }
+
+	[JsonConstructor]
+	public Collection(string name)
+	{
+		if (name != null)
+		{
+			Slug = Utility.ToSlug(name);
+			Name = name;
+		}
+	}
+}

back/src/Kyoo.Abstractions/Models/Resources/Episode.cs

@@ -0,0 +1,302 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+using System.Linq;
+using System.Text.Json.Serialization;
+using System.Text.RegularExpressions;
+using EntityFrameworkCore.Projectables;
+using Kyoo.Abstractions.Controllers;
+using Kyoo.Abstractions.Models.Attributes;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// A class to represent a single show's episode.
+/// </summary>
+public class Episode : IQuery, IResource, IThumbnails, IAddedDate, IRefreshable, INews
+{
+	// Use absolute numbers by default and fallback to season/episodes if it does not exists.
+	public static Sort DefaultSort =>
+		new Sort<Episode>.Conglomerate(
+			new Sort<Episode>.By(x => x.AbsoluteNumber),
+			new Sort<Episode>.By(x => x.SeasonNumber),
+			new Sort<Episode>.By(x => x.EpisodeNumber)
+		);
+
+	/// <inheritdoc />
+	public Guid Id { get; set; }
+
+	/// <inheritdoc />
+	[Computed]
+	[MaxLength(256)]
+	public string Slug
+	{
+		get
+		{
+			if (ShowSlug != null || Show?.Slug != null)
+				return GetSlug(ShowSlug ?? Show!.Slug, SeasonNumber, EpisodeNumber, AbsoluteNumber);
+			return GetSlug(ShowId.ToString(), SeasonNumber, EpisodeNumber, AbsoluteNumber);
+		}
+		private set
+		{
+			Match match = Regex.Match(value, @"(?<show>.+)-s(?<season>\d+)e(?<episode>\d+)");
+
+			if (match.Success)
+			{
+				ShowSlug = match.Groups["show"].Value;
+				SeasonNumber = int.Parse(match.Groups["season"].Value);
+				EpisodeNumber = int.Parse(match.Groups["episode"].Value);
+			}
+			else
+			{
+				match = Regex.Match(value, @"(?<show>.+)-(?<absolute>\d+)");
+				if (match.Success)
+				{
+					ShowSlug = match.Groups["show"].Value;
+					AbsoluteNumber = int.Parse(match.Groups["absolute"].Value);
+				}
+				else
+					ShowSlug = value;
+				SeasonNumber = null;
+				EpisodeNumber = null;
+			}
+		}
+	}
+
+	/// <summary>
+	/// The slug of the Show that contain this episode. If this is not set, this episode is ill-formed.
+	/// </summary>
+	[JsonIgnore]
+	public string? ShowSlug { private get; set; }
+
+	/// <summary>
+	/// The ID of the Show containing this episode.
+	/// </summary>
+	public Guid ShowId { get; set; }
+
+	/// <summary>
+	/// The show that contains this episode.
+	/// </summary>
+	[LoadableRelation(nameof(ShowId))]
+	public Show? Show { get; set; }
+
+	/// <summary>
+	/// The ID of the Season containing this episode.
+	/// </summary>
+	public Guid? SeasonId { get; set; }
+
+	/// <summary>
+	/// The season that contains this episode.
+	/// </summary>
+	/// <remarks>
+	/// This can be null if the season is unknown and the episode is only identified
+	/// by it's <see cref="AbsoluteNumber"/>.
+	/// </remarks>
+	[LoadableRelation(nameof(SeasonId))]
+	public Season? Season { get; set; }
+
+	/// <summary>
+	/// The season in witch this episode is in.
+	/// </summary>
+	public int? SeasonNumber { get; set; }
+
+	/// <summary>
+	/// The number of this episode in it's season.
+	/// </summary>
+	public int? EpisodeNumber { get; set; }
+
+	/// <summary>
+	/// The absolute number of this episode. It's an episode number that is not reset to 1 after a new season.
+	/// </summary>
+	public int? AbsoluteNumber { get; set; }
+
+	/// <summary>
+	/// The path of the video file for this episode.
+	/// </summary>
+	public string Path { get; set; }
+
+	/// <summary>
+	/// The title of this episode.
+	/// </summary>
+	public string? Name { get; set; }
+
+	/// <summary>
+	/// The overview of this episode.
+	/// </summary>
+	public string? Overview { get; set; }
+
+	/// <summary>
+	/// How long is this episode? (in minutes)
+	/// </summary>
+	public int? Runtime { get; set; }
+
+	/// <summary>
+	/// The release date of this episode. It can be null if unknown.
+	/// </summary>
+	public DateOnly? ReleaseDate { get; set; }
+
+	/// <inheritdoc />
+	public DateTime AddedDate { get; set; }
+
+	/// <inheritdoc />
+	public Image? Poster { get; set; }
+
+	/// <inheritdoc />
+	public Image? Thumbnail { get; set; }
+
+	/// <inheritdoc />
+	public Image? Logo { get; set; }
+
+	/// <inheritdoc />
+	public Dictionary<string, EpisodeId> ExternalId { get; set; } = [];
+
+	/// <inheritdoc />
+	public DateTime? NextMetadataRefresh { get; set; }
+
+	/// <summary>
+	/// The previous episode that should be seen before viewing this one.
+	/// </summary>
+	[Projectable(UseMemberBody = nameof(_PreviousEpisode), OnlyOnInclude = true)]
+	[LoadableRelation(
+		// language=PostgreSQL
+		Sql = """
+				select
+					pe.* -- Episode as pe
+				from
+					episodes as "pe"
+				where
+					pe.show_id = "this".show_id
+					and (pe.absolute_number < "this".absolute_number
+						or pe.season_number < "this".season_number
+						or (pe.season_number = "this".season_number
+							and e.episode_number < "this".episode_number))
+				order by
+					pe.absolute_number desc nulls last,
+					pe.season_number desc,
+					pe.episode_number desc
+				limit 1
+			"""
+	)]
+	public Episode? PreviousEpisode { get; set; }
+
+	private Episode? _PreviousEpisode =>
+		Show!
+			.Episodes!.OrderBy(x => x.AbsoluteNumber == null)
+			.ThenByDescending(x => x.AbsoluteNumber)
+			.ThenByDescending(x => x.SeasonNumber)
+			.ThenByDescending(x => x.EpisodeNumber)
+			.FirstOrDefault(x =>
+				x.AbsoluteNumber < AbsoluteNumber
+				|| x.SeasonNumber < SeasonNumber
+				|| (x.SeasonNumber == SeasonNumber && x.EpisodeNumber < EpisodeNumber)
+			);
+
+	/// <summary>
+	/// The next episode to watch after this one.
+	/// </summary>
+	[Projectable(UseMemberBody = nameof(_NextEpisode), OnlyOnInclude = true)]
+	[LoadableRelation(
+		// language=PostgreSQL
+		Sql = """
+				select
+					ne.* -- Episode as ne
+				from
+					episodes as "ne"
+				where
+					ne.show_id = "this".show_id
+					and (ne.absolute_number > "this".absolute_number
+						or ne.season_number > "this".season_number
+						or (ne.season_number = "this".season_number
+							and e.episode_number > "this".episode_number))
+				order by
+					ne.absolute_number,
+					ne.season_number,
+					ne.episode_number
+				limit 1
+			"""
+	)]
+	public Episode? NextEpisode { get; set; }
+
+	private Episode? _NextEpisode =>
+		Show!
+			.Episodes!.OrderBy(x => x.AbsoluteNumber)
+			.ThenBy(x => x.SeasonNumber)
+			.ThenBy(x => x.EpisodeNumber)
+			.FirstOrDefault(x =>
+				x.AbsoluteNumber > AbsoluteNumber
+				|| x.SeasonNumber > SeasonNumber
+				|| (x.SeasonNumber == SeasonNumber && x.EpisodeNumber > EpisodeNumber)
+			);
+
+	[JsonIgnore]
+	public ICollection<EpisodeWatchStatus>? Watched { get; set; }
+
+	/// <summary>
+	/// Metadata of what an user as started/planned to watch.
+	/// </summary>
+	[Projectable(UseMemberBody = nameof(_WatchStatus), OnlyOnInclude = true)]
+	[LoadableRelation(
+		Sql = "episode_watch_status",
+		On = "episode_id = \"this\".id and \"relation\".user_id = [current_user]"
+	)]
+	public EpisodeWatchStatus? WatchStatus { get; set; }
+
+	// There is a global query filter to filter by user so we just need to do single.
+	private EpisodeWatchStatus? _WatchStatus => Watched!.FirstOrDefault();
+
+	/// <summary>
+	/// Links to watch this episode.
+	/// </summary>
+	public VideoLinks Links =>
+		new() { Direct = $"/episode/{Slug}/direct", Hls = $"/episode/{Slug}/master.m3u8", };
+
+	/// <summary>
+	/// Get the slug of an episode.
+	/// </summary>
+	/// <param name="showSlug">The slug of the show. It can't be null.</param>
+	/// <param name="seasonNumber">
+	/// The season in which the episode is.
+	/// If this is a movie or if the episode should be referred by it's absolute number, set this to null.
+	/// </param>
+	/// <param name="episodeNumber">
+	/// The number of the episode in it's season.
+	/// If this is a movie or if the episode should be referred by it's absolute number, set this to null.
+	/// </param>
+	/// <param name="absoluteNumber">
+	/// The absolute number of this show.
+	/// If you don't know it or this is a movie, use null
+	/// </param>
+	/// <returns>The slug corresponding to the given arguments</returns>
+	public static string GetSlug(
+		string showSlug,
+		int? seasonNumber,
+		int? episodeNumber,
+		int? absoluteNumber = null
+	)
+	{
+		return seasonNumber switch
+		{
+			null when absoluteNumber == null => showSlug,
+			null => $"{showSlug}-{absoluteNumber}",
+			_ => $"{showSlug}-s{seasonNumber}e{episodeNumber}"
+		};
+	}
+}

back/src/Kyoo.Abstractions/Models/Resources/Interfaces/IAddedDate.cs

@@ -18,11 +18,15 @@
 
 using System;
 
-namespace Kyoo.Abstractions.Models.Attributes
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// An interface applied to resources.
+/// </summary>
+public interface IAddedDate
 {
 	/// <summary>
-	/// An attribute to inform that the property is computed automatically and can't be assigned manually.
+	/// The date at which this resource was added to kyoo.
 	/// </summary>
-	[AttributeUsage(AttributeTargets.Property)]
-	public class ComputedAttribute : NotMergeableAttribute { }
+	public DateTime AddedDate { get; set; }
 }

back/src/Kyoo.Abstractions/Models/Resources/Interfaces/IMetadata.cs

@@ -16,21 +16,17 @@
 // You should have received a copy of the GNU General Public License
 // along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
 
-namespace Kyoo.TheMovieDb.Models
+using System.Collections.Generic;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// An interface applied to resources containing external metadata.
+/// </summary>
+public interface IMetadata
 {
 	/// <summary>
-	/// The option containing the api key for TheMovieDb.
+	/// The link to metadata providers that this show has. See <see cref="MetadataId"/> for more information.
 	/// </summary>
-	public class TheMovieDbOptions
-	{
-		/// <summary>
-		/// The path to get this option from the root configuration.
-		/// </summary>
-		public const string Path = "the-moviedb";
-
-		/// <summary>
-		/// The api key of TheMovieDb.
-		/// </summary>
-		public string ApiKey { get; set; }
-	}
+	public Dictionary<string, MetadataId> ExternalId { get; set; }
 }

back/src/Kyoo.Abstractions/Models/Resources/Interfaces/IQuery.cs

@@ -1,4 +1,4 @@
-// Kyoo - A portable and vast media library solution.
+// Kyoo - A portable and vast media library solution.
 // Copyright (c) Kyoo.
 //
 // See AUTHORS.md and LICENSE file in the project root for full license information.
@@ -19,11 +19,12 @@
 using System;
 using Kyoo.Abstractions.Controllers;
 
-namespace Kyoo.Abstractions.Models.Attributes
+namespace Kyoo.Abstractions.Models;
+
+public interface IQuery
 {
 	/// <summary>
-	/// The targeted relation can be edited via calls to the repository's <see cref="IRepository{T}.Edit"/> method.
+	/// The sorting that will be used when no user defined one is present.
 	/// </summary>
-	[AttributeUsage(AttributeTargets.Property)]
-	public class EditableRelationAttribute : Attribute { }
+	public static virtual Sort DefaultSort => throw new NotImplementedException();
 }

back/src/Kyoo.Abstractions/Models/Resources/Interfaces/IRefreshable.cs

@@ -0,0 +1,40 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+
+namespace Kyoo.Abstractions.Models;
+
+public interface IRefreshable
+{
+	/// <summary>
+	/// The date of the next metadata refresh. Null if auto-refresh is disabled.
+	/// </summary>
+	public DateTime? NextMetadataRefresh { get; set; }
+
+	public static DateTime ComputeNextRefreshDate(DateOnly airDate)
+	{
+		int days = DateOnly.FromDateTime(DateTime.UtcNow).DayNumber - airDate.DayNumber;
+		return days switch
+		{
+			<= 4 => DateTime.UtcNow.AddDays(1),
+			<= 21 => DateTime.UtcNow.AddDays(14),
+			_ => DateTime.UtcNow.AddMonths(2)
+		};
+	}
+}

back/src/Kyoo.Abstractions/Models/Resources/Interfaces/IResource.cs

@@ -0,0 +1,49 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.ComponentModel.DataAnnotations;
+using Kyoo.Abstractions.Controllers;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// An interface to represent a resource that can be retrieved from the database.
+/// </summary>
+public interface IResource : IQuery
+{
+	/// <summary>
+	/// A unique ID for this type of resource. This can't be changed and duplicates are not allowed.
+	/// </summary>
+	/// <remarks>
+	/// You don't need to specify an ID manually when creating a new resource,
+	/// this field is automatically assigned by the <see cref="IRepository{T}"/>.
+	/// </remarks>
+	public Guid Id { get; set; }
+
+	/// <summary>
+	/// A human-readable identifier that can be used instead of an ID.
+	/// A slug must be unique for a type of resource but it can be changed.
+	/// </summary>
+	/// <remarks>
+	/// There is no setter for a slug since it can be computed from other fields.
+	/// For example, a season slug is {ShowSlug}-s{SeasonNumber}.
+	/// </remarks>
+	[MaxLength(256)]
+	public string Slug { get; }
+}

back/src/Kyoo.Abstractions/Models/Resources/Interfaces/IThumbnails.cs

@@ -0,0 +1,147 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.ComponentModel.DataAnnotations;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// An interface representing items that contains images (like posters, thumbnails, logo, banners...)
+/// </summary>
+public interface IThumbnails
+{
+	/// <summary>
+	/// A poster is a 2/3 format image with the cover of the resource.
+	/// </summary>
+	public Image? Poster { get; set; }
+
+	/// <summary>
+	/// A thumbnail is a 16/9 format image, it could ether be used as a background or as a preview but it usually
+	/// is not an official image.
+	/// </summary>
+	public Image? Thumbnail { get; set; }
+
+	/// <summary>
+	/// A logo is a small image representing the resource.
+	/// </summary>
+	public Image? Logo { get; set; }
+}
+
+[JsonConverter(typeof(ImageConvertor))]
+public class Image
+{
+	/// <summary>
+	/// A unique identifier for the image. Used for proper http caches.
+	/// </summary>
+	public Guid Id { get; set; }
+
+	/// <summary>
+	/// The original image from another server.
+	/// </summary>
+	public string Source { get; set; }
+
+	/// <summary>
+	/// A hash to display as placeholder while the image is loading.
+	/// </summary>
+	[MaxLength(32)]
+	public string Blurhash { get; set; }
+
+	/// <summary>
+	/// The url to access the image in low quality.
+	/// </summary>
+	public string Low => $"/thumbnails/{Id}?quality=low";
+
+	/// <summary>
+	/// The url to access the image in medium quality.
+	/// </summary>
+	public string Medium => $"/thumbnails/{Id}?quality=medium";
+
+	/// <summary>
+	/// The url to access the image in high quality.
+	/// </summary>
+	public string High => $"/thumbnails/{Id}?quality=high";
+
+	public Image() { }
+
+	[JsonConstructor]
+	public Image(string source, string? blurhash = null)
+	{
+		Source = source;
+		Blurhash = blurhash ?? "000000";
+	}
+
+	//
+	public class ImageConvertor : JsonConverter<Image>
+	{
+		/// <inheritdoc />
+		public override Image? Read(
+			ref Utf8JsonReader reader,
+			Type typeToConvert,
+			JsonSerializerOptions options
+		)
+		{
+			if (reader.TokenType == JsonTokenType.String && reader.GetString() is string source)
+				return new Image(source);
+			using JsonDocument document = JsonDocument.ParseValue(ref reader);
+			string? src = document.RootElement.GetProperty("Source").GetString();
+			string? blurhash = document.RootElement.GetProperty("Blurhash").GetString();
+			Guid? id = document.RootElement.GetProperty("Id").GetGuid();
+			return new Image(src ?? string.Empty, blurhash) { Id = id ?? Guid.Empty };
+		}
+
+		/// <inheritdoc />
+		public override void Write(
+			Utf8JsonWriter writer,
+			Image value,
+			JsonSerializerOptions options
+		)
+		{
+			writer.WriteStartObject();
+			writer.WriteString("source", value.Source);
+			writer.WriteString("blurhash", value.Blurhash);
+			writer.WriteString("low", value.Low);
+			writer.WriteString("medium", value.Medium);
+			writer.WriteString("high", value.High);
+			writer.WriteEndObject();
+		}
+	}
+}
+
+/// <summary>
+/// The quality of an image
+/// </summary>
+public enum ImageQuality
+{
+	/// <summary>
+	/// Small
+	/// </summary>
+	Low,
+
+	/// <summary>
+	/// Medium
+	/// </summary>
+	Medium,
+
+	/// <summary>
+	/// Large
+	/// </summary>
+	High,
+}

back/src/Kyoo.Abstractions/Models/Resources/JwtToken.cs

@@ -0,0 +1,65 @@
+// Kyoo - A portable and vast media library solution.
+// Copyright (c) Kyoo.
+//
+// See AUTHORS.md and LICENSE file in the project root for full license information.
+//
+// Kyoo is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// Kyoo is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Kyoo. If not, see <https://www.gnu.org/licenses/>.
+
+using System;
+using System.Text.Json.Serialization;
+
+namespace Kyoo.Abstractions.Models;
+
+/// <summary>
+/// A container representing the response of a login or token refresh.
+/// </summary>
+/// <remarks>
+/// Initializes a new instance of the <see cref="JwtToken"/> class.
+/// </remarks>
+/// <param name="accessToken">The access token used to authorize requests.</param>
+/// <param name="refreshToken">The refresh token to retrieve a new access token.</param>
+/// <param name="expireIn">When the access token will expire.</param>
+public class JwtToken(string accessToken, string refreshToken, TimeSpan expireIn)
+{
+	/// <summary>
+	/// The type of this token (always a Bearer).
+	/// </summary>
+	[JsonPropertyName("token_type")]
+	public string TokenType => "Bearer";
+
+	/// <summary>
+	/// The access token used to authorize requests.
+	/// </summary>
+	[JsonPropertyName("access_token")]
+	public string AccessToken { get; set; } = accessToken;
+
+	/// <summary>
+	/// The refresh token used to retrieve a new access/refresh token when the access token has expired.
+	/// </summary>
+	[JsonPropertyName("refresh_token")]
+	public string RefreshToken { get; set; } = refreshToken;
+
+	/// <summary>
+	/// When the access token will expire. After this time, the refresh token should be used to retrieve.
+	/// a new token.cs
+	/// </summary>
+	[JsonPropertyName("expire_in")]
+	public TimeSpan ExpireIn => ExpireAt.Subtract(DateTime.UtcNow);
+
+	/// <summary>
+	/// The exact date at which the access token will expire.
+	/// </summary>
+	[JsonPropertyName("expire_at")]
+	public DateTime ExpireAt { get; set; } = DateTime.UtcNow + expireIn;
+}