FRScreenSaver 101

From AwkwardTV
Revision as of 07:58, 31 August 2007 by ThnEa7 (talk | contribs)
Jump to: navigation, search

banche che assumono il valzer degli sposati enterprise van halen video hits foto gallery positano hp ipaq hx2110 pocket pc afs vr nikon honda vfr coppie 50 volante con pedaliera usb hotel lisbona portogallo tomtom mio lg 7300 intel 925xe staffa a muro universale jules verne televisione inglese la fattoria farm 4x dvd cavo usb ds console struttura luna i girasoli tuner dvbt hotel 4 stelle perugia file rbn www trigliceridi it kylie ireland canti popolari lucani nec 42 plasma bmw 2002 belinda mp3 cartine dell antica grecia rhum zacapa margherita dolcevita stefano benni motori di ricerca mondiali delonghi pac fx 130 eco registratore per appunti siti auto usate con foto trzeci zhujiang gemelli acciaio maglia sweet years anime nel deserto midi famosi lamore canta britnei spiears psychic force 2 prestito casalinghe lelly kelly slim fit nelly furtado forca videoclip elisa lotus the invader motorola v1050 vodafone gleim johann wilhelm ludwig lilli riassunto malavoglia pioneer pdp 436 skofljica musiche eterne ied geforce 4 mx4000 veline nude a lucignolo kitten cannon scuola di sesso tommaso rapito juegos barbie jean claude van damme fotos de pelicula pakistan ad corpus love h bubble trubble ischia it fregene riviera jp 50 game pad saitek forni pizza a legna football volley www anzwers net subaru impreza cw configurazione samsung love street of fire yeti trucchi cellulari sony freddy mercuri oscar eminem withouth me promises cramberries video esecuzione fabrizio quattrocchi foppapedretti stiramaniche prestazione proctor robert daniele cobianchi el pueblo intillimani aracnid microsoft virtual uralsk bmw touring 320 jvc g nokia 6680 accessori gps motorola v600 silver hp 350 g42 maurice ronet ixus 300 somadeva una lettera per un amore perso brother hl1430 orario autobus belkin access point candid foto tette di pamela anderson speciale halo lan party masterizzatore usb stay tommy lee usb driver c350 home theatre sanyo inni cori juve creative labs itrigue 3600 wwe smackdown maxi cosi buzz sony nwe405 perlina gioiello come e get it mikael kenta annuncio roma amicizia occhiali polo mediastage star trek voyager stagione 7 voli bristol statuto i ragazzi calendari 2004 rex rc 26 ferri server cisco recensioni escort il valzerone nikonfotocamera digitale dexters glass erwin rommel canon d la salsa asus notebook bluetooth www sanjesh com axen it super sexo nikon coolpix 4500 gif animate sex paff daddy tdk printable poesie d amore francesi sapphire x800 256mb agp full retail volante ferrari ps2 diyar scheda controller sata goldsboro u ora d amore gotta learn sega ora gode di buona salute lavoro gigolo fiesta km 0 provini per film a torino arizona shopping firewire memory card hackles cranberries zombie voz za srecu panasonic p342i e l p lettore nad boccale birra il la hotels estonia sesso estremo con dolore dolce gabbana spot soundtracks hotel split yha h meet woman francja figlia di sion dragixa sata 120gb manichino decapitato recente maxtor hdd 160gb usb lolloscan ragalna inno hit lcd teac vrds foto vacanze alle maldive free video sharing una romantica donna inglese riparazioni sedute in vimini epson 2500 mini cooper nuove inspiron 9100 chopin tristesse electro jazz ballerine in perizoma gri piumone winnie pooh coppia ingoio Finally the screen saver problem has been solved too!

All the BackRow screen savers are basically generators for Quartz Composer compositions. These compositions can be very powerful, even driving things like RSS feeds. In fact, that's the example we'll use.

Most of the instructions to create a FRAppliance still apply—the bundles are very similar. I will go by the same steps as the FRAppliance tutorial, but only highlight the DIFFERENCES from those changes. Please review FRAppliance_101 to reference those steps.

Making the Project

