Support
Getting help
One person writes Shunt and answers its mail. Replies can take a little longer than from a support desk, and they come from the person who wrote the code.
Write to support@shuntapp.com. Expect a reply within two business days. If four days pass with nothing, assume the message went astray and send it again rather than waiting.
What to put in the message
These four lines save a round of questions:
- Your macOS version, from the Apple menu, About This Mac.
- Your Shunt version, from Settings, General, Updates, in the line under Check Now.
- Which browsers are involved, and whether profiles are part of the problem.
- What you expected to happen and what happened instead.
If a specific link misbehaved, say what the link looked like. You can replace the parts you would rather not share, as long as the shape stays the same.
Before you write, the app may already answer it
Shunt records why it made each routing decision, and reading that back solves a good share of reports on the spot.
- Open Recent Links from the menu bar icon. Each row is one link that arrived.
- Hold Option while the menu is open and every row turns into Show Why; choose one to see the rule that matched and where the link was sent.
- Choose Show All Recent Links to open the window, where the search field narrows the list by link, application, rule or outcome.
If you need to include that detail in a message, copy the text out of that window rather than sending the whole log file, which contains every link you have opened recently.
Common situations
Links stopped coming to Shunt
Something else claimed the default browser, which macOS lets any browser do on launch. Open System Settings, Desktop & Dock, and set Default web browser back to Shunt.
Links clicked in cmux open inside cmux
cmux has its own built-in browser and keeps terminal links there by default, so they never reach Shunt. The simplest fix is to turn that browser off: in cmux’s Settings, clear Enable cmux Browser. To keep it but still send links to Shunt, open ~/.config/cmux/cmux.json (older cmux versions use settings.json in the same folder) and set "openTerminalLinksInCmuxBrowser" : false and "interceptTerminalOpenCommandInCmuxBrowser" : false inside its "browser" section. The first covers Cmd-click, the second covers open https://... typed in the shell. To keep localhost links inside cmux, leave both on and list the hosts to keep, such as "localhost", under "hostsToOpenInEmbeddedBrowser"; every other link then leaves cmux. cmux reloads the file on its own. In Shunt, a Cmd-clicked link arrives from cmux, so a rule with cmux as the source app matches it; a link from open arrives from the command line, like open in any terminal.
A browser profile is missing from the picker
Shunt reads profiles from each browser's own files and notices most changes on its own. If a new profile does not show up, open Settings, Browsers and click Reload. If it is still missing afterwards, tell us which browser and how the profile was created.
The picker did not appear
Usually a rule matched and routed the link silently, which is the intended behaviour. The picker also stays away while Shunt is paused or routing is off, and, when Skip the picker when nobody clicked is on in Settings, Advanced, for a link that arrived without a recent click or key press. Recent Links shows which of these applied to each link. If none should have, that is worth reporting.
Your licence key
Keys are issued by Polar when you buy. If yours did not arrive, check the address you used at checkout and its spam folder first, then write to us with the email address you paid with and we will look up the order.
Refunds
Fourteen days from purchase, no reason needed, in full. Ask at support@shuntapp.com. The full wording is on the refund page.
Reporting something security related
Shunt receives every link you click, so a flaw in it matters more than its size suggests. Send security reports to support@shuntapp.com with "security" in the subject and they go to the front of the queue. Please give it a reasonable window to be fixed before publishing.
Who you are writing to
Shunt is made by Nia D Pham, a sole proprietorship based in Vietnam. There is no ticket system and no first-line script; the reply comes from the person who wrote the code.