Update Installation

Marcel Kapfer 2024-12-11 23:18:13 +01:00
parent 488d27880e
commit bc17b71fcd

@ -6,17 +6,23 @@ At the point of writing (2024-07-29) the maintainer considers the add-on to be i
This is the reason why the add-on is currently not published at the Thunderbird Add-On Marketplace. Nevertheless, this may change at some point in the future. If it will be published users who installed SpaceApper previously might need to manually migrated their data. In this case I will warn in advance and provide further instructions. This is the reason why the add-on is currently not published at the Thunderbird Add-On Marketplace. Nevertheless, this may change at some point in the future. If it will be published users who installed SpaceApper previously might need to manually migrated their data. In this case I will warn in advance and provide further instructions.
## Download ## From Thunderbird Add-ons
Search for "SpaceApper" in the Thunderbird Add-Ons Manager and install it.
## Manually
### Download
Given you read the warning above and you're willing to take the involved risk, you can download the lasted version from the [releases](https://git.mmk2410.org/mmk2410/SpaceApper/releases/latest) page. The correct file is the one with the `.xpi` file extension. Given you read the warning above and you're willing to take the involved risk, you can download the lasted version from the [releases](https://git.mmk2410.org/mmk2410/SpaceApper/releases/latest) page. The correct file is the one with the `.xpi` file extension.
## Installation ### Installation
Open the "Add-ons and Themes" page from the Hamburger menu in the top right corner. Make sure that the "Extensions" tab is selected on the left side. Then click on the cog icon just below the search field on the upper left part of the centre view. Open the "Add-ons and Themes" page from the Hamburger menu in the top right corner. Make sure that the "Extensions" tab is selected on the left side. Then click on the cog icon just below the search field on the upper left part of the centre view.
Choose the menu entry "Install Add-On From File...", select the `.xpi` file downloaded in the previous step and install it by clicking "Open". Choose the menu entry "Install Add-On From File...", select the `.xpi` file downloaded in the previous step and install it by clicking "Open".
## Permissions ### Permissions
Some web apps allow list only certain user agents, e.g. Asana. Since Thunderbird ships more or less the entire Firefox web engine but sets their own user agent you may be prohibited from accessing those apps. Some web apps allow list only certain user agents, e.g. Asana. Since Thunderbird ships more or less the entire Firefox web engine but sets their own user agent you may be prohibited from accessing those apps.
@ -24,7 +30,7 @@ The extension can inject a recent Firefox user agent (pretending to be Microsoft
It is unclear if this is a faulty implementation in the Add-On or if Add-Ons installed from a file just cannot do this. Albeit, if you need it, you can manually enable it. For this, click on the entry of the add-on in the extensions view and choose the "Permissions" tab there. Then activate the checkbox for the entry "Access your data for all websites". It is unclear if this is a faulty implementation in the Add-On or if Add-Ons installed from a file just cannot do this. Albeit, if you need it, you can manually enable it. For this, click on the entry of the add-on in the extensions view and choose the "Permissions" tab there. Then activate the checkbox for the entry "Access your data for all websites".
## Usage ### Usage
There is also a more elaborate [usage documentation](Usage) available, but the important part is covered here in as few words as possible. There is also a more elaborate [usage documentation](Usage) available, but the important part is covered here in as few words as possible.
@ -34,9 +40,9 @@ Finally apply and persist your changes by click the purple "Save" button.
**Warning: Currently open tabs might be closed. Make sure you saved your work!** **Warning: Currently open tabs might be closed. Make sure you saved your work!**
## Update ### Update
Repeat the steps from above. Sadly, there is no alternativ as of now. Repeat the steps from above.
If you would like to get notified once a new version get released, you may subscribe to the [Releases RSS feed](https://git.mmk2410.org/mmk2410/SpaceApper/releases.rss). If you would like to get notified once a new version get released, you may subscribe to the [Releases RSS feed](https://git.mmk2410.org/mmk2410/SpaceApper/releases.rss).