• Home »
  • »
  • Launch iPhone Screen Capture Utility From The Command Line

Launch iPhone Screen Capture Utility From The Command Line

I have an iPod Touch 2G that is fairly messed up and both the power button and home buttons are currently not working properly which makes taking screenshots much harder than normal in iPhone firmware 2.X and 3.X. If you have installed Cydia however on your iPhone or iPod Touch then you can launch the screen capture from the command line without issue. Once you have taken a screen capture you can then email the photos to yourself or SCP (Secure Copy) them to your computer. To launch the iPhone screen capture utility from the command line follow the directions below.

Snap a Screenshot from the iPhone CLI:

  1. SSH to Phone: SSH to your phone as you normally would as the root user. Technically you could also do this with a terminal window but then your screen capture would be only of the terminal window. This is also assuming you have already installed OpenSSH via Cydia or Icy. In the below example is the IP address of the iPod Touch.

    1. C:\>ssh root@
  2. Change to Mobile User: Now use “su” to change the user to the mobile user so the screenshots will appear in the “Saved Photos” folder under the Photos application on your iPhone.

    1. yourTouch:/ mobile$ su - mobile
  3. Take Screenshot Via CLI: Make sure that UIKit Tools is installed via Cydia and then issue the uishoot command as shown below.

    1. yourTouch:/ mobile$ uishoot
    2. 2009-10-08 20:21:25.396 uishoot[186.903] DONE: /var/mobile/Media/DCIM/999APPLE/IMG_0001.PNG

    After you issue the uishoot command you should get a response via the shell letting you know that its complete and the location/name of the saved image.

  4. View Pictures: On the iPhone or iPod Touch click on Photos from the home screen. Your screen captures will be located in the “Saved Photos” folder.

That is all you have to do. Below is an example of using uishoot via the Terminal application on an iPod Touch.

iPhone Screenshot With uishoot:  Touch Screen Capture

As you can see when the uishoot command is issued the screenshot will be of what is specifically showing on your iPhone screen at the time. Using the command line to perform the screen capture also allows you to take screenshots of a locked device as well.

Apple iPod touch 32 GB 3rd Generation (Discontinued by Manufacturer) (Electronics)

List Price: $299.00
New From: $325.99 USD In Stock
Used from: $54.95 USD In Stock

Beginning iPhone 3 Development: Exploring the iPhone SDK (Paperback)

List Price: $39.99 USD
New From: $0.63 USD In Stock
Used from: $0.01 USD In Stock