Skip to content
Utility class to monitor directorys via kqueue (Useful for iTunes file sharing on iOS). Example Project is for iOS 5, code works on all platforms with blocks support, iOS as well as OSX
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



DirectoryWatchdog is a simple utility tool to mointor changes in local folders. Most common use is the monitoring of an applications documents direcory in combination with iTunes file sharing support. This code uses the BSD kqueue API and should work on OSX as well as iOS.

In the code I use blocks for the callback, so it requires iOS 4 or higher (or OSX 10.6 or newer). You should be able to rewrite it to a delegate pattern, if you want to target older versions

How to use in your own project

Just copy the SGDirWatchdog.h and SGDirWatchdog.m files into your project folder and add them to the Xcode project. Then use the class as I do in SGViewController.m

Example for those who do not have time to look at SGViewController.m

#import "SGDirWatchdog.h"
// TableviewController code ...
- (void)viewDidLoad
    [super viewDidLoad];
    observer = [[SGDirWatchdog alloc]initWithPath:[SGViewController documentsPath]  update:^{
        self.files = [[NSFileManager defaultManager]contentsOfDirectoryAtPath:documentsPath error:NULL];
        [self.tableView reloadData];
    [observer start];

- (void)viewDidUnload
    [super viewDidUnload];
    [observer stop];
// ...


Code is based on Michael Heyeck's blogpost:


Copyright (c) 2011 Simon Grätzer

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file 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, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

You can’t perform that action at this time.