teams-pwa-link-redirect

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #golang #android #deep-learning #linux #nodejs #windows #cli #awesome-list #openai #open-source

teams-pwa-link-redirect

(★ 18)

open all links in firefox while using chrome

teams-pwa-link-redirect Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Why?

The native Microsoft Teams application for Linux is not well maintained, so we switched to the [Teams PWA in Google Chrome](https://techcommunity.microsoft.com/t5/microsoft-teams-blog/microsoft-teams-progressive-web-app-now-available-on-linux/bc-p/3674458/highlight/true#M11387%2309), which works rather well.
We still want to use firefox as our default browser without maintaining active login sessions in multiple browsers. Clicking links in teams therefor becomes a bit annoying.

## How does it work?

This little experiment introduces two new schemes for (ftl and ftls for **f**irefox **t**eams **l**inks) and an browser extension for chrome (works for edge as well). Clicked links in the Teams PWA are opened in Chrome and the extension modifies https to ftls and http to ftl, which causes Chrome to prompt for approval to open the `FTL Handler`. The FTL Handler is defined by the `firefox-ftl.desktop` file, which reverts the http/https replacement and opens the links in firefox.

Links to `teams.microsoft.com`, `login.microsoftonline.com`, `outlook.office.com` and `outlook.office365.com` (and their subdomains) are left alone so that internal Teams navigation and sign-in flows keep working inside the PWA.

To avoid dropping an active Teams call when a link is clicked, the redirect is triggered via a short-lived hidden iframe instead of navigating the top-level document.

## Installation

1. clone this repo `git clone git@github.com:frederic-klein/teams-pwa-link-redirect.git`
1. make the firefox-ftl.desktop file available in your system: `sudo cp ubuntu/firefox-ftl.desktop /usr/share/applications/`
1. install the chrome extension
    1. open chrome
    1. go to [chrome://extensions/](chrome://extensions/)
    1. enable developer mode
    1. select Load unpacked
    1. select the cloned repo folder
    1. reopen the teams pwa or `ctrl+f5`
1. associate the schemes with the desktop file:
```BASH
xdg-mime default firefox-ftl.desktop x-scheme-handler/ftl
xdg-mime default firefox-ftl.desktop x-scheme-handler/ftls
```

### Bypassing the `Open FTL Handler` Prompts

Chrome may display an "Open FTL Handler" prompt, which can only be permanently accepted per-domain.

You can define a policy to accept the custom protocol using the following command based on https://superuser.com/a/1588146

#### chrome

```bash
sudo bash
mkdir -p /etc/opt/chrome/policies/{managed,recommended}
cat <<EOF >/etc/opt/chrome/policies/managed/allow_ftl_protocol.json
{
  "URLWhitelist": [
    "ftl:*", "ftls:*",
  ],
  "URLAllowlist": [
    "ftl:*", "ftls:*",
  ]
}
EOF
```

#### chromium

```bash
sudo bash
mkdir -p /etc/chromium/policies/{managed,recommended}
cat <<EOF >/etc/chromium/policies/managed/allow_ftl_protocol.json
{
  "URLWhitelist": [
    "ftl:*", "ftls:*",
  ],
  "URLAllowlist": [
    "ftl:*", "ftls:*",
  ]
}
EOF
```

#### edge

```bash
sudo bash
mkdir -p /etc/opt/edge/policies/{managed,recommended}
cat <<EOF >/etc/opt/edge/policies/managed/allow_ftl_protocol.json
{
  "URLWhitelist": [
    "ftl:*", "ftls:*",
  ],
  "URLAllowlist": [
    "ftl:*", "ftls:*",
  ]
}
EOF
```

## Contributors

Thanks to the following contributors for improving this helper ♡

* Ryan Cole https://github.com/ryanc-me
* Freubert https://github.com/Freubert — fix for Teams calls being dropped when clicking a link (hidden-iframe redirect, [#12](https://github.com/frederic-klein/teams-pwa-link-redirect/pull/12))

teams-pwa-link-redirect

teams-pwa-link-redirect Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

teams-pwa-link-redirect

teams-pwa-link-redirect Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README