Prayer Book for iPhone and iPod Touch

October 2nd, 2008 Arash

My first iPhone app has just been posted to the iTunes app store. It’s called Prayer Book and it contains 231 English prayers from the Writings of the Bahá’í Faith. They’re organized by categories and you can bookmark your favorite prayers for easy access as well. I’ll be updating the program over time with new features and prayer translations, and eventually I’d like to have all the Writings of the Bahá’í Faith in there.

It’s available for free on the iTunes store, so go ahead and take it for a spin.

Posted in iPhone | 8 Comments » |    Add to Mixx!

Installing iPhone firmware 2.1

September 14th, 2008 Arash

Here’s a step by step on how to install the new 2.1 firmware using PwnageTool. I’m assuming that you’ve alread Pwned your phone before when you follow this tutorial. If you haven’t, the steps at the end may be a little different for you.

  1. Update to iTunes 8 and restart
  2. After the reboot, plug in your phone, then open up iTunes. It will ask if you want to update your phone. Click ‘Download only’. If you accidentally clicked cancel, just click on your phone in the iTunes sidebar, then click ‘Update’ to get the latest firmware. Then once the download starts, unplug your iPhone from the USB port.
  3. Once the download finishes, close iTunes
  4. Open up the ‘Activity Monitor’ app from /Applications/Utilities. Find the ‘iTunes Helper’ in the list of running programs and kill it (the red button at the top left).
  5. Set your phone’s auto-lock to never (Settings->General->Auto Lock->Never)
  6. After downloading PwnageTool and copying it to your /Applications folder, launch the program.
  7. Select your device (I’m using the original iPhone) and click the next arrow.
  8. PwnageTool will search for the ipsw firmware file you just downloaded (and it should find it). Select it and click the next arrow.
  9. Now PwnageTool will look for the bootloader v4.6 and 3.9 files. If you don’t have them, you can download them here. After downloading the files, click ‘No’ to searching the web for the bootloader file. At the next dialog, click ‘Yes’ to browse for the location where you downloaded the file.
  10. Now PwnageTool will ask you if you have an iPhone contract that would normally activate through iTunes. If you are using the Apple approved carrier in your country, you can click ‘Yes’, and this will skip the unlocking process on your phone. Just say ‘No’ if you want your phone unlocked.
  11. Now PwnageTool will build an ipsw file for your phone.
  12. After the file is created, close PwnageTool, disconnect and turn off your phone, and open up iTunes.
  13. Now we need to put the phone into recovery mode. While the phone is off, hold down the ‘Home’ button, and at the same time plug your phone into your Mac. Keep holding down the ‘Home’ button until iTunes tells you that your phone is in recovery mode and needs to be restored.
  14. In iTunes, hold down the option key and click ‘Restore.’ Select the new firmware file that PwnageTool just created, and you should be good to go in about 10 minutes.
  15. Enjoy your updated phone!

Posted in Tutorials, iPhone | 3 Comments » |    Add to Mixx!

Open links from UIWebView in MobileSafari

September 6th, 2008 Arash

If you’ve embedded a UIWebView in your iPhone/iPod app, you may not want the user to suffer through surfing all successive pages through it. Instead, you can open up your first page inside a UIWebView and any links the user tries to follow will instead open up in MobileSafari.

All you need to do is set the UIWebView’s delegate, to an object that implements the optional method webView:shouldStartLoadWithRequest:navigationType: (part of the UIWebViewDelegate protocol). Then whenever the initial page is loaded or a link is followed in that view, the delegate’s method will be called. You’ll want to return YES for the page you initially load, and then return NO for all others, and open the URL in MobileSafari. Here’s what the method implementation should look like:

- (BOOL)webView:(UIWebView *)webView
    shouldStartLoadWithRequest:(NSURLRequest *)request
    navigationType:(UIWebViewNavigationType)navigationType
{
    if ([[[request URL] absoluteString] isEqual:@"http://arashpayan.com/myInitialPage/"])
        return YES;
    
    [[UIApplication sharedApplication] openURL:[request URL]];
    
    return NO;
}

By returning NO from the delegate method, we’re telling the web view not to load the link the user tapped, but instead we redirect the opening of the link to [UIApplication openURL:] (MobileSafari).

Posted in Tutorials, iPhone | No Comments » |    Add to Mixx!

Change iPhone/iPod app orientation within a UITabBarController

September 4th, 2008 Arash

The documentation for the official iPhone SDK is less than stellar, and as a result I’ve encountered lots of frustrating little problems. In particular, I wasn’t able to get my app to change its orientation when the phone was rotated. UIViewController has a method shouldAutorotateToInterfaceOrientation: that gets called when the iPhone/iPod orientation is changed by the user, and overriding this method to return YES should cause your view to be rotated. You may have implemented this method and to your frustration, nothing happened when you rotated the device. The trick is that Cocoa only calls shouldAutorotateToInterfaceOrientation: on the top most UIViewController. Meaning if your program lives inside a UITabBarController (possibly with a UINavigationController inside some of the tab bar items), the UIViewController that the user is currently interacting with, is not necessarily the one receiving the method call.

In my app, everything lives inside a UITabBarController, so that’s what was receiving the shouldAutorotateToInterfaceOrientation: call. In order to get orientation changes to work you need to subclass UITabBarController (contrary to Apple doc recommendations) and override the method so you can return YES when it’s called. Below is some code for a simple UITabBarController subclass used inside a program that supports a horizontal view.

RotatingTabBarAppDelegate.h

#import <UIKit/UIKit.h>

#import "RotatingTabBarController.h"

/*
 Nothing special implemented in our delegate for this example.
 */

@class RotatingTabBarAppViewController;

@interface RotatingTabBarAppAppDelegate : NSObject <UIApplicationDelegate> {
    IBOutlet UIWindow *window;
}

@property (nonatomic, retain) UIWindow *window;

@end

RotatingTabBarAppDelegate.m

#import "RotatingTabBarAppAppDelegate.h"

@implementation RotatingTabBarAppAppDelegate

@synthesize window;

/*
 We’ll programmatically lay out a simple GUI for this demonstration.
 */

- (void)applicationDidFinishLaunching:(UIApplication *)application {    
    
    // Just make two empty view controllers for fun
    UIViewController *tab1 = [[UIViewController alloc] init];
    tab1.tabBarItem = [[UITabBarItem alloc] initWithTabBarSystemItem:UITabBarSystemItemTopRated tag:0];

    UIViewController *tab2 = [[UIViewController alloc] init];
    tab2.tabBarItem = [[UITabBarItem alloc] initWithTabBarSystemItem:UITabBarSystemItemSearch tag:1];
    
    // Now create an instance of our rotating tab bar controller
    RotatingTabBarController *tbc = [[RotatingTabBarController alloc] init];
    // Add the two view controllers to the tab bar
    [tbc setViewControllers:[NSArray arrayWithObjects:tab1, tab2, nil]];
    
    // Add the tab bar controller’s view to the window
    [window addSubview:tbc.view];
    
    // Make our program visible
    [window makeKeyAndVisible];
}

- (void)dealloc {
    [window release];
    [super dealloc];
}

@end

RotatingTabBarController.h

#import <UIKit/UIKit.h>

/*
 The subclass doesn’t need any new methods or members.
 */

@interface RotatingTabBarController : UITabBarController {

}

@end

RotatingTabBarController.m

#import "RotatingTabBarController.h"

@implementation RotatingTabBarController

/*
 Just override this single method to return YES when we want it to.
 */

- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation {
    // Always returning YES means the view will rotate to accomodate any orientation.
    return YES;
}

@end

The one thing this doesn’t address, is when you only want certain views in your program to rotate. In that case you just need to make your UITabBarController ask the currently visible view controller in the program if the app should rotate, and return that BOOL.

Posted in Tutorials, iPhone | 3 Comments » |    Add to Mixx!

T-Zones on iPhone 2.0

July 26th, 2008 Arash

If you’re trying to get T-Zones working on the iPhone 2.0 software, you don’t need to follow the old manual way of doing it. Just go into Cydia and search for ‘TZones Hack’ (without the quotes) and install the BigBoss tweak that comes up. Restart your phone, and you’re good to go.

As usual, the YouTube app still won’t work with this hack.

Posted in Tutorials, iPhone | 7 Comments » |    Add to Mixx!

Updating 1st gen iPhone to 2.0 software

July 19th, 2008 Arash

The new PwnageTool is out, and I’m gonna document my steps to install the 2.0 software on my 1st gen iPhone. Note that this is not an upgrade. The process will wipe your phone, so backup any pictures or notes that you may have on there.

  1. First thing’s first. Downoad the latest PwnageTool.
  2. Unzip the file and drop it in your /Applications folder
  3. Make sure you have the latest version of iTunes (Apple->Software Update). Start up iTunes after updating to make sure it starts.
  4. Plug in your iPhone, and iTunes will ask if you want to update your phone. Click ‘Download Only’. After it finishes downloading, close iTunes.
  5. Download the version 3.9 and 4.6 boot loaders. I used this link, but that link might not work after awhile. Extract the file (and extract the .zip file inside of it again) until you see the bl39.bin and bl46.bin files.
  6. After the download is finished, close iTunes.
  7. Open the ‘Activity Monitor’ application. (/Applications/Utilities/Activity Monitor). Find the ‘iTunes Helper’ process and force quit the program.
  8. Plug in your iPhone and turn off the auto lock. (Settings->General->Auto-Lock->Never)
  9. Launch PwnageTool, then click on the iPhone on the left.
  10. Select the 2.0 firmware that it finds (iPhone1,1_2.0_5A347)
  11. Pwnage tool should be able to find your boot loaders (mine were in my Documents directory). If not, make sure you’ve extracted the boot loader file you downloaded. Worst case, just browse for it manually.
  12. Pwnage will ask you if you’re legit. I use T-Mobile in America, so I clicked ‘No.’
  13. Pwnage may ask you for your admin password.
  14. Now it will ask if your phone has been ‘Pwned’ before. I presume this is your first time (seeing as how the application just came out), so click ‘No’.
  15. This part is tricky. Watch the PwnageTool screen carefully as it will prompt you to press combinations of your Home and Power buttons in order to put the phone into DFU mode. It took me several times to do it, but just keep trying by following the on screen instructions. (When Pwnage says you have successfully entered DFU mode, your screen might be off. That’s ok)
  16. Once Pwnage tells you that you’re in DFU mode, open up iTunes. iTunes will say that the phone needs to be restored. Hold down the ‘option’ key and click on the ‘Restore’ button. iTunes will prompt you for the location of a firmware file. Select the one on the Desktop that PwnageTool created (iPhone1,1_2.0_5A347_Custom_Restore.ipsw).
  17. Go make yourself a cup of tea. :-) After the restore, the phone will reboot and Boot Neuter will flash the boot loader and base band. Your phone will reboot again, and you’re done!

If iTunes doesn’t immediately recognize your phone, try restarting iTunes. It seems the iTunes Helper is necessary for syncing the iPhone.

Posted in Tutorials, iPhone | 14 Comments » |    Add to Mixx!

FileTree update (v1.1)

June 4th, 2008 Arash

I recently received an email from Ryan McFall that he is using FileTree, and he noticed that the FileTree doesn’t actually display everything accurately on Windows. The shortcoming was in the fact that Windows explorer displays all directories first before displaying files in a tree. He fixed the problem, and kindly sent the changes back to me for posting on the website.

I hope this makes FileTree useful for many more people.

Posted in Open Source | No Comments » |    Add to Mixx!

t-zones on 1.1.4

March 2nd, 2008 Arash

I finally upgraded my iPhone from 1.1.1 to 1.1.4, and after dealing with the Installer.app “main script execution failed” error (solution here), I began to setup my EDGE access. The steps are mostly the same as before, with the exception of the location of the preferences.plist file. Previously, it was located in the user partition, but now the file is located in:

/Library/Preferences/SystemConfiguration/preferences.plist

In addition to the upgrade, I also took the opportunity to install Telesphoreo/Cydia, which is a port of APT to the iPhone by Jay Freeman. There seems to be lots of interesting ports available to install, and a Java VM, which is of particular interest to me. If I make any progress in developing with the new tools, I’ll post any helpful info I find.

Posted in iPhone | No Comments » |    Add to Mixx!

FileTree version 1.0

September 23rd, 2007 Arash

I was coding at work, and I needed a tree view of the file system so user’s could select a directory in a utlitiy I was writing. There’s nothing in the Java libraries that does that (as of JDK 1.6), so I figured this would be a cool little swing object to develop and make available for others. I finished it about a month ago, but I didn’t have time to thoroughly document it and make a page for it on my website until now.

I call it FileTree and it extends the Java JTree class. It has the native system icons next to all the files and directories for OS X and Windows. On Linux, because neither the File class or the FileSystemView class return specific icons, some generic icons are used for the folder and file nodes.

I hope this library comes in handy for any Java developers out there, and if you find any bugs, make any improvements or have any interesting feature requests, please let me know about them.

Posted in Open Source | 1 Comment » |    Add to Mixx!

t-zones (a.k.a. $5.99 Internet access) on the iPhone

September 17th, 2007 Arash

UPDATE 2 (July 26, 2008): There is a much easier way to set up T-Zones now.

UPDATE: After going through my logs I’ve noticed that there are a lot of Windows users checking out this guide. So I’ve added a step 0 to help them out.

