FRScreenSaver 101

From AwkwardTV
Revision as of 19:24, 10 September 2007 by ThnEa7 (talk | contribs)
Jump to: navigation, search

waes of luve www scooby doo com yupy bora drljaca mercedes baile del perreo bavaria de w32gaobot wo www tx tnet it www ostetrica di neonati it botosani bed breakfast a milano marittima www grafitti com www westunion it we are the breath easy dei blue black eyes peace www ail com wwwte web cam nascoste in spogliatoi maschili ballerine di buona domenica boombastic bolognaeros it www mare neve it bagatto quando partivano i9 lenti xsway driver billioner x nelly dilemma you ll never walk alone bertoni alberto akiko yiffy www taca com bernardo corradi foto baila sexy thing barbie raperonzolo www maschio it xgay zion and lennox www samsung mobile com www videonoleggio it brasil xxx com berger decapitazione ziveo beckham fotos bibblioteca reggio emilia www bibbia it brandon lee www tribunaleamministrativo it accidenti che schianto www vodaphone it bersagliri bontempi loredana benson please don www politica teramo it wrd1874 brandy what about us zairi beckham s life www antonello com www surf it www volvocars it bob marlin xandee 1 life yiorgos mazonakis missing you www megadeth www motorola it bongi bongi you lift me up bonnie tyler si demai you are my sonia zidero ballo ballo blok shaft bill withers andrò come un cavallo pazzo aeroporto bo tylko ty biscochos peludos www calavera com www geoggle bass tab pfm bonde do tigrao thu thuca www museoegizio it www mariam dj com www sexso yatana desnuda www scopare it www ratemyimplants com basi muscli brenda exporto bebo cigala www libero t zvezde granda 2004 benny benassi illusion yu gi ho per visual boy advanc www radio activa con bersagliari www petit it berluscone britney spears sometimes www sexy com www googli it zona allarm italiano bongi benassi benni blue to www ficone it walkthrough final fantasy viii www paulsevers be www ersucam it britney spears crazy briana bank www aida it busco una mujer guanabanas www hotbird 13e satellite zee your so vain brigite bui biglietti compleanno da stampare www radio105 net begin to wonder www cristore com yamaha driver www ff ss it agenzia omicidi xxx movie xxx school sexy girls benceno boffi bagni yussuf bulgaro decapitato in iraq xsc 550anvz www donnaderrico com www sportler com barbara barolo borgo valsugana youngerbabes buble lyrics branko olar bheetoven berdan mardini boys jpg benny benasii blindate porte busca em portugues yahho games banco di lodi arriva dorellik basement jaxx will nevill 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: