Welcome to Thunderbird Add-ons.
Add extra features and styles to make Thunderbird your own.Close
About this Add-on
Seams provides some integration with Patchwork, the patch tracking system. It makes the patch state visible directly from Thunderbird. It also displays useful links to the patch or its series on a Patchwork instance or in mail archives, and ready-to-paste commands that can be used to apply the patch locally.
At this time the add-on only works for the Linux Patchwork instance. This is simply because it has not been tested on other instances, and could maybe be adapted in the future.
Whenever a patch is displayed, Seams displays an action button above the message. The colored badge on that button indicates the current state of the patch, as retrieved from Patchwork.
On clicking the button, a panel appears and displays:
- The name of the Patchwork project for the patch.
- The state of the patch (for example,
- The state of CI checks, with expandable details if any. Click to load and
expand the details.
- Links to the Patchwork pages for the patch and the series to which it belongs. Clicking the links open the pages in the panel. You can right-click on the links to open them in a browser or to copy the targets.
- Links to the mail archives (for example, lore.kernel.org).
- Commands to apply the patch or its full series to a local Git repository. Click on the command to copy it to the clipboard.
The button is not displayed when the message is not recognized as a patch, or when the add-on fails to retrieve metadata from Patchwork.
Patch detection currently works as follows:
- The message must have a specific substring in one of the recipient addresses (“to” or “cc”), for example
- The subject of the message must begin with a
[character, this is to avoid considering replies to patches as patches.
- The subject of the message must not contain the substring
0/, which is often the marker of a cover letter for a series and not of a patch.
When a message is displayed and recognized as a patch, the add-on sends an API request to the Patchwork instance to retrieve the state of the patch as well as some metadata. On clicking the action button, this information is reused to generate the panel.
This add-on is not an official add-on either developed, supported or otherwise endorsed by the community of the Patchwork project.