mirror of
https://github.com/zoriya/Kyoo.git
synced 2025-05-24 02:02:36 -04:00
Documentation: Setting-up: Some fixes & details
This commit is contained in:
parent
349d1ea3cb
commit
b3e9904634
@ -12,7 +12,7 @@ To setup Kyoo, you need to make sure you installed it, then we'll configure some
|
||||
## settings.json
|
||||
|
||||
If you installed Kyoo on Linux/macOS, their should be a ```/var/lib/Kyoo``` directory
|
||||
If you are on a Windows, it should be ```C:\ProgramData```
|
||||
If you are on a Windows, it should be ```C:\ProgramData\Kyoo```
|
||||
|
||||
Inside this folder, we'll find (almost) everything we need. The most important file is ```settings.json```
|
||||
|
||||
@ -22,7 +22,7 @@ We are going to take a look at the fields you might want to change to tailor Kyo
|
||||
|
||||
- ```basics```
|
||||
- ```url```: The port on which Kyoo will be exposed
|
||||
- ```publicUrl```: The full URL for Kyoo. **Warning** The port must match with ```url```
|
||||
- ```publicUrl```: The full URL for Kyoo.
|
||||
For the 3 following fields, the path are relative to the directory ```settings.json``` is in
|
||||
- ```pluginsPath```: The directory where the plugins are stored
|
||||
- ```transmuxPath```: The directory where the transmux-ed video are stored (used as a cache)
|
||||
@ -45,17 +45,17 @@ We are going to take a look at the fields you might want to change to tailor Kyo
|
||||
**Warning** Therefore, if your shows are not in individual folders, it is recommended to set ```metadataInShow``` to ```false```. If you don't, all the shows will share the same metadata we are sure you don't want that ;)
|
||||
|
||||
- ```database```
|
||||
- ```enabled```: Which database to use. Either ```sqlite``` (by default) or ```postgres```. SQLite is easier to use & manage if you don't have an SQL server on your machine
|
||||
- ```enabled```: Which database to use. Either ```sqlite``` (by default) or ```postgres```. SQLite is easier to use & manage if you don't have an SQL server on your machine. However, if you have a large amount of videos, we recommend using Postgres, which is more powerful to manage large databases
|
||||
|
||||
- ```tasks```
|
||||
- ```parallels```: The number (as a string) of tasks that can be run at the same time. To avoid conflicts, we recommend leaving the value at ```1```
|
||||
- ```parallels```: The number of tasks that can be run at the same time. If the values is not ```1```, the behavior is not implemented.
|
||||
- ```scheduled```: An object with keys being the name of an automation task, with a value being the interval between each task of the same type.
|
||||
- The available keys can be found at ```publicUrl/api/tasks``` (as 'slug')
|
||||
- The values must be formatted like ```HH:MM:SS``
|
||||
**For Example** in the default configuration, a file scan task will be executed every 24 hours
|
||||
|
||||
- ```media```
|
||||
- ```regex```: An array of String to match files using Regex (PHP). The Regex must have the following groups:
|
||||
- ```regex```: An array of String to match files using Regex. The Regex must have the following groups:
|
||||
- ```Collection```: The name of the collection. For example, you can move all the movie from a same saga in one directory, the collection's name will be the directory's. If the movie is at the root of the library, no collection will be created.
|
||||
- ```Show```: the name of the show/movie
|
||||
- ```StartYear``` (optional): the start year for a TV Series, or Year for a movie, used to get the correct metadata in provider
|
||||
@ -75,7 +75,7 @@ We are going to take a look at the fields you might want to change to tailor Kyo
|
||||
|
||||
## Using a Container
|
||||
|
||||
If you use Kyoo from a container, we recommand using the docker-compose file from [here](https://github.com/AnonymusRaccoon/Kyoo) and doing the following actions before launching the container:
|
||||
If you use Kyoo from a container, we recommend using the docker-compose file from [here](https://github.com/AnonymusRaccoon/Kyoo) and doing the following actions before launching the container:
|
||||
|
||||
- If you use Postgres, configure the fields ```DATABASE__CONFIGURATIONS_*```
|
||||
- If you use SQLite, set the ```DATABASE__ENABLED``` to ```sqlite```
|
||||
@ -84,6 +84,8 @@ If you use Kyoo from a container, we recommand using the docker-compose file fro
|
||||
- Map the folder ```/video``` to the media directory
|
||||
- If you use Postgres, map ```/var/lib/postgresql/data``` to the host's Postgres server data folder
|
||||
|
||||
If you don't have a previous Kyoo configuration, we recommend using Postgres.
|
||||
|
||||
## Configuring Libraries
|
||||
|
||||
You are now ready to launch Kyoo for the first time!
|
||||
@ -103,7 +105,7 @@ Then, we are going to interact with Kyoo's API. To create a library, you must do
|
||||
{
|
||||
"name": "$KYOO_LIBRARY_NAME", // The name of the Library
|
||||
"slug": "$KYOO_LIBRARY_SLUG", // The unique identifier of the Library, can be $KYOO_LIBRARY_NAME if it's unique
|
||||
"paths": ["$KYOO_LIBRARY_PATH"], // Path of directories to scan for shows in library
|
||||
"paths": ["$KYOO_LIBRARY_PATH"], // Paths of directories to scan for shows in library
|
||||
"providers": [
|
||||
{"slug": "the-moviedb"}, // Remove if you don't want to use this provider
|
||||
{"slug": "the-tvdb"} // Remove if you don't want to use this provider
|
||||
|
Loading…
x
Reference in New Issue
Block a user