Interaction with Skim

From SkimWiki

Jump to: navigation, search

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.

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 the 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.

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 support 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.

Personal tools