I received my iPhone on Friday and immediately went about actvating and unlocking it, and at the end of the tutorial, there’s a link to a forum discussion on getting t-zones working on your iPhone. After reading through it and placing a call to t-mobile’s customer support (great folks over there!) I finally got it working. Here are the steps needed in an easy to follow format.

I’m going to make a couple of assumptions in this tutorial.

  1. You have T-Mobile and t-zones
  2. You installed OpenSSH on your iPhone (part 3 of the unlocking process
  3. Your iPhone has Wi-Fi access.

0) Windows users install WinSCP If you’re running Windows, install a file transfer client to move the files between your computer and your iPhone. I recommend WinSCP. If the tutorial makes anymore mention about transferring files between computers, just use WinSCP and connect to the IP of your iPhone. Set the protocol to be SSH/SSH2.

1) Turn off Auto-Lock Go to ‘Settings’ -> ‘General’ -> ‘Auto-Lock’ and select ‘Never.’ You can turn it back on after you’re done with this, but for now disable it.

2) Enter APN, username and password Go to ‘Settings’ -> ‘General’ -> ‘Network’ -> ‘Edge.’ For the APN field enter wap.voicestream.com. Make sure the username and password fields are empty.

3) Create proxy.pac Thanks to kdub3000 for the file contents. Open TextEdit or your favorite text editor on Linux, and paste in the following code into a new document:

function FindProxyForURL(url, host)
{
if (isInNet(myIpAddress(), "10.0.0.0", "255.0.0.0"))
return "PROXY 216.155.165.50:8080";
else
return "DIRECT";
}

Save the file to your Desktop as proxy.pac. On OS X, make sure TextEdit doesn’t append a .txt extension to the file.

4) Find the IP address of your iPhone Go to ‘Settings’ -> ‘Wi-Fi’, and click on the blue dot next to the name of the network your iPhone is currently connected to (the one with the checkbox). Look at the IP address there and remember it or write it down.

5) Upload proxy.pac to the iPhone Now we need to copy proxy.pac to our iPhone’s /private/var/root/ directory. If you know how to do this using a Cyberduck or any other file transfer program, feel free to do so. Otherwise open up a terminal (OS X, go to Applications -> Utilities -> Terminal.app) and enter the following command with the ip address of your iPhone substituted for the $IPHONE_IP:

scp ~/Desktop/proxy.pac root@$IPHONE_IP:/private/var/root/

On my Wi-Fi network, my iPhone’s IP is 192.168.1.52, so I typed this command:

scp ~/Desktop/proxy.pac root@192.168.1.52:/private/var/root/

Hit ‘Enter’ and it will prompt you for your iPhone’s root password. The default is ‘dottie’, without the quotes.

6) Update preferences.plist Now we’ll copy preferences.plist to our local system for editing. It’s located at /private/var/root/Library/Preferences/SystemConfiguration/preferences.plist on your iPhone. Download it to your desktop using your favorite file transfer client, or use this command:

scp root@$IPHONE_IP:/private/var/root/Library/Preferences/SystemConfiguration/preferences.plist ~/Desktop/

Open up the preferences.plist file from your Desktop in your text editor, and look for the area of the file where it has the lines:

<key>DeviceName</key>
<string>ip1<string>

Note that the text inside the string tags should be ip1 (as opposed to en0, ip2 or anything else). Now add the following chunk of xml (in red) to the file in the appropriate place (thanks to syasses):

<key>Interface</key>
<dict>
<key>DeviceName</key>
<string>ip1</string>
<key>Hardware</key>
<string>com.apple.CommCenter</string>
<key>Type</key>
<string>com.apple.CommCenter</string>
</dict>

<key>Proxies</key>
<dict>
<key>ProxyAutoConfigEnable</key>
<integer>1</integer>
<key>ProxyAutoConfigURLString</key>
<string>file:///private/var/root/proxy.pac</string>
</dict>

<key>com.apple.CommCenter</key>
<dict>
<key>AllowNetworkAccess</key>
<integer>1</integer>
<key>Available</key>
<integer>1</integer>
<key>Setup</key>
By adding this code to the file, you’re instructing your iPhone to use a proxy (T-Mobile’s t-zones server) for your communications over GPRS. Save the file.
Now upload the file back to your iPhone with the command:

scp ~/Desktop/preferences.plist root@$IPHONE_IP:/private/var/root/Library/Preferences/SystemConfiguration/

7) Restart the iPhone Hold down the sleep button for 3 seconds on your iPhone, and then turn it off. Turn it back on, and you should be able to access the Internet through t-zones for just $6!

I tested my GPRS speed at iphonenetworktest.com and I got 154.2 kbps.

Posted in Tutorials, iPhone | 116 Comments » |    Add to Mixx!