Skip to content

About

Run multiple instances of Tessera Remote on macOS. Launcher that opens the latest installed version with open -n.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Contributors Forks Stargazers Issues License LinkedIn

Logo

dpx_tr_again

run as many copies of Tessera Remote as you want on macOS

A tiny macOS launcher that opens a new instance of the highest-versioned Tessera Remote installed, so you can run multiple copies side by side.
» Project Here! »
Report Bug · Request Feature


Table of Contents

  1. About The Project
  2. Getting Started
  3. Usage
  4. How it works (make it yourself)
  5. Roadmap
  6. Contributing
  7. License
  8. Contact
  9. Acknowledgments

About The Project

**What it does.** `TesseraRemoteAgain.app` looks in `/Applications` for every `Tessera Remote*.app`, picks the highest version (a real version sort, so 3.10.0 beats 3.5.2), and launches it with `open -n`. If no copy is installed it shows an alert instead of failing silently.

Why. Tessera Remote (Brompton Technology's LED processor control app) is often needed more than once at the same time, for example to talk to several processors or systems at once. macOS normally refuses to start a second copy of an app that is already running. open -n forces a fresh instance, and this launcher wraps that in a double-clickable app that always targets the newest installed version, so it keeps working after you upgrade Tessera Remote and you never edit a path by hand.

Unofficial; not affiliated with or endorsed by Brompton Technology. "Tessera" is their trademark.

Keywords: run multiple instances of Tessera Remote on macOS, open second copy of Tessera Remote, Brompton Tessera multi-instance launcher, Mac open -n, LED processor control.

author(s): // www.dubpixel.tv - i@dubpixel.tv | other authors

Images

FRONT

FRONT

(back to top)

Built With

  • POSIX sh (no dependencies, no build step)
  • macOS open -n and osascript
  • sort -V for version ordering
  • GitHub Pages (Jekyll) for the project site

(back to top)

Getting Started

Prerequisites

  • macOS
  • At least one Tessera Remote*.app in /Applications or ~/Applications

Installation

Option A: build it locally (recommended). Nothing is downloaded as an app, so there is no transfer damage and macOS never quarantines it. It installs to ~/Applications:

curl -fsSL https://raw.githubusercontent.com/dubpixel/dpx_tr_again/main/install.sh | sh

Option B: DMG. Download TesseraRemoteAgain-vX.Y.Z.dmg from the Releases page, open it and drag the app onto Applications. (Downloaded apps are quarantined; see below.)

Then drag the app wherever you want it (Dock, Desktop, Stream Deck).

If macOS blocks it

This only applies to Option B or any copy that was emailed or downloaded. The app is not signed or notarized, so it is quarantined and macOS may say it "can't be opened" or is "damaged". Either:

  • open System Settings → Privacy & Security, scroll down and click Open Anyway, or

  • run this in Terminal (adjust the path):

    xattr -dr com.apple.quarantine ~/Downloads/TesseraRemoteAgain.app

If you get a "Tessera Remote not found" alert, the app isn't in /Applications or ~/Applications, or its name doesn't start with Tessera Remote.

(back to top)

Usage

Double-click TesseraRemoteAgain.app. Each launch opens another independent copy of the newest installed Tessera Remote. Launch it again for as many copies as you need.

Install a newer Tessera Remote and the launcher picks it up automatically.

How it works (make it yourself)

The concept. A macOS .app is just a folder. If it contains an executable file at Contents/MacOS/<name>, double-clicking the app runs that file, and the file can be a plain shell script. That's all this project is: a shell script wearing an app costume so you can double-click it, pin it to the Dock or put it on a Stream Deck.

The simplest possible version (hardcoded to one version of Tessera Remote):

mkdir -p ~/Applications/MyLauncher.app/Contents/MacOS

cat > ~/Applications/MyLauncher.app/Contents/MacOS/MyLauncher <<'EOF'
#!/bin/sh
open -n '/Applications/Tessera Remote 3.5.2.app'
EOF

chmod +x ~/Applications/MyLauncher.app/Contents/MacOS/MyLauncher

That is the whole trick:

  • #!/bin/sh on the first line tells macOS how to run the file.
  • open -n opens a new instance even when the app is already running. This is what lets you have multiple copies, which macOS refuses to do otherwise.
  • chmod +x (plus, not minus) marks the file executable. Without it, double-clicking does nothing.
  • Name the script the same as the .app folder.

It worked for the author without anything else, but other Macs can be fussier. A minimal Contents/Info.plist makes the bundle behave more reliably:

<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0"><dict>
  <key>CFBundleExecutable</key><string>MyLauncher</string>
  <key>CFBundleIdentifier</key><string>com.example.MyLauncher</string>
  <key>CFBundlePackageType</key><string>APPL</string>
</dict></plist>

So why is there more code in this repo? Everything beyond open -n exists to make the hardcoded path and version number go away:

Piece What it's for
Search /Applications and ~/Applications You never type or edit the location
sort -V version pick When Tessera Remote updates, the launcher opens the newest one automatically (3.10.0 beats 3.5.2)
"Not found" alert A clear message instead of a silent failure
install.sh Builds the app on your Mac so there is no download, no transfer damage and no quarantine
build.sh, icon, DMG Packaging for releases; not needed to use or copy the idea

If you only ever run one fixed version, the six-line version above is enough.

(back to top)

Roadmap

  • Open a new instance of Tessera Remote (open -n)
  • Always pick the highest installed version (v0.1.1)
  • Alert when Tessera Remote is not installed (v0.1.1)
  • Project site on GitHub Pages (v0.2.0)

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Top contributors:

contrib.rocks image

License

Distributed under the MIT License. Commercial use is allowed; keep the copyright notice and attribution. See LICENSE for more information.

Contact

Joshua Fleitell - i@dubpixel.tv

Project Link: https://github.com/dubpixel/dpx_tr_again

Acknowledgments

(back to top)

About

Run multiple instances of Tessera Remote on macOS. Launcher that opens the latest installed version with open -n.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages