Download + Install Glyph for Mac

Installation overview:

  • (1) Install Glyph's dependencies, part 1
  • (2) Download and unzip the Glyph directory, place it lovingly in your Documents folder
  • (3) Install Glyph's dependencies, the Squeakquel, by double-clicking the start.command file
  • (4) Make GIFs

Keep scrolling for more detail. Delete the Glyph directory in your Documents and start over if you mess anything up. 

For non-nerds, a series of detailed blog posts are linked throughout these instructions with more step-by-step instructions. If you don't know how to use the command line, read this post before going through the rest of these instructions. 

Note that Glyph is made for internet-enabled Macs with 64-bit capable processors running Python 2.7.6. 

(1) Take care of Dependencies

Step 1: Make sure you’re running Python 2.7.6.

Check by typing 'python -V' into terminal and read this post if you're on a different version.

Step 2: Make sure you have pip installed.

Check by typing 'pip' into terminal, or install with this post.

Step 3: Make sure you have virtualenv installed.

'sudo pip install virtualenv'. For more detail, see this post.

Step 4: Step 4: Get ImageMagick installed

Install here. Just in case: blog post.

(2) Download Glyph and Give It a Home

Download this file. Place the zipped file into your Documents folder. Unzip it

You should have a /Glyph directory in your documents now. To the right is what the document tree should look like. (You may not see those grayed out files with the dots.)

(3) Set up Glyph's virtual environment and run Glyph

Go to the Glyph/ directory in your Documents. Double click on start.command. It will ask you to type your computer's password into the command line. Here, you might get an issue here from your Mac about opening applications from unknown developers. If so, go into your Mac preferences panel and click 'Security and Privacy'. There, set the bottom to Allow Apps Downloaded from Anywhere.

If running start.command gives you an exit that tells you pip dependencies weren't installed, scroll down to section 5.

The first time you run Glyph, it will set up a few more things in the background. It will take a while as it silently churns in the background. Let it do this. When the .app pictured to the right pops up, you're good to go. 

(4) Running Glyph

Glyph should be set up now. Leave the Glyph terminal window open while you use Glyph. It will show you progress as your GIFs and loops are cooking. To close Glyph, just close the application itself. To start it again, double-click the start.command file again.

As Glyph works with a new video, it will create a file for that video and all of the videos and GIFs it creates. Since this can get quite bulky, you'll want to flush the directory in the /videos alias in the main Glyph directory from time to time. 

This is the lifecycle of your Glyph terminal window. "Running on (Press CTRL+C to quit)" means the Glyph server was started. "[Process completed]" means you closed the Glyph .app and you can now close the terminal window.

The Glyph terminal window gives you progress updates as Glyph gets going. You can check it while you're making Glyphs and submitting videos to see how long the process is taking.

(5) Trouble Shooting: "Hm, it looks like there was a problem installing pip dependencies." 

If you get this message after running start.command, you'll have to hand-craft your virtual env for the first time. After doing this, running start.command should work as normal. 

Open up terminal and type in these commands one at a time in order:

  • cd Documents
  • cd Glyph
  • ln -s app/static/video videos
  • cd app
  • virtualenv env
  • source env/bin/activate
  • sudo pip install flask moviepy beautifulsoup4 youtube-dl Pillow requests
Using Format