Skip to content

Sidekey 1.3.0 (Citrix Viewer, Pair Device)

Choose a tag to compare

View all tags
@hoquem hoquem released this 08 Oct 15:41
· 64 commits to main since this release
v1.3.0
a2f4217

Sidekey for Mac 1.3.0 adds a layout for Citrix Viewer, so your iPad can send Windows shortcuts into a Citrix session. Pairing is now called Pair Device.

Citrix Viewer

With a Citrix session in front, the iPad shows Windows keys and sends them into the session.

  • Modes. Sidekey cannot see which Windows app is in front inside the session, so you choose a mode on the bottom row:
    • The row holds Windows, Outlook, Browser, VS Code and More.
    • More opens Word, Excel and Teams.
    • The lit key and the top of the screen show the current mode, and Sidekey remembers it when you switch away and back.
  • Windows mode: Start, Ctrl+Alt+Del, File Explorer, Show Desktop, Lock, Switch App, Snap Left and Right, Close App and Undo.
  • Hold keys: Lock, Close App and Teams' Leave need a press and hold.
  • Sources: shortcuts come from Microsoft's published Windows shortcut lists for Windows, classic Outlook, Word, Excel, Teams and VS Code, and the shortcuts Chrome and Edge share.
  • Requirements:
    • iPad build 5 or later (TestFlight build 5 for beta testers, or build it from source at v1.3.0). Earlier iPad builds cannot read the new Windows keys: they keep showing the previous layout while Citrix is in front, and refuse taps with "Layout changed. Tap again."
    • Citrix keyboard settings. In Citrix Viewer › Settings › Keyboard:
      • Send Control character using: Command (left) or Control.
      • Send Alt character using: Command (left)-Option.
      • Send Windows logo key using Command (right): on.
      • Send F1 - F12 keys with Option: on.

Also new

  • Pair Device. The Sidekey menu now says Pair Device... and Forget Paired Devices (formerly Forget Paired iPads), and messages say "device" instead of "iPad". If a code is wrong, the message points to the Pair Device window.
  • The iPad keeps looking for your Mac. iPad build 5 restarts its search if it stops, for example after the iPad was locked. Earlier builds could stay on "Reconnecting" until the app was force-quit and reopened.

Install or update

  1. Quit Sidekey if it is running. Download Sidekey.dmg below, open it and drag Sidekey to Applications, replacing the old copy.
  2. Open Sidekey from Applications. It lives in the menu bar.
  3. If keys stop working after updating, open System Settings › Privacy & Security › Accessibility, remove Sidekey with the minus button, add it back with the plus button and switch it on.
  4. A paired iPad stays paired. For the Citrix layout, update the iPad app to build 5 or later: TestFlight build 5 for beta testers, or build it from source at v1.3.0.

Requires macOS 13 or later. Signed with Developer ID and notarized by Apple.

Known limits

  • Not encrypted yet. Traffic between the iPad and the Mac is not encrypted yet. Use Sidekey over USB or on a network you trust. See the 1.1.0 notes for details. Encryption is planned.
  • Untested Citrix keys. Tried in a live session so far: switching between all modes, Start, Ctrl+Alt+Del, File Explorer, Show Desktop, Snap Left and Right, Switch App, Close App, Undo, Outlook's New Email and Forward, and the Browser keys. The rest, including Lock, the other Outlook keys (such as Delete, Ctrl+D) and the Word, Excel, Teams and VS Code keys, have not been tried yet. If a key does the wrong thing, please open an issue.
  • Task View is left out. Win+Tab would be sent as right Command + Tab, which macOS takes for its own app switcher.
  • New Email uses classic Outlook's shortcut (Ctrl+Shift+M). New Outlook uses Ctrl+N, which no key sends yet.
  • AutoSum may clash with macOS Zoom. Excel's AutoSum is sent as Command + Option + =, which conflicts with macOS zoom shortcuts if those are turned on.
  • Do Not Disturb. The key runs a shortcut named Toggle Focus, which you create in the Shortcuts app.
  • Zoom meeting state is built from Zoom's documented menus and has not yet been tested in a live meeting.

SHA-256: 2be1609cedd7da451e46a22001193c0926cd011231ca572818e5939f44763839

Assets 3
Loading