Add the readme.
This commit is contained in:
@@ -0,0 +1,74 @@
|
|||||||
|
# Lumière (introduction)
|
||||||
|
This project aims to deliver a service to stream videos from a server to many devices.
|
||||||
|
|
||||||
|
The UI should be very simple and display films and series.
|
||||||
|
|
||||||
|
# User types
|
||||||
|
There are two types of users:
|
||||||
|
- administrator
|
||||||
|
- can manage films and series
|
||||||
|
- can manage users
|
||||||
|
- user (simple user)
|
||||||
|
- can watch films and series
|
||||||
|
|
||||||
|
# Watching history
|
||||||
|
When a user watches a film or a series episode, the application registers each video progress, and if the user has already watched the video or not.
|
||||||
|
|
||||||
|
This last indicator can be reset (in case when the user wants to re-watch a series from the beginning).
|
||||||
|
|
||||||
|
# Adding films or series
|
||||||
|
At the first installation, the administrator has to define a folder path in the `.env` file. This folder path will be designated as "root folder" for the rest of this file.
|
||||||
|
|
||||||
|
Film and series files have to be copied in the root folder.
|
||||||
|
|
||||||
|
For series, the administrator has to create one folder in the root folder, and one folder inside this per season.
|
||||||
|
|
||||||
|
## Examples
|
||||||
|
### Root folder
|
||||||
|
`/opt/lumière/files`
|
||||||
|
|
||||||
|
### Adding a film
|
||||||
|
- Film name: `Lord of the rings 1`
|
||||||
|
- Film filename: `lord_of_the_rings_1.mkv`
|
||||||
|
- File location: `/opt/lumière/files/lord_of_the_rings_1.mkv`
|
||||||
|
|
||||||
|
### Grouping films
|
||||||
|
To group films, create a folder in the root folder, and put the film files in it.
|
||||||
|
|
||||||
|
- Films to group:
|
||||||
|
- `Lord of the rings 1`
|
||||||
|
- Film filename: `lord_of_the_rings_1.mkv`
|
||||||
|
- File location: `/opt/lumière/files/lord_of_the_ring/lord_of_the_rings_1.mkv`
|
||||||
|
- `Lord of the rings 2`
|
||||||
|
- Film filename: `lord_of_the_rings_2.mkv`
|
||||||
|
- File location: `/opt/lumière/files/lord_of_the_ring/lord_of_the_rings_2.mkv`
|
||||||
|
- `Lord of the rings 3`
|
||||||
|
- Film filename: `lord_of_the_rings_3.mkv`
|
||||||
|
- File location: `/opt/lumière/files/lord_of_the_ring/lord_of_the_rings_3.mkv`
|
||||||
|
|
||||||
|
### Series
|
||||||
|
Do the same thing as grouping films, but create sub folders for each season in the series name.
|
||||||
|
|
||||||
|
- Series name: `Young Sheldon`
|
||||||
|
- Season 1:
|
||||||
|
- Episode 1
|
||||||
|
- Filename: `young_sheldon_S1_E1.mkv`
|
||||||
|
- File location: `/opt/lumière/files/young_sheldon/season_1/young_sheldon_S1_E1.mkv`
|
||||||
|
- Episode 2
|
||||||
|
- Filename: `young_sheldon_S1_E2.mkv`
|
||||||
|
- File location: `/opt/lumière/files/young_sheldon/season_1/young_sheldon_S1_E2.mkv`
|
||||||
|
- etc.
|
||||||
|
- Season 2:
|
||||||
|
- Episode 1
|
||||||
|
- Filename: `young_sheldon_S2_E1.mkv`
|
||||||
|
- File location: `/opt/lumière/files/young_sheldon/season_2/young_sheldon_S2_E1.mkv`
|
||||||
|
|
||||||
|
# Adding film or series covers
|
||||||
|
Just put the picture's file aside the film or series episode video file.
|
||||||
|
|
||||||
|
## Example
|
||||||
|
- Film name: `Lord of the rings 1`
|
||||||
|
- Film filename: `lord_of_the_rings_1.mkv`
|
||||||
|
- File location: `/opt/lumière/files/lord_of_the_rings_1.mkv`
|
||||||
|
- Cover filename: `lord_of_the_rings_1.png`
|
||||||
|
- Cover file location: `/opt/lumière/files/lord_of_the_rings_1.png`
|
||||||
Reference in New Issue
Block a user