First, you'll want a more useful name. Instead of "HelloWorld", let's call it "RSSVisualizerSaver". Create a new Cocoa Bundle project with this name.

Creating the Plugin

Open InfoPlist.strings (for English) and make sure CFBundleName accurately reflects your new screen saver name:

CFBundleName = "RSS Visualizer";

The Main Appliance Class

Our primary class will not be HelloWorldAppliance, rather use "RSSVisualizerSaver". That means you'll add an Objective-C class to your project caled RSSVisualizerSaver. Don't forget to check "Also create RSSVisualizerSaver.h" in Xcode.

Open RSSVisualizerSaver.h and change it so that your RSSVisualizerSaver class inherits from BRQCScreenSaver. Change "NSObject" in the line beginning with "@interface" to read "BRQCScreenSaver".

Make sure you import the BackRow framework.

You'll want to add the className class method to RSSVisualizerSaver.m—screen savers need to bypass their own whitelists too. However, we need to use an unused screen saver item, and the only one appears to be RUIRetailScreenSaver. Folks are working on subverting the whitelists, so stay tuned for that. You will also want to search for a different method in the exception backtrace: _validateBundleAtPath:. Here's the full code to place into RSSVisualizerSaver.m, instead of the one defined by the Appliance instructions.

// Override to allow FrontRow to load custom screen saver bundles
  (NSString *) className {
    // this function creates an NSString from the contents of the
    // struct objc_class, which means using this will not call this
    // function recursively, and it'll also return the *real* class
    // name.
    NSString * className = NSStringFromClass( self );
	// new method based on the BackRow NSException subclass, which conveniently provides us a backtrace
	// method!
	NSRange result = [[BRBacktracingException backtrace] rangeOfString:@"_validateBundleAtPath:"];
	if(result.location != NSNotFound) {
		NSLog(@" [%@ className] called for screen saver whitelist check, so I'm lying, m'kay?", className);
		className = @"RUIRetailScreenSaver";
	return className;

We need to copy our Quartz composition into our project, otherwise we'll be making an extremely boring screen saver. First, you'll want to copy a composition into your project. Copy this file from your Mac OS X system:

/System/Library/Screen\ Savers/RSS Visualizer.qtz

into your project folder. Then in Xcode, right-click on the "Resources" directory, select Add > Existing Files..., and select RSS Visualizer.qtz from your project folder. Make sure it is added to your target.

Back to the code. There is no equivalent to the applianceControllerWithScene method in a BRQCScreenSaver. The only thing need to do to run a QuartzComposer composition is override its initWithScene method and set the appropriate composition. We'll call the superclass' initWithScene: method to do all the dirty work, the only change we will make is to set a different composition.

- (id)initWithScene:(id)scene {
	NSBundle *thisBundle = [NSBundle bundleForClass:[self class]];
	NSString *compositionPath = [thisBundle pathForResource:@"RSS Visualizer" ofType:@"qtz"];

	self = [super initWithScene:scene];
	[self setCompositionPath:compositionPath];
	return self;

Building the Plugin

Build Settings

Everything is the same, except:

  • make sure your Principal Class is set to RSSVisualizerSaver, not HelloWorldAppliance.
  • set the Wrapper Extension to frss, not frappliance.


Click Build. The compiled screen saver will appear in build/Debug/RSSVisualizerSaver.frss.

Running the Plugin

You'll want to copy your built copy to the correct folder. I recommend, as the Appliance tutorial author did, to mount the project from your development system so you can make a symlink to the correct location. Copy or symlink your built project to:

/System/Library/CoreServices/ Savers

Kill Finder, then navigate to Settings > Screen Savers. Select "RSS Visualizer", then click Preview to witness your great creation!


Start experimenting with some cool compositions for AppleTV—I think this will be a hugely popular hack, given I know the Apple TV community can come up with some really creative screen savers to show on their sexy widescreens. :)

I (just call me John Doe, I want no recognition for this) owe this entire hack to EricIII, the creator of the FRAppliance 101 tutorial. Quite simply, it would have been impossible without his work, especially since the Screen Saver project is largely a clone of the Appliance project.

Some pretty compositions can be found here: