mirror of
https://github.com/tubearchivist/browser-extension.git
synced 2024-11-05 11:40:13 +00:00
58 lines
3.3 KiB
Markdown
58 lines
3.3 KiB
Markdown
|
|
|
|
<h1 align="center">Tube Archivist Companion for your Browser</h1>
|
|
<div align="center">
|
|
<a href="https://www.tilefy.me" target="_blank"><img src="https://tiles.tilefy.me/t/tubearchivist-firefox.png" alt="tubearchivist-firefox" title="TA Companion Firefox users" height="50" width="190"/></a>
|
|
<a href="https://www.tilefy.me" target="_blank"><img src="https://tiles.tilefy.me/t/tubearchivist-chrome.png" alt="tubearchivist-chrome" title="TA Companion Chrome users" height="50" width="190"/></a>
|
|
</div>
|
|
|
|
## Core Functionality
|
|
A browser extension to bridge YouTube with [Tube Archivist](https://github.com/tubearchivist/tubearchivist). This extension allows you to do the following:
|
|
- Add your Tube Archivist connection details in the addon popup
|
|
- Add a download button to the popup for YouTube links
|
|
- Add a subscribe button to subscribe to channels and playlists
|
|
- Sync your cookies for yt-dlp.
|
|
|
|
|
|
|
|
## Install
|
|
- Firefox: The addon is available on the [Extension store](https://addons.mozilla.org/addon/tubearchivist-companion/).
|
|
- Chrome: The addon is available on the [Chrome Web Store](https://chrome.google.com/webstore/detail/tubearchivist-companion/jjnkmicfnfojkkgobdfeieblocadmcie).
|
|
|
|
## Update
|
|
After a new release here on GitHub, you'll get updates automatically in your browser. Due to the verification process, for Firefox this usually takes 1-2 hours, for Chrome 2-3 days.
|
|
|
|
## Permissions
|
|
- **Access your data for www.youtube.com**: Needed for the addon to know your current page on YouTube to send the link to Tube Archivist.
|
|
- **Storage**: Needed to store your connection details, needed to store your last visited YouTube link within the browser.
|
|
- **Cookie**: Needed to read your cookies for youtube.com to access restricted videos.
|
|
|
|
## Setup
|
|
- **URL**: This is where your Tube Archivist instance is located. Can be a host name or a IP address, use a full URL with protocol, e.g. *http://*.
|
|
- **Port**: Network port of TA.
|
|
- **API key**: You can find your API key on the settings page of your Tube Archivist instance.
|
|
|
|
A green checkmark will appear next to the *Save* button if your connection is working.
|
|
|
|
## Options
|
|
- **Sync YouTube cookies**: Send your cookies to TubeArchivist to use for yt-dlp requests.
|
|
|
|
## Test this extension
|
|
Use the correct manifest file for your browser. Either rename the browser specific file to `manifest.json` before loading the addon or symlink it to the correct location, e.g. `ln -s manifest-firefox.json manifest.json`.
|
|
- Firefox
|
|
- Open `about:debugging#/runtime/this-firefox`
|
|
- Click on *Load Temporary Add-on*
|
|
- Select the *manifest.json* file to load the addon.
|
|
- Chrome / Chromium
|
|
- Open `chrome://extensions/`
|
|
- Toggle *Developer mode* on top right
|
|
- Click on *Load unpacked*
|
|
- Open the folder containing the *manifest.json* file.
|
|
|
|
## Compatibility
|
|
- Verify that you are running the latest version of Tube Archivist as the API is under development and will change.
|
|
- For testing this extension between releases, use the *unstable* builds of Tube Archivist, only for your tesing environment.
|
|
|
|
## Help needed
|
|
Join us on [Discord](https://discord.gg/AFwz8nE7BK) and help us improve and extend this project.
|