I’m looking at doing some V-Carving and from other posts on this forum I found out about F-Engrave and wanted to give it a try; however I couldn’t find any instructions for installing it on Mac OSX so I wanted to write up how I got it to work. Hopefully someone finds it useful.
I did this on a MacBook Pro on El Capitan (10.11.1). I already had XCode and XQuartz installed but if you don’t you’ll need to grab it from the App Store to get the compiler and related developer header files. You’ll need a basic understanding of the OSX Terminal and how to execute commands. There are plenty of tutorials out there if you get stuck on a command.
- Install XCode from the Mac App Store to get the developer tools including the compilers.
- Download and instal XQuartz to get X11 support and associated header files and libraries. You may already have it installed if you have been using InkScape: https://xquartz.macosforge.org
- Launch a Terminal.
- Make a directory to hold the final F-Engrave files:
- Make a temporary directory to work in if you don't already have one:
- Change to the temporary directory:
- Download the F-Engrave source from here http://www.scorchworks.com/Fengrave/fengrave.html#download
- Extract it to a temporary directory using unzip:
- Change to the extracted directory:
- Copy the F-Engrae Python
file to the final application directory:cp f-engrave-152.py ~/Applications/f-engrave`
- Change to the included tt2cxf source directory:
- Launch TextEdit and edit the Makefile in this directory to point to the proper freetype headers. Change the line
g++ -o ttf2cxf_stream ttf2cxf_stream.cpp -lm -I/usr/include/freetype2 –lfreetype to
g++ -o ttf2cxf_stream ttf2cxf_stream.cpp -lm -L/usr/X11/lib -I/usr/X11/include/freetype2 -lfreetype. You can also use vi in the Terminal if you're comfortable with it:
- Run make to compile:
- Copy the new binary to the final application directory:
cp ttf2cxf_stream ~/Applications/f-engrave
- Change back to the temporary directory:
- Download the potrace binaries for OSX from here http://potrace.sourceforge.net/#downloading
- Extract it to a temporary directory using tar:
tar –xzf ~/Downloads/potrace-1.13.mac-x86_64.tar.gz
- Copy the extracted binary to the final application directory:
cp potrace-1.13.mac-x86_64/potrace ~/Applications/f-engrave
- Change to your final application directory:
- Update your PATH environment variable to include this directory so F-Engrave can find potrace and tt2cxf. You’ll need to do this every time you launch the Terminal or add the line to your ~/.bashrc:
- Run F-Engrave using Python:
If all goes well you should now have a working copy of F-Engrave. If you don't see any messages like “ttf2cxf_stream executable is not present/working...Bummer” then you’re good to go. If you do see a "Bummer" error, first check that the individual commands work by running
./potrace -v. If those two commands work, then it is probably just a problem with your PATH and F-Engrave can't find the binaries. If those commands don't work then it might be an executable permission issue or one of the steps above failed.
Once the application is running, you need to point it to some fonts. Apple has a good list of font locations here https://support.apple.com/en-us/HT201722. I found that most of my fonts are in
~/Library/Fonts. You’ll need to select one of these directories by going to
Settings->General Settings->Font Directory in F-Engrave.
Edit 11/24: Added steps to install XCode and XQuartz.