Willus.com Home   |   Archive   |   About  

Willus.com's K2pdfopt Help Page

Return to K2pdfopt Home Page

MENU
Getting Started:
    1. Windows
  2. Linux
  Ubuntu
  3. Mac OSX

K2PDFOPT FAQ

Customizing K2PDFOPT:
    1. The interactive menu
    2. List of command-line options
    3. Using a shortcut
  4. Using the K2PDFOPT environment variable
  5. Using the command line

Adjusting the output:
    1. Screen Size
    2. Increasing the magnification
    3. Landscape mode
    4. Output File Size
    5. Setting Margins
    6. Color Output
    7. Uneven Line Breaks/ Excess Margins

Processing Options:
    1. Showing Markings
    2. Auto-Straightening
    3. Ignoring Borders/ Headers/Footers
    4. Detecting Columns
    5. Column Order
    6. Right-to-Left Page Scanning
    7. Using Ghostscript
 
  GETTING STARTED: MAC OSX

NOTE: Several OSX 10.5 users have reported that k2pdfopt for the mac does not run on their systems. I don't have an easy work-around for this, so your options if this is happening to you are to upgrade to OSX 10.6 ($30 at Apple Store) or the latest OSX release or to run the Windows version in a virtual Windows box.

As of v1.22, I've been able to compile k2pdfopt for OSX 32-bit (Intel CPU only) and OSX 64-bit (as of v1.28, Intel only). If you don't know which one to download, choose the 32-bit version since it runs on either 32-bit or 64-bit versions of OSX (again, Intel only). The k2pdfopt download is just a terminal shell application, so you have to install it a little differently then you might be used to. Follow these instructions:

1. From the download page, (a) Fill in the capcha and (b) Click on one of the Mac OSX downloads.

    

2. You should see Safari download the file...

    

3. Right-click the download and select Show in Finder

    

4. Move k2pdfopt to your Desktop.

5. Launch the Mac terminal app. It's in the Utilities folder, which itself is inside the Applications folder.

6. Type the three commands shown below in the terminal window:
     a. cd Desktop
     b. chmod 755 k2pdfopt
     c. exit

    

7. Close the terminal window after typing exit.

You should now be able to launch the k2pdfopt program by double-clicking the icon. You cannot drag PDF files to the k2pdfopt icon, so to convert a PDF file, (1) double-click the k2pdfopt icon, and then (2) drag your PDF file to the k2pdfopt window, as shown in the figure below. The drag and drop will cause the file name to be typed into the window. Then just press <Enter> to start the conversion.

   

8. Customized options (optional)
     If there are customized options that you want to select automatically, you can create a custom script:
     a. Launch the terminal app (see Step 5.)
     b. Type these commands:
          i. cd Desktop
          ii. cat > k2pdfopt_custom
          iii. ./k2pdfopt -ui -j 0 -odpi 250 $* (or whatever options you want--but be sure to put the -ui and keep the $* at the end)
          iv. (Press <Enter> and <Ctrl-D>)
          v. chmod 755 k2pdfopt_custom
          vi. exit

In the above Step 8., the customized script icon is now named k2pdfopt_custom, and the -ui option is important so that the script will still ask you for a file name. If you move the customized icon to a new folder, you'll need to either move k2pdfopt with it, or reference k2pdfopt by its full path name in the customized script.

If somebody knows an easy way to package a Mac terminal app so it can be put with an icon and files can be dragged to it, and also it can easily install from the web, send me an e-mail. I'd prefer it not involve using Xcode or any other 3rd-party commercial application.

 

This page last modified
Thursday, 16-Feb-2012 22:00:28 CST