User Manual

From iDroid Project

Jump to: navigation, search

Congratulations on successfully installing iDroid on your iDevice. Here are some quick tips on how to operate iDroid.

Contents

Introduction

iDroid is still in Alpha Software Stage. It is not yet meant to replace iOS, but that will be the long term goal. Here are some issues that you should take note of:

  1. Camera does not work, so don't think about trying the Camera App. Opening the Camera App may hang iDroid requiring a Hard Reset. Hard Resets can mess up iOS too!!!
  2. Graphics Acceleration Drivers do not work (no 3D, video or YouTube playback).
  3. Power Management is still in development, so the iDroid will run hot and be drained of a full battery in around 2 hours.
  4. Due to lack of graphics driver and power management/clock gating, iDroid will be a bit slower than native or real Android Devices.
  5. WiFi Drivers work but can be buggy at times (You have to turn on/off WiFi until you connect).
  6. iDroid Project does not have permission from Google to include Google Apps and Android Market. Although you can install it if you have your own native Android Device, Google's servers will block you from logging-in properly with your Google Account, so Android Market will not work.
  7. Internet access over the cellular network is not implemented at present, we are working on this.

Getting started with iDroid

Buttons

Due to lack of buttons on the iPhones and iPod Touch, buttons were remapped for Android purposes.

  • The Power button serves as the Back button. This returns to the previous screen. This button can also be used to reject incoming calls.
  • The Home button serves as the Menu button. Pressing this button will bring up options and menus that are sometimes not visible on the display. Holding this button will bring out the Android keyboard.

There are also Soft Buttons included in iDroid Pepparkaka 11.02. These buttons are Back and Menu. They are located on the upper-left corner of the screen. Holding the Menu Soft Button will also bring out the Android keyboard anywhere that needs text input, except for Terminal Emulator.

NOTE: Holding the Menu Soft Button to bring out the Android keyboard when iDroid has just booted up will cause the keyboard to push the entire display window up (instead of normally overlapping the display). This is a known bug and it only happens if this is done when iDroid has booted up and no other Apps/App Drawer are launched. Please exit the keyboard by pressing the Back hardware button or by holding the Menu hardware button.

For iPhones only: From iDroid versions 0.1a to MoJo 1.0.4.1, the volume buttons have these functions:

  • The Volume up button serves as the Call button. Pressing this button opens the Phone app or answers incoming calls.
  • The Volume down button serves as the Android Home button. By default (unless modified in ADW Settings), pressing this button brings out the main Homescreen. Holding this button will bring out the Recent apps list.

Starting with iDroid MoJo 1.0.5, the volume buttons have the same function as the iPhone's volume buttons: the Volume up button increases the volume, while the Volume down button decreases the volume.

Launching Apps

Open the App Drawer (touch the icon with 16 squares right above the Home button). Scroll around the list of Apps and touch the App you want to open, it's that simple. For creating shortcuts on your Homescreen, read on.

Apps Shortcuts

  • To create a shortcut, open the App Drawer. Long press an App to drag and move it anywhere in the Homescreen. You will note that this will be successful when the App Drawer closes on its own and you can seen your Homescreen.
  • To move/arrange shortcuts, long press a shortcut on the Homescreen to drag and move it to wherever you want.
  • To delete/remove a shortcut, long press a shortcut on the Homescreen to drag and move it to the trash icon above the Home button.

Opening the Settings App

There are 3 ways to open the Settings App.

  • Open the App Drawer and touch the Settings App. You may have to scroll around.
  • Press the Home/Menu button. A choice for Settings will appear above the Home button. Touch it to launch the Settings App.
  • Create a shortcut (refer to above) to Settings App and open it on your Homescreen.

Speed Tweaks

Due to the current kernel limitations with GPU, the following are some tweaks that may help speed up iDroid.

  1. Disable Animations: This will disable animated window transitions when opening and closing applications.
    • Open the Settings App, touch Display, then touch Animation (Path: Settings > Display > Animation). A list of choices will appear. No animations will give the fastest performance.
  2. Disable Popup on Keypress: Having Popup on keypress enabled will let you know what you touch on the Android keyboard.
    • Open the Settings App, touch Language & keyboard settings, touch Android keyboard, then uncheck Popup on keypress (Path: Settings > Language & keyboard settings > Android keyboard > Popup on keypress). A check mark beside this option will enable the letters to popup when touching them on the Android keyboard. If disabled, letters will not popup when touched on the Android keyboard but will greatly improve speed.

Adding Widgets

There are 2 ways to add widgets to your Homescreen:

  • Press the Home/Menu button. A choice for Add will appear as the top-left choice. Touch it then touch Widgets when the menu pops up.
  • Long press anywhere on the Homescreen. A menu will pop up, touch Widgets.
  • To move/arrange widgets, long press a widget on the Homescreen to drag and move it to wherever you want.
  • To delete/remove a widget, long press a widget on the Homescreen to drag and move it to the trash icon above the Home button.

Changing the Wallpaper

There are 3 ways to change the Homescreen wallpaper:

  • Press the Home/Menu button. A choice for Add will appear as the top-left choice. Touch it then touch Wallpapers when the menu pops up. Then you have the option of choosing between Gallery and Wallpaper gallery, touch Wallpaper gallery. Make your selection then touch Set wallpaper.
  • Press the Home/Menu button. A choice for Wallpaper will appear on the top-center, above the Settings choice. Touch it then you have the option of choosing between Gallery and Wallpaper gallery, touch Wallpaper gallery. Make your selection then touch Set wallpaper.
  • Long press anywhere on the Homescreen. A menu will pop up, touch Wallpapers. Then you have the option of choosing between Gallery and Wallpaper gallery, touch Wallpaper gallery. Make your selection then touch Set wallpaper.

Turn off LCD / Standby Mode

  • FORCED STANDBY: Press the Home/Menu and Power/Back buttons simultaneously. This will turn off the screen.
  • TIMED STANDBY: Open the Settings App, touch Display, then touch Screen timeout (Path: Settings > Display > Screen timeout). A list of choices will appear. Make a selection that you think suits your usage.
NOTE: Due to the lack of Power Management Drivers, iDroid is not on true Standby and will not conserve power. The iDroid Dev Team is working on this, but it is difficult so give them time.

Turn on LCD and Unlocking Lockscreen

  1. To bring power to the LCD, press either the Home or the Power button once. Once LCD is powered on, you will be at the Lockscreen just like in iOS.
  2. For those using the default Lockscreen settings (Screen unlock security is set to None), unlock your iDroid by sliding the Green Lock Icon from left to right. You can also unlock by pressing the Home/Menu button.
  3. Unlocking options can be modified to include passwords and unlock patterns. You can try these out by opening the Settings App, touch Location & security, then touch Set up screen lock (Path: Settings > Location & Security > Set up screen lock). Feel free to play around and test with the Screen unlock security settings to fit your personal usage style.
NOTE: There are random times when the LCD will not power on or wake up. A process in android has prevented it from doing so, i.e. android has hanged or crashed. You have to perform a Hard Reset (Hold the Home and Power buttons for 10 seconds), then turn it on again for the OpeniBoot menu.

Turn off iDroid

  1. Hold the Home/Menu and Power/Back buttons simultaneously for at least 2 seconds but not more than 8 seconds (or else your device will hard reset). If you have Haptic Feedback enabled, you should feel a short vibration.
  2. The Phone options menu will appear. Touch the bottommost choice (Power off).
  3. A message box will then appear to confirm shutdown. Touch OK to turn off iDroid (Cancel if you changed your mind). Wait for everything to shutdown and the LCD display will clear and turn itself off.

Wireless Connectivity and Settings

Connecting to Wi-Fi

Open the Settings App, touch Wireless & networks, then touch Wi-Fi (Path: Settings > Wireless & networks > Wi-Fi) to turn Wi-Fi on/off. A green checkmark beside this means that Wi-Fi is turned on.

Adding a Wi-Fi Network

  1. Open the Settings App, touch Wireless & networks, then touch Wi-Fi settings (Path: Settings > Wireless & networks > Wi-Fi settings).
  2. Make sure Wi-Fi is turned on (should have a green checkmark to its right).
  3. Wi-Fi should have scanned and listed new networks.
  4. Touch the network you want to join and enter the network password if needed.
  5. For networks not listed, touch Add Wi-Fi network and supply the needed details such as the SSID and the network password.

Airplane Mode

There are 2 ways to enable/disable Airplane Mode.

  • Hold the Home/Menu and Power/Back buttons simultaneously for at least 2 seconds but not more than 8 seconds (or else your device will hard reset). If you have Haptic Feedback enabled, you should feel a short vibration. The Phone options menu will appear. Touch the middle choice (Airplane mode).
  • Open the Settings App, touch Wireless & networks, then touch Airplane mode (Path: Settings > Wireless & networks > Airplane mode). A green check beside Airplane mode means that it is active and all wireless connections are turned off.

Bluetooth

Bluetooth does not work at the moment due to missing drivers. The iDroid Dev Team is working to enable this but this is not a top priority.

Data Connections: EDGE and 3G

Under construction/being worked on by iDroid Dev Team.

Multimedia: Sounds, Music, Videos and Pictures

Changing the Volume

  1. Open the Settings App, touch Sound, then touch Volume (Path: Settings > Sound > Volume).
  2. A popup window will appear allowing you to customize the volume for Ringtone (incoming call volume), Notifications (untick the Use Incoming call volume for notifications to manually set this), Media, and Alarm.
  3. Slide the yellow bars to the right or left to change the volume.

Silent Mode

There are 4 ways to enable/disable Silent Mode. Vibrations can be enabled or disabled in Silent Mode.

  • Hold the Home/Menu and Power/Back buttons simultaneously for at least 2 seconds but not more than 8 seconds (or else your device will hard reset). If you have Haptic Feedback enabled, you should feel a short vibration. The Phone options menu will appear. Touch the top choice (Silent mode).
  • For iPhones, keep pressing the Volume down' until it goes into Silent mode.
  • Open the Settings App, touch Sound, then touch Silent mode (Path: Settings > Sound > Silent mode). A green check beside Silent mode means that it is active and all sounds are mute.
  • At the Lockscreen, as long as you are not using the Pattern Screen unlock security, enable Silent mode and mute all sounds by sliding the Gray Speaker Icon from right to left. Likewise, enable all sounds and exit Silent mode by sliding the Yellow Vibrating Phone Icon from right to left.

