mirror of
https://github.com/Viren070/stremio-gdrive-addon.git
synced 2025-12-01 23:20:04 +01:00
Viren070
236 lines
25 KiB
Markdown
236 lines
25 KiB
Markdown
# Stremio GDrive Addon
|
|
|
|
This is a simple addon for Stremio that allows you to watch videos from Google Drive.
|
|
|
|
It searches your entire Google Drive and any shared drives you have access to for videos and presents them in Stremio.
|
|
|
|
If you combine it with some team drives, you have loads of content, all available to watch for free and without torrenting.
|
|
|
|
|
|
|
|
## Features
|
|
|
|
- Search your Google Drive and shared drives for videos
|
|
- Parses filenames for information accurately using regex and displays it in a appealing format.
|
|
- Catalog support - both search and full list on home page
|
|
- Kitsu support.
|
|
- TMDB Meta support if TMDB api key is provided.
|
|
- Easily configurable using the `CONFIG` object at the top of the code. (See [Configuration](#configuration))
|
|
- Change the addon name
|
|
- Change the order of resolutions, qualities, visual tags, and filter them out if unwanted
|
|
- Change the sorting criteria (resolution, quality, size, visual tags)
|
|
- Prioritise specific languages and have them show up first in the results
|
|
- Only requires a single deployment with one file, making it easy to deploy and make changes.
|
|
|
|
## Deployment
|
|
|
|
This addon is designed to be deployed as a worker on Cloudflare Workers.
|
|
|
|
Here is a guide to deploying this addon, taken from my site: [Viren070's guides](https://guides.viren070.me/stremio/addons/stremio-gdrive). This will most likely be easier to follow on my site, however.
|
|
|
|
|
|
### Setting up our Google App
|
|
|
|
1. Go to the [Google Cloud Console](https://console.cloud.google.com/).
|
|
|
|
If this is your first time using Google Cloud, you will be prompted to agree to the terms of service:
|
|
|
|
|
|
|
|
2. Create a new project and select it:
|
|
|
|
<details>
|
|
<summary>How?</summary>
|
|
|
|
1. Click on `Select a project` in the top left:
|
|
|
|
|
|
|
|
2. Click on `New Project`:
|
|
|
|
|
|
|
|
3. Enter a project name and click on `Create`:
|
|
|
|
|
|
|
|
- The project name can be anything you want, e.g., `Stremio-Gdrive`. Leave the `Organization` field blank.
|
|
|
|
4. Once the project has been created, you will get a notification:
|
|
|
|
|
|
|
|
- Click `Select Project`.
|
|
|
|
:::note
|
|
You may also use the same dropdown from step i to select the project.
|
|
:::
|
|
|
|
</details>
|
|
|
|
3. Setup our Google Auth Platform
|
|
|
|
1. Go to the [Google Cloud Console](https://console.cloud.google.com/).
|
|
2. In the search bar at the top, search for `Google Auth Platform` and click on the result:
|
|
|
|
|
|
|
|
3. You should be met with a message telling you that `Google Auth Platform not configured yet`, click on `Get Started`:
|
|
|
|
|
|
|
|
4. Fill in the form:
|
|
|
|
|
|
|
|
1. `App Information`:
|
|
- Set `App Name` to `Stremio GDrive`.
|
|
- Set `User Support Email` to your email. It should appear in the dropdown.
|
|
2. `Audience`:
|
|
- Set `User Type` to `External`.
|
|
3. `Contact Information`
|
|
- Add any email address, you can use the same one you used earlier for `User Support Email`.
|
|
4. `Finish`
|
|
- Check the box to agree to the `Google API Services: User Data Policy`
|
|
|
|
|
|
5. Once you have filled in the form, click on `Create`
|
|
|
|
4. Enable the Google Drive API.
|
|
|
|
1. Go to the [Google Cloud Console](https://console.cloud.google.com/).
|
|
2. In the search bar at the top, search for `Google Drive API` and click on the result:
|
|
|
|
|
|
|
|
3. Click on `Enable`:
|
|
|
|
|
|
|
|
5. Create an OAuth client.
|
|
|
|
1. Go back to the `Google Auth Platform` page.
|
|
2. Click on `Clients` in the sidebar and then click on `+ Create Client`:
|
|
|
|
|
|
|
|
3. Fill in the form:
|
|
|
|
|
|
|
|
- `Application Type`: Set this to `Web application`.
|
|
- `Name`: You can set this to anything such as `Stremio GDrive`.
|
|
- `Authorized redirect URIs`: Set this to `https://guides.viren070.me/oauth/google/callback`
|
|
|
|
|
|
4. Click on `Create`.
|
|
|
|
6. Publish the app.
|
|
|
|
1. Go back to the `Google Auth Platform` page.
|
|
2. Click on `Audience` in the sidebar and then click on `Publish`:
|
|
|
|
|
|
|
|
|
|
### Setting up the Cloudflare Worker
|
|
|
|
1. Go to the [Cloudflare Workers](https://workers.cloudflare.com/) page and click `Log In` or `Sign Up` if you don't have an account.
|
|
|
|
2. Once logged in, you should be taken to the Cloudflare Workers & Pages dashboard. Click on `Create`:
|
|
|
|
|
|
|
|
3. Once on the create page, make sure you're on the `Workers` tab and click `Create Worker`:
|
|
|
|
|
|
|
|
4. You'll be asked to give a name to your worker. You can name it anything, this will be the URL you enter into Stremio to access your addon. Click `Deploy` once named.
|
|
|
|
|
|
|
|
5. Once its done being deployed, you should be shown a success message. Click the `Edit code` button:
|
|
|
|
|
|
|
|
6. You should be taken to the Cloudflare Worker editor:
|
|
|
|
|
|
|
|
7. Now, we need to obtain the code for the addon that we will use specific to our Google Drive.
|
|
First, we need to obtain our `Client ID` and `Client Secret` from the Google Cloud Console.
|
|
|
|
1. Go to the [Google Cloud Console](https://console.cloud.google.com/).
|
|
|
|
2. In the search bar at the top, search for `Google Auth Platform` and click on the result:
|
|
|
|
|
|
|
|
3. Click on `Clients` and click on the download icon for the client you created earlier:
|
|
|
|
|
|
|
|
4. A pop-up will appear with your `Client ID` and `Client Secret`.
|
|
|
|
|
|
|
|
5. You can click the copy icons to copy the `Client ID` and `Client Secret` to your clipboard for the next step.
|
|
|
|
8. Now, we can get the code for the Cloudflare Worker.
|
|
|
|
1. Go to the [OAuth Tool](https://guides.viren070.me/oauth/google)
|
|
|
|
2. Fill in the form with the `Client ID` and `Client Secret` from the previous step.
|
|
|
|
3. Click `Authorise`
|
|
|
|
4. Sign in with your Google account and allow the app to access your Google Drive.
|
|
|
|
> You may encounter a warning page saying `Google hasn't verified this app`, click on `Advanced` and then `Go to... (unsafe)`.
|
|
>
|
|
> This warning is because the app is not verified by Google. This is normal for self-hosted apps.
|
|
|
|
5. You will be redirected back to the OAuth Tool with a success message. Click `Get Addon Code`.
|
|
|
|
6. You should be shown another success message. Then, make sure you're on the `Viren070` tab and you should see a block of code. Copy this code.
|
|
|
|
7. Go back to the Cloudflare Worker editor and after removing the existing code, paste the code you copied.
|
|
|
|
8. Your code should look something like this:
|
|
|
|
|
|
|
|
10. Click `Deploy` in the top right to save your changes and deploy the worker.
|
|
|
|
11. Once deployed, you should see a green success message at the bottom. Click `Visit` next to the deploy button to go to the addon URL.
|
|
|
|
12. You should be redirected to the /manifest.json. if not, append `/manifest.json` to the URL in the address bar.
|
|
|
|
13. Copy the URL and [add it to Stremio](https://guides.viren070.me/stremio/faq#how-do-i-install-an-addon-manually).
|
|
|
|
Done! You have now set up your own addon which will allow you to stream videos from your drives and team drives.
|
|
|
|
## Configuration
|
|
|
|
Although you may modify the code as you wish, I have supplied a `CONFIG` object at the top of the code after `CREDENTIALS` that allows you to easily
|
|
configure some aspects of the addon.
|
|
|
|
> [!NOTE]
|
|
>
|
|
> Unless stated otherwise, all values are case sensitive
|
|
|
|
This table explains the configuration options:
|
|
|
|
| Name | Type | Values | Description |
|
|
|:-------------------------------------: |:------------------: |-------------------------------------------------------------------------------------------------------------------------------------------------- |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `resolution` | `String[]` | `"2160p"`, `"1080p"`, `"720p"`, `"480p"`, `"Unknown"` | This setting allows you to configure which resolutions are shown in your results. You may also change the order of this to change the order that the resolutions would show in the addon (if you sort by resolutions)<br><br>You can remove certain resolutions to not have them show up in your results. The Unknown resolution occurs when the resolution could not be determined from the filename.<br><br>You cannot add new resolutions to this list unless you also add the corresponding regex in the `REGEX_PATTERNS` object. |
|
|
| `qualities` | `String[]` | `"BluRay REMUX"`, `"BluRay"`, `"WEB-DL"`, `"WEBRip"`, `"HDRip"`, `"HC HD-Rip"`, `"DVDRip"`, `"HDTV"`, `"CAM"`, `"TS"`, `"TC"`, `"SCR"`, `"CAM"` | This setting allows you to configure which qualities are shown in your results. You may also change the order of this list to change the priority of them when sorting by quality. (e.g. if you put CAM/TS at the top of the list and sorted by quality, then CAM/TS results would appear higher than other qualities)<br><br>Remove qualities from the list to remove them from your results. The Unknown quality occurs when one of the existing qualities could not be found in the filename.<br><br>You cannot add new qualities to this list unless you also add the corresponding regex in the `REGEX_PATTERNS` object. |
|
|
| `visualTags` | `String[]` | `"HDR10+"`, `"HDR10"`, `"HDR"`, `"DV"`, `"IMAX"`, `"AI"` | This setting allows you to configure which visualTags are shown in your results. You can also change the order of this to change the priority of each visual tag when sorting by `visualTag` (e.g. If you were sorting by visualTag and moved IMAX to the front, and removed AI, then any results with the AI tag will be removed and any results with the IMAX tag will be pushed to the front)<br><br>You cannot add new visual tags to this list unless you also add the corresponding regex in the `REGEX_PATTERNS` object. |
|
|
| `sortBy` | `String[]` | `"resolution"`, `"quality"`, `"size"`, `"visualTag"` | Change the order of this list to change the priority for which the results are sorted by.<br><br>`resolution` - sort by the resolution of the file e.g. 1080p, 720p. The better the resolution (determined by the resolution's position in the `resolution` list) the higher the result.<br>`quality` - sort by the quality of the file, e.g. BluRay, WEBRip. The better the quality (determined by the quality's position in the `qualities` list) the higher the result.<br>`size` - sort by the size of file e.g. 12GB. The higher the size the higher they show in the results.<br>`visualTag` - sort by the priority of the visual tags. Files with a visual tag are sorted higher and between files that both have visual tags, the order of the visual tag in the `visualTags` list will determine their order.<br><br>Examples:<br><br>If you want all 2160p results to show first with those results being sorted by size, then do resolution, then size<br>If you want results to be sorted by size regardless of resolution, only have size in the list.<br>If you want to see all HDR results first, and sort those results and the rest by size, then put `visualTag` and `size` in the list. |
|
|
| `considerHdrTagsAsEqual` | `boolean` | `true`, `false` | When sorting by visualTag, if this value is set to false, the HDR tags (HDR, HDR10, HDR10+) will be considered differently, and depending on their position in the visualTags list, they will be sorted accordingly. <br><br>For example, if HDR10+ was placed first, then all HDR10+ files will appear first, regardless of if there are HDR files that rank higher based on other factors.<br><br>With this value set to true, all HDR tags are considered equal and if you were sorting by `visualTag`, then `size`, a HDR file could appear above a HDR10+ file if the size of the HDR file was greater. |
|
|
| `addonName` | `String` | any | Change the value contained in this string to change the name of the addon that appears in Stremio in the addon list<br>and in the stream results. |
|
|
| `prioritiseLanguage` | `String` \| `null` | See the languages object in the `REGEX_PATTERNS` object for a full list.<br><br>Set to `null` to disable prioritising specific language results. | By setting a prioritised language, you are pushing any results that have that language to the top.<br><br>However, parsed information about languages may be incorrect and filenames do not contain the language<br>that is contained within the file sometimes. |
|
|
| `proxiedPlayback` | `boolean` | `true`, `false` | With `proxiedPlayback` enabled, the file will be streamed through the addon. If it is disabled, Stremio will stream directly from Google Drive. <br><br>If this option is disabled, streaming will not work on Stremio Web or through external players on iOS. You are also exposing your access token in the addon responses. <br><br>However, this option is experimental and may cause issues.<br><br>I recommend leaving it enabled, and only if you encounter issues, try disabling this option. <br><br>Note, that even with this enabled, anyone with your addon URL can still view your Google Drive files. |
|
|
| `driveQueryTerms.`<br>`episodeFormat` | `String` | `"name"`, `"fullText"` (see the Drive v3 API for more) | This setting changes the object that we perform the queries upon for the episode formats (s01e03).<br><br>I recommend leaving this to fullText. However, if you are getting incorrect matches, try switching to name |
|
|
| `driveQueryTerms.`<br>`movieYear` | `String` | `"name"`, `"fullText"` | This setting changes the object that we perform queries upon for the release year of the movie.<br><br>I recommend leaving this to name. However, if you are getting incorrect matches, try switching to fullText. |
|