Skip to content

Commit 8d3da08

Browse files
committed
feat: add content docs
1 parent 47aec67 commit 8d3da08

File tree

18 files changed

+573
-32
lines changed

18 files changed

+573
-32
lines changed

docs/contribute.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
# Contributing to Documentation
2+
3+
Thank you for considering contributing to Riven Media! We welcome contributions from the community to help improve and expand the project. This guide will help you get started with the process of contributing.
4+
5+
## Table of Contents
6+
1. [How to Contribute](#how-to-contribute)
7+
2. [Setting Up Your Development Environment](#setting-up-your-development-environment)
8+
3. [Submitting Changes](#submitting-changes)
9+
4. [Community](#community)
10+
11+
---
12+
13+
## How to Contribute
14+
15+
### Reporting Bugs
16+
17+
If you find a bug, please report it by creating an issue on our [GitHub repository](https://github.com/rivenmedia/wiki/issues). Provide as much detail as possible, including steps to reproduce the issue and any relevant logs or screenshots.
18+
19+
### Suggesting Features
20+
21+
We welcome feature suggestions! To suggest a new feature, please create an issue on our [GitHub repository](https://github.com/rivenmedia/wiki/issues) and describe your idea in detail. Include any potential use cases and benefits of the feature.
22+
23+
### Contributing Code
24+
25+
1. Fork the repository on GitHub.
26+
2. Create a new branch for your feature or bugfix.
27+
3. Write clear and concise commit messages.
28+
4. Ensure your code follows the project's coding standards and passes all tests.
29+
5. Submit a pull request to the `main` branch.
30+
31+
## Setting Up Your Development Environment
32+
33+
To set up your development environment, follow these steps:
34+
35+
1. Clone the repository:
36+
```md
37+
git clone https://github.com/rivenmedia/wiki riven-wiki && cd riven-wiki
38+
```
39+
40+
2. Install the required dependencies:
41+
```md
42+
poetry install
43+
```
44+
45+
3. Start the development server:
46+
```md
47+
mkdocs serve -a 0.0.0.0:8282
48+
```
49+
50+
!!! note "Alternatively.."
51+
You can also use `make install` to install the dependencies, followed by `make serve` to start the development server.
52+
53+
## Submitting Changes
54+
55+
When submitting changes, please ensure the following:
56+
57+
1. Your commit messages follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification.
58+
2. Your pull request includes a clear description of the changes and the related issue (if applicable).
59+
60+
---
61+
62+
## Community
63+
64+
Join our community on [Discord](https://discord.gg/rivenmedia) to discuss the project, ask questions, and collaborate with other contributors.
65+
66+
Thank you for your contributions!
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

docs/index.md

Lines changed: 25 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -85,10 +85,11 @@ Whether you're a casual viewer or a media enthusiast, Riven offers a powerful, a
8585
Before installing Riven, ensure you have the following prerequisites:
8686

8787
!!! note
88-
* **Linux**: Riven only supports Linux-based operating systems and Windows Subsystem for Linux (WSL) in Windows.
89-
* **Rclone**: Required to mount debrid service. Additionally, Zurg is preferred for Real-Debrid users. [Learn more](/docs/rclone)
90-
* **Media Server**: Currently only Plex Media Server is supported.
91-
* **Docker**: Required to run Riven in a containerized environment. [Learn more](/docs/docker)
88+
* **Linux**: Riven only supports Linux-based operating systems.
89+
* **Windows**: Riven only supports Windows Subsystem for Linux (WSL) in Windows.
90+
* **Rclone**: Required to mount debrid service. Additionally, Zurg is preferred for Real-Debrid users. [Learn more](https://rclone.org/)
91+
* **Media Server**: Plex, Jellyfin, and Emby are supported.
92+
* **Docker**: Required to run Riven in a containerized environment. [Learn more](https://www.docker.com/)
9293

9394
!!! warning "Debrid Support"
9495
Currently only **Real-Debrid**, **All-Debrid** and **Torbox** are supported. More
@@ -229,37 +230,47 @@ This command will start the Riven services in the background. You can access the
229230

230231
Once Riven is running, you can configure it by accessing the web interface. You will be prompted with onboarding steps to set up your debrid service, media server, content services and scraper services.
231232

232-
There are 4 steps in the onboarding process:
233+
There are 4 steps in the onboarding process.
233234

234-
### General Settings
235+
---
236+
237+
### Step 1: General Settings
235238

236239
In this step you configure the downloaders (debrid services), rclone mount path, library path, subtitles, etc. See the image below for an example.
237240

238-
![step-1](/images/onboard/step1.png)
241+
![step-1](images/onboard/step1.png)
239242

240-
### Media Server
243+
---
244+
245+
### Step 2: Media Server
241246

242247
In this step you configure the media server and updater settings. See the image below for an example.
243248

244-
![step-2](/images/onboard/step2.png)
249+
![step-2](images/onboard/step2.png)
245250

246-
### Content Services
251+
---
252+
253+
### Step 3: Content Services
247254

248255
In this step you configure the content services like trakt, overseerr, etc. See the image below for an example.
249256

250-
![step-3](/images/onboard/step3.png)
257+
![step-3](images/onboard/step3.png)
258+
259+
---
251260

252-
### Scraper Services
261+
### Step 4: Scraper Services
253262

254263
In this step you configure the scraper services like torrentio, zilean, prowlarr, jackett, etc. See the image below for an example.
255264

256-
![step-4](/images/onboard/step4.png)
265+
![step-4](images/onboard/step4.png)
257266

258267
---
259268

269+
### Done!
270+
260271
Once you have completed the onboarding process, you will be greeted with a beautiful dashboard where you can manage your media library, request items, settings and many more in the future.
261272

262-
![step-5](/images/onboard/final.png)
273+
![step-5](images/onboard/final.png)
263274

264275
---
265276

docs/services/content/index.md

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
Riven supports various content services to help you manage and update your media library. Below is a list of the supported services, their configuration options, and examples of what to enter for each field.
2+
3+
### Available Services
4+
5+
- [Overseerr](#overseerr)
6+
- [Plex Watchlist](#plex-watchlist)
7+
- [Mdblist](#mdblist)
8+
- [Listrr](#listrr)
9+
- [Trakt](#trakt)
10+
11+
!!! note "Lists support multiple values"
12+
Some settings have lists that support multiple values. These are noted in the description of the setting.
13+
14+
- Example: `["value1", "value2"]`
15+
16+
---
17+
18+
## **Overseerr**
19+
20+
Overseerr is a request management and media discovery tool. It helps you manage requests for your media library.
21+
22+
- **enabled** (boolean): Boolean value to enable or disable the service. Default is true.
23+
- Example: `true`
24+
- **update_interval** (integer): The interval in seconds at which the service will check for updates. Default is 60 seconds.
25+
- Example: `60`
26+
- **url** (string): The URL of your Overseerr instance. Default is "http://localhost:5055".
27+
- Example: `"http://localhost:5055"`
28+
- **api_key** (string): The API key for accessing Overseerr.
29+
- Example: `"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"`
30+
- **use_webhook** (boolean): Boolean value to enable or disable the use of webhooks. Default is true.
31+
- Example: `true`
32+
33+
---
34+
35+
## **Plex Watchlist**
36+
37+
Plex Watchlist allows you to keep track of your desired media content.
38+
39+
- **enabled** (boolean): Boolean value to enable or disable the service. Default is true.
40+
- Example: `true`
41+
- **update_interval** (integer): The interval in seconds at which the service will check for updates. Default is 60 seconds.
42+
- Example: `60`
43+
- **rss** (list of strings): A list of RSS feed URLs for your Plex Watchlist.
44+
- Example: `["https://rss.plex.tv/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]`
45+
46+
---
47+
48+
## **Mdblist**
49+
50+
Mdblist is a service that provides curated lists of media content.
51+
52+
- **enabled** (boolean): Boolean value to enable or disable the service. Default is false.
53+
- Example: `false`
54+
- **update_interval** (integer): The interval in seconds at which the service will check for updates. Default is 300 seconds.
55+
- Example: `300`
56+
- **api_key** (string): The API key for accessing Mdblist.
57+
- Example: `"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"`
58+
- **lists** (list of strings): A list of Mdblist URLs for curated media lists.
59+
- Example: `["https://mdblist.com/lists/xxxxxxx/xxxxxxxxxx"]`
60+
61+
!!! note "lists also accept a list of ids"
62+
- Example: `["123456", "654321"]`
63+
64+
---
65+
66+
## **Listrr**
67+
68+
Listrr is a service for managing movie and show lists.
69+
70+
- **enabled** (boolean): Boolean value to enable or disable the service. Default is false.
71+
- Example: `false`
72+
- **update_interval** (integer): The interval in seconds at which the service will check for updates. Default is 300 seconds.
73+
- Example: `300`
74+
- **movie_lists** (list of ints): A list of IDs for movie lists.
75+
- Example: `[123456, 789012]`
76+
- **show_lists** (list of ints): A list of IDs for show lists.
77+
- Example: `[345678, 901234]`
78+
- **api_key** (string): The API key for accessing Listrr.
79+
- Example: `"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"`
80+
81+
---
82+
83+
## **Trakt**
84+
85+
Trakt is a service that helps you keep track of what you're watching and discover new content.
86+
87+
- **enabled** (boolean): Boolean value to enable or disable the service. Default is false.
88+
- Example: `false`
89+
- **update_interval** (integer): The interval in seconds at which the service will check for updates. Default is 60 seconds.
90+
- Example: `60`
91+
- **api_key** (string): The API key for accessing Trakt.
92+
- Example: `"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"`
93+
- **watchlist** (list of strings): A list of Trakt usernames.
94+
- Example: `["username1", "username2"]`
95+
- **user_lists** (list of strings): A list of Trakt user list URLs.
96+
- Example: `["https://trakt.tv/users/username/lists/xxxxxxxx"]`
97+
- **collection** (list of strings): A list of Trakt collection usernames.
98+
- Example: `["username1", "username2"]`
99+
- **fetch_trending** (boolean): Boolean value to enable or disable fetching trending content. Default is true.
100+
- Example: `true`
101+
- **trending_count** (integer): The number of trending items to fetch. Default is 10.
102+
- Example: `10`
103+
- **fetch_popular** (boolean): Boolean value to enable or disable fetching popular content. Default is true.
104+
- Example: `true`
105+
- **popular_count** (integer): The number of popular items to fetch. Default is 10.
106+
- Example: `10`

docs/services/downloaders/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Coming soon!

0 commit comments

Comments
 (0)