Interaction with Skim
From skim-app
Contents |
AppleScript
Skim has extensive support for AppleScript. You can access the windows, documents, pages, notes and highlights from AppleScript. You can add, delete, and modify notes. Or you can (re)load files and change view settings. Check the dedicated AppleScript page for much more information.
BibDesk
The popular citation manager BibDesk allows you to view and search notes that were added using Skim.
To view the Skim notes added to a linked PDF file, look for a menu item that is named something like "Show Skim Notes for Linked File". They can be found in the Publications menu, the contextual menu for the main table over a linked file, and in the menu for the View File button in the detail window.
To search for Skim notes of linked files, type the text to search in the search field in the toolbar, and choose Skim Notes from the search buttons.
Remote Control
Skim has full support for the Apple Remote Control, mainly to control your presentation. You can toggle presentation mode using the play button, navigate the pages using the right/left buttons, and zoom in/out using the plus/minus buttons. After you choose the menu button, you can use use the right/left/plus/minus buttons to scroll instead. Hit the menu button again to go back to page navigation and zooming.
It seems that Snow Leopard has a bug that prevents third party applications like Skim to use the Apple Remote Control. You may use the third part preference pane Candelair to use the old driver for the Apple Remote Control that is compatible with Skim.
If you prefer to use the third party Sofa Control application, you may use this Skim sofa script. If Skim's built-in remote control support interferes with this, you can disable that as described in Tips and Tricks.
TeX-PDF Synchronization
Skim's TeX-PDF Synchronization support lets you easily switch between a line in a LaTeX source and a point in the PDF shown in Skim. See the dedicated TeX and PDF Synchronization page for more information.
SkimNotes Command Line Tool
Skim has a little command line tool that you could use to write Skim notes from a PDF file to a .skim file, or the other way around, attach the notes from a .skim file to a PDF file. You can run it from Terminal.app. Or it could be used in other applications to access the Skim notes. The tool can be found in the Skim application bundle at Skim.app/Contents/SharedSupport/skimnotes. The data in a .skim file is an (keyed) archived NSArray of NSDictionaries. The values in the dictionaries are all standard Foundation or AppKit objects. See Skim Notes Keys for supported keys.
The tool and source code can be downloaded from the Skim project page
You can have a look at the Skim Notes sample project to see how you can use the skimnotes tool to access Skim notes from a Cocoa application.
The SkimNotes Tool page has some usage notes. You can also get usage information by typing skimnotes help on the command line.
Version 2.0 and higher of skimnotes (included in Skim version 1.1.2 and higher) also include a more advanced agent function. This is a DO server to which you can connect to read Skim notes. It is more efficient if you want to read the Skim notes from several files at once. The source for the tool can be found in the Skim Subversion tree. SKSkimReader is a sample Cocoa class that can be used to communicate with the agent. It is based on BibDesk's BDSKSkimReader class.
SkimPDF Command Line Tool
In addition, Skim has a command line tool to manipulate PDF files with attached Skim notes, such as converting embedded PDF annotations to Skim notes and vice versa, and to merge and join PDF files with attached Skim notes. You can run it from Terminal.app. The tool can be found in the Skim application bundle at Skim.app/Contents/SharedSupport/skimpdf.
The tool and source code can also be downloaded from the Skim project page
The SkimPDF Tool page has some usage notes. You can also get usage information by typing skimpdf help on the command line.
SkimNotes Framework
If you want to be able to easily read Skim notes from a Cocoa application, you can also include the SkimNotes framework. This framework provides some general API that make it easy to read and write Skim notes. It allows you to simply load a PDFDocument with any attached Skim notes included. It supports Skim notes stored in Extended Attributes, in PDF bundles, and in .skim files. The framework is also used by Skim, and is included in the Skim bundle starting from Skim version 1.1.5. The framework and source for the framework can be downloaded from the Skim project page.
Shell Scripts
Check the dedicated Shell Scripts page for user-contributed scripts.
