Quicksilver iTunes plug-in - please report any bugs at https://github.com/quicksilver/Quicksilver/issues
Shell C C++ Objective-C Other
Switch branches/tags
Nothing to show
Pull request Compare This branch is 184 commits behind quicksilver:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
iPod Parsing
iTunes Controller Scripts
iTunes Set Volume.scpt


iTunes Plug-in Notes

Scripting Bridge

The Scripting Bridge code requires iTunes.h, which will be generated automatically the first time you build. When it's created, it'll be in DerivedSources (not part of your project). The easiest way to open it for reference is to highlight the filename on the import line and hit ⌃⌘J for "Jump to Definition".

You should familiarize yourself with Scripting Bridge a bit before making any changes. Particularly the sections that discuss performance.

In the end though, you just need to test everything out and see what works. Certain things that should be faster in theory are actually unusably slow. You're better off if you just enumerate through an array of tracks in some cases.

Specifically, adding kind and videoKind to a predicate seems like the right way to filter, but while it will work, it's very slow for some reason.

NSMutableArray *criteria = [NSMutableArray arrayWithObjects:@"kind", QSiTunesBookletKind, @"videoKind", iTunesEVdKNone, nil];
NSString *formatString = @"%K != %@ AND %K == %i";
NSPredicate *trackFilter = [NSPredicate predicateWithFormat:formatString argumentArray:criteria];
trackResult = [[libraryPlaylist fileTracks] filteredArrayUsingPredicate:trackFilter];

Also, adding albumArtist to the predicate is unusably slow. iTunes hits 100% CPU for several minutes. This is very fast on the other hand:

[[libraryPlaylist fileTracks] valueForKey:@"albumArtist"]
# console: Quicksilver: time to get album artists for 7721 tracks: 0.051879

The iTunes Library and Quicksilver's Catalog

Most plug-ins put things directly into Quicksilver's catalog. iTunes typically holds a large number of items and it's unlikely that someone will want them all in the catalog. (Do you need every individual song at your fingertips?)

You may have noticed that browsing through artists, albums, playlists, etc. is very fast in Quicksilver even though most of these things aren't in the catalog. The reason is that the plug-in reads in the entire iTunes library from ~/Music/iTunes/iTunes Music Library.xml into memory using dictionaryWithContentsOfFile:. The QSObjects you see when browsing around are generated on-the-fly from what's in the dictionary.

About Quicksilver Plugins on Github

This repository contains the current source code of a the Quicksilver Plugin / Module. If you're having issues with this plugin, feel free to log them at the Quicksilver issue tracker.

Always be sure to check the Google Groups first incase there's a solution to your problem, as well as the QSApp.com Wiki.

Before You Try It Out

Before trying out any of these plugins, it's always a good idea to BACKUP all of your Quicksilver data.

This is easily done by backing up the following folders

(<user> stands for your short user name):

/Users/<user>/Library/Application Support/Quicksilver

Before Building

Before being able to build any of these plugins, you MUST set a new Source Tree for the QSFramework in the XCode Preferences.

This is done by going into the XCode preferences, clicking 'Source Trees' and adding a new one with the following options:

Setting Name: QSFrameworks
Display Name: a suitable name, e.g. Quicksilver Frameworks
Path: /Applications/Quicksilver.app/Contents/Frameworks (or path of Quicksilver.app if different)

For some plugins to compile correctly a source tree must also be set for QS_SOURCE_ROOT that points to the location of the Quicksilver source code you've downloaded onto your local machine.

Setting Name: QS_SOURCE_ROOT Display Name: a suitable name, e.g. Quicksilver source code root Path: /Users/<user>/<path to Quicksilver source code>

See the QSApp.com wiki for more information on Building Quicksilver.

Also check out the Quicksilver Plugins Development Reference, especially the Building and Testing section.

Legal Stuff

By downloading and/or using this software you agree to the following terms of use:

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this software except in compliance with the License.
You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Which basically means: whatever you do, I can't be held accountable if something breaks.