You can import PDF in one of three modes: Editable content, Accurate & selectable, and Plain text. Due to the complexity of Mac compilation, in order to import your PDF, there are a few manual steps that you must do first, in order to install relevant packages. The packages can be installed using Homebrew. Homebrew is a package manager designed for conveniently installing tools on Mac OS X. Note that installing packages on Mac may take a good number of minutes to complete, so be patient!



Installing Homebrew


First find out whether Homebrew is already installed on your system.

  • Open the Terminal window: Press Command+Space and type Terminal and press enter/return key.
  • Run the following in the Terminal window:
    which brew 
     If brew is installed, it will show you the path of installation. Otherwise, it will tell you "command not found". If brew isn't installed, you will need to install it.
  • In case brew isn't installed, run the following in the Terminal window to install it: 
    ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null
     and press enter/return key. It may ask you for a password. Simply enter your Mac user password. Wait for the command to finish.


Note that for all the different modes below to work, you need to have bash re-installed. The default bash version has been failing with recent Mac OS versions. So just run the following:

brew install bash



Editable content mode


A package named pdf2htmlex is required to be installed. This can be installed using Homebrew. 

  • Simply run the following in the Terminal window:  
    brew install pdf2htmlex
  • If you receive am error about conflicting formulae, trying the reinstall command instead of install:
    brew reinstall pdf2htmlex
     

Accurate & selectable mode


To generate image scans of your PDF, a package named mutools is required to be installed. This can be installed using Homebrew. 

  • Simply run the following in the Terminal window: 
    brew install mupdf-tools
  • If you will enable the text to be selectable, then you also need to make sure you have pdf2htmlex installed (see the previous section).



Plain text mode


A package named xpdf is required to be installed. This can be installed using Homebrew. 

  • Simply run the following in the Terminal window: 
    brew install homebrew/x11/xpdf