All Collections
General support
Using your library on multiple Macs
Using your library on multiple Macs
Why you shouldn't use cloud services, and what to use instead.
Davey avatar
Written by Davey
Updated over a week ago

IconJar doesn't support the ability to use your library on multiple Macs natively. We also don't recommend using a service like iCloud, Dropbox, or Google Drive to upload your library to the cloud because they may break your library due to sync conflicts*. However, there's a viable workaround!

* The library will only break when the IconJar library is synced from both machines simultaneously.


Using Git as a workaround

The best way to use the same library on multiple Macs is Git, for example through GitHub or Bitbucket. It allows you to push updates manually, and get your library in sync on other Macs by pulling the changes from Git. As a bonus; it gives you versioning for free!

We recommend using apps like Tower (paid) or Sourcetree (free) since they make it significantly more straightforward (and less scary) to use Git. Here's how to pull / push with Tower, and this is how it works in Sourcetree.

Add support for Git to your existing library:

Note: To complete these steps you'll need a remote repository.

Step 1: Locate the library on your Mac

Open IconJar's preferences β†’ Library β†’ double click the Library breadcrumb. This should open a Finder tab of where your library is stored.

Step 2: Navigate to the library with your Mac's

Type cd and drag and drop your library onto the Terminal window. You should see something like this after you hit return:

Screenshot of the terminal on the Mac

Step 3: Initialise Git and make your first commit

Paste the following in your terminal:

git init
git add .
git commit -m "Convert to Git library"

Step 4: Configure the remote repository

Paste the following in your terminal and make sure to check the user- and repository names:

git remote add origin https://github.com/{yourusername}/ij-library.git

Step 5: Push your library to the repository

Paste the following in your terminal and you're done. Make sure to check the branch your GitHub repository is using. In some cases your branch will be called main, but in others it's master.

git push -u origin main

Did this answer your question?