2022-04-01 01:40:39 +00:00
# Tube Archivist Companion
2022-04-03 14:59:20 +00:00
2022-04-01 01:40:39 +00:00
A browser extension to directly add videos from YouTube to Tube Archivist.
2022-04-09 07:04:21 +00:00
## Install
2022-04-28 09:17:14 +00:00
- 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 ).
2022-04-09 07:04:21 +00:00
## 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.
2022-04-16 05:45:03 +00:00
- **Storage**: Needed to store your connection details, needed to store your last visited YouTube link within the browser.
## 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.
2022-04-01 01:40:39 +00:00
## MVP or better *bearly viable product*
This is a proof of concept with the following functionality:
- Add your Tube Archivist connection details in the addon popup
- Add a download button to the pop up for youtube links
## Test this extension
2022-04-02 05:16:11 +00:00
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` .
2022-04-01 01:40:39 +00:00
- 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.
## Help needed
This is only minimally useful in this state. Join us on our Discord and please help us improve that.
## Note:
2022-04-15 17:03:21 +00:00
- This requires Tube Archivist v0.1.4 or later.