Playing Audio Files

  • Copy whatever audio files to your sdcard folder. Then run Media Scanner by opening Dev Tools app, scroll down then touch Media Scanner. Wait for the scan to complete/finish and you're all set to go.

Other Sound settings

Open the Settings App, then touch Sound (Path: Settings > Sound). There are other settings you can configure like Vibration, Haptic Feedback, and setting Ringtones.

Having a Shared Media Library with iOS

Please refer to the Shared Library guide for more detailed instructions and warnings.

Camera and Video

  • Camera does not work. There are no Drivers for it. iDroid will crash/hang if you open the camera app and may require a Hard Reset.
  • Video playback requires the Graphics Driver to be working. Applications trying to play videos will crash and force close.
NOTE: The iDroid Dev Team is working to fix these problems. Please do not attempt to play videos or try to do anything with the Camera, android will just crash.

Syncing Google Contacts, Calendar and Mail

Due to certain restrictions (Read more about it here), there is a different way to sync Google Contacts, Calendar and Mail with iDroid. Special thanks to Krazy-Killa for bringing this up (Original forum post here).

  1. Open the Settings app, touch Accounts & sync, then tap the Add account button (Path: Settings > Accounts & sync > Add account).
  2. Add a Corporate account.
  3. In the Email address field, enter your full Google email address (username@gmail.com).
  4. Add your Google account password in the Password field, then tap the Next button on the lower right.
  5. Leave the \<username> in the Domain\Username field as is.
  6. In the Server field input m.google.com
  7. Android will be Checking Incoming Server Settings, and present several options of what to sync, and how frequently to sync. Touch the Next button when you're done.
  8. Give a name of your new Exchange account, and press Done.

Congratulations, you now are synced with Google Contacts, Mail, and Calendar

Adding a Yahoo! Mail e-mail account

Credit goes to dapk1nmasta from this thread: http://www.idroidproject.org/forum/idroid/(yahoo!-mail)-setting-up-a-yahoo!-mail-account/

  1. Open the Mail app, and add a new account.
  2. In the Email address field, enter your full Yahoo! email address (name@yahoo/ymail/rocketmail.com)
  3. Add your account password in the Password field, then tap Manual setup on the lower left.
  4. Tap IMAP
  5. Add @yahoo/ymail/rocketmail.com at the end of the username, and keep the password the same. If you entered it correctly on the first screen, then there is no need to change it.
  6. Set the IMAP server to imap.mail.yahoo.com
  7. Set the port to 993
  8. Set the security to SSL
  9. Tap Next
  10. Set the outgoing mail server to smtp.mail.yahoo.com
  11. Set the port to 465
  12. Set the security to SSL
  13. Tap Next and proceed to finish adding the account. You may need to wait for the process to sync with the Yahoo server.

Working with APK files (Apps)

Installing Apps

iDroid builds starting with MoJo 1.0.4.1 have OI File Manager included. This makes it easier to install apps. If you are using an older version, please refer to the ADB guide on how to install apps.

  1. In iOS, transfer an APK file (.apk) from your PC to your sdcard folder. How you get an apk file is up to you--you can download it from somewhere, transfer it from your native android device, or compile one from source code.
  2. Boot into Android. Once booted, open the App Drawer and touch File Manager.
  3. The sdcard folder is usually the default folder. Look for your APK file and touch it.
  4. Follow the onscreen instructions to install the App.
  5. Wait for installation to complete and enjoy.

Increasing Internal Storage Space

This is for advanced users who have access to Linux

Internal storage space has a total of 100MB. You can increase this space to whatever you want using Linux.

  1. Copy your userdata.img from /private/var/idroid to your PC running Linux. Create a backup to be sure.
  2. Open Terminal. Make sure you are in the same directory as userdata.img for convenience.
  3. In Terminal run the following commands:
    e2fsck -f userdata.img
    resize2fs userdata.img xxx
    Where xxx should be numeric and will be the number of 4Kb blocks. Example, xxx is set as 100000, so userdata.img will become ~400MB.
  4. Transfer userdata.img back into /private/var/idroid.

FAQ/Troubleshooting

Please refer to the FAQ section for further information.

Hard Reset

WARNING: Perform a Hard Reset only when necessary. A Hard Reset can cause data corruption in both iOS and Android. Sometimes an unclean system can prevent iOS from booting, to fix this it is required to perform a DFU restore.

When Android hangs and becomes unresponsive, there is no other choice but to perform a Hard Reset. The consequence of a Hard Reset are in the Warning above.

  1. Press and hold the Power and Home buttons for 6 or more seconds.
  2. The LCD should turn black.
  3. Power on your device and boot into iOS to make sure it works. If iOS is not booting and reboots to the OpeniBoot menu, perform a DFU restore.