52 lines
1.5 KiB
Markdown
52 lines
1.5 KiB
Markdown
# Seasonal Lists Documentation
|
|
|
|
This document explains how to use seasonal lists with the Jellyfin Spotlight system.
|
|
|
|
## Configuration
|
|
|
|
To enable seasonal lists, set `useSeasonalLists = true` in the main script.js file.
|
|
|
|
## Seasonal Periods
|
|
|
|
The system automatically detects the following periods:
|
|
|
|
### Special Events (take precedence over seasons)
|
|
- **New Year**: January 1-7 → `newyear_list.txt`
|
|
- **Valentine's day**: February 10-20 → `valentine_list.txt`
|
|
- **Easter**: 1 week around Easter Sunday → `easter_list.txt`
|
|
- **Halloween**: October 20-31 → `halloween_list.txt`
|
|
|
|
### Regular Seasons
|
|
- **Spring**: March-May → `spring_list.txt`
|
|
- **Summer**: June-August → `summer_list.txt`
|
|
- **Autumn**: September-November → `autumn_list.txt`
|
|
- **Winter**: December-February → `winter_list.txt`
|
|
|
|
## List Files
|
|
|
|
Create the following files in your `featured` directory:
|
|
|
|
- `spring_list.txt` - Spring movies/shows
|
|
- `summer_list.txt` - Summer movies/shows
|
|
- `autumn_list.txt` - Autumn movies/shows
|
|
- `winter_list.txt` - Winter movies/shows
|
|
- `newyear_list.txt` - New Year themed content
|
|
- `valentine_list.txt` - Romance/Valentine themed content
|
|
- `easter_list.txt` - Easter/Family themed content
|
|
- `halloween_list.txt` - Horror/Halloween themed content
|
|
|
|
## File Format
|
|
|
|
Each seasonal list file follows the same format as the main `list.txt`:
|
|
|
|
```
|
|
Title of List [muteon/muteoff]
|
|
movie_id_1
|
|
movie_id_2
|
|
series_id_1
|
|
...
|
|
```
|
|
|
|
## Fallback
|
|
|
|
If seasonal lists are disabled or a seasonal file doesn't exist, the system will fall back to using the default `list.txt` file. |