Skip to content

Migration Guide

Tomy Hsieh edited this page Feb 10, 2023 · 2 revisions

If you did not have Coinc installed before, you could do a fresh install following the latest Installation & Setup guide

From v2 to v3

The best way to upgrade to v3 is actually removing and installing from Alfred Gallery since it will do the heavy lifting for future updates, and it's more vulnerable to unexpected behavior.

The old configuration is set with environment variables, and they have now been migrated to Alfred's user configuration sheet. You should see a beautiful form when installing to guide you through the setup process. If you bump into any problems, the Wiki is always available.

The behavior of Coinc should not be much different from older versions. However, I highly suggest you check out the Optimize section in the user guide to enhance your experience with Coinc.

From v1.3 to v2

Following the release of macOS 12.3, Apple has decided not to include builtin Python this workflow makes use of.

Therefore, to make the workflow continue to work, you now need to install python3 by yourselves.

To make things more smooth and more consistent, only homebrew python is supported.

  1. Install Homebrew

Install Homebrew following the official guide

  1. Install Python 3 with Homebrew
brew install python

Normally, any Python 3 should work

Final Notes

  • For advanced users, you can manually change the python3 executable used, but I can't guarantee everything to work as expected
  • Try a clean reinstall of the workflow and python if it fails. Open an issue and detail your macOS, Alfred, or Python version if you still can't make it work, and I'll see if I can help ASAP

From v1.2 to v1.3

For new users (who don't install any version prior to v1.2.0), you can follow the normal Installation & Setup Guide.

For old users (who have installed any version prior to v1.2.0), auto-update should bring all your existing data to the new version. However, if you encountered any problems, read the guide below.

If you do not bother losing your existing favorite currencies, a quick fixup...

  • Remove two directories (type the magic argument cur workflow:opendata in Alfred can help navigate to these directories)
    • ~/Library/Application Support/Alfred/Workflow Data/tech.tomy.coinc
    • ~/Library/Application Support/Alfred/Workflow Data/tech.tomy.coon
  • Open Alfred Preference, remove the workflow
  • Reinstall by following the Installation & Setup Guide.

If you have a long favorites currencies list and prefer not to reinstall and rebuild the workflow...

  • Open ~/Library/Application Support/Alfred/Workflow Data in Finder (type the magic argument cur workflow:opendata in Alfred can help navigate to this directory)
  • Find settings.json from either tech.tomy.coon or tech.tomy.coinc, and make a copy of this file
  • Make sure there is only the tech.tomy.coinc directory and remove tech.tomy.coon if it exists
  • Place settings.json under the tech.tomy.coinc directory
  • Open Alfred Preference > Workflows, right-click on Conic, choose Edit Details
  • Change Bundle Id to tech.tomy.coinc if it's not
  • Quit and relaunch Alfred. Everything should work now
Clone this wiki